SDO_GEOR.setDefaultPyramidLevel

形式

SDO_GEOR.setDefaultPyramidLevel(
     georaster            IN OUT SDO_GEORASTER, 
     defaultPyramidLevel  IN NUMBER);

説明

GeoRasterオブジェクトを表示する際に、デフォルトのピラミッド・レベルに使用されるレイヤー番号を設定します。または、defaultPyramidLevelパラメータにNULLが指定された場合、既存の値を削除します。

パラメータ

georaster: GeoRasterオブジェクトを指定します。
defaultPyramidLevel: 指定したGeoRasterオブジェクトを表示するためのデフォルトのピラミッド・レベルを指定します。0 (ゼロ)以上であり、GeoRasterオブジェクトの最大ピラミッド・レベル以下である必要があります。

使用上のノート

ピラミッド・レベルは、必要な記憶域が小さくなる低解像度イメージ、または必要な記憶域が大きくなる高解像度イメージを表します。ピラミッドおよびピラミッド・レベルの詳細は、「ピラミッド」を参照してください。

デフォルトのピラミッド・レベルの指定は、オプション操作であり、生成されたピラミッドでGeoRasterオブジェクトをビジュアル化する場合にのみ使用します。

処理の完了後、GeoRasterオブジェクトは自動的に検証されます。

ピラミッドが他の任意の操作(SDO_GEOR.deletePyramidやSDO_GEOR.subsetなど)によってGeoRasterオブジェクトから削除されると、オブジェクトのデフォルトのピラミッド・レベルもメタデータから削除されます。

GeoRasterオブジェクトに生成されたピラミッドが存在しない場合、またはdefaultPyramidLevelがGeoRasterオブジェクトの有効なピラミッド・レベル番号ではない場合、例外が発生します。

デフォルトのピラミッド・レベルは、SDO_GEOR.getDefaultPyramidLevelファンクションを使用して取得できます。

例

次の例では、ピラミッドを生成し、GEORASTER_TABLE表の指定したGeoRasterオブジェクト(GEORASTER列)にデフォルトのピラミッド・レベルを設定して、GeoRasterオブジェクトに設定したデフォルトのピラミッド・レベルを戻します。(GEORASTER_TABLE表の定義は、「記憶域パラメータ」の例1-1の次に説明されています。)

DECLARE
  grobj sdo_georaster;
BEGIN
  SELECT georaster INTO grobj FROM georaster_table WHERE georid=6 FOR UPDATE;
  sdo_geor.generatePyramid(grobj, 'rLevel=5, resampling=NN');
  sdo_geor.setDefaultPyramidLevel(grobj, 3);
  UPDATE georaster_table SET georaster = grobj WHERE georid=6;
  COMMIT;
END;
/
 
SELECT georid, sdo_geor.getDefaultPyramidLevel(georaster) FROM georaster_table
  WHERE georid=6;
 
       GEORID   PLEVEL
-------------- ---------- 
             6          3

7.127 SDO_GEOR.setDefaultPyramidLevel