SDO_GEOR.getRasterBlocks

形式

SDO_GEOR.getRasterBlocks(
     georaster    IN SDO_GEORASTER, 
     pyramidLevel IN NUMBER, 
     window       IN SDO_NUMBER_ARRAY 
     ) RETURN SDO_RASTERSET;

または

SDO_GEOR.getRasterBlocks(
     georaster    IN SDO_GEORASTER, 
     pyramidLevel IN NUMBER, 
     window       IN SDO_GEOMETRY 
     ) RETURN SDO_RASTERSET;

説明

指定されたピラミッド・レベルで、指定されたウィンドウと空間的に相互作用するすべてのブロックを識別する、SDO_RASTERSETコレクション型のオブジェクトを戻します。

パラメータ

georaster: GeoRasterオブジェクトを指定します。
pyramidLevel: 指定したウィンドウと空間的に相互作用するブロックを戻すピラミッド・レベルを指定します。
window: pyramidLevelで指定したレベル内のブロックを戻すウィンドウを指定します。データ型はSDO_NUMBER_ARRAYまたはSDO_GEOMETRYのいずれかです。データ型がSDO_NUMBER_ARRAYの場合、このパラメータで矩形ウィンドウの左上の座標(行,列)と右下の座標(行,列)を指定することによって、ラスター空間が想定されます。データ型がSDO_GEOMETRYの場合は、SDO_SRID要件の「使用上のノート」を参照してください。

使用上のノート

SDO_RASTERSETコレクション型の詳細は、「SDO_RASTERSETコレクション型」を参照してください。

windowパラメータのデータ型がSDO_GEOMETRYの場合、SDO_SRID値は次のいずれかの値である必要があります。

NULL(ラスター空間を指定)
MDSYS.CS_SRS表のSRID列の値

windowパラメータ・ジオメトリとモデル空間のSDO_SRID値が異なる場合は、処理が実行される前に、windowパラメータ・ジオメトリは自動的にモデル空間の座標系に変換されます。(ラスター空間およびモデル空間の詳細は、「GeoRasterデータ・モデル」を参照してください。)

例

次の例では、指定したウィンドウと空間的に相互作用するすべてのラスター・ブロックを識別するコレクション・セットを戻します。(GEORASTER_TABLEという名前の表を参照します。この表の定義は「記憶域パラメータ」の例1-1の次に説明されています。)

DECLARE
  gr sdo_georaster;
  ds sdo_rasterset;
BEGIN
  SELECT georaster INTO gr FROM georaster_table WHERE georid=2;
  ds := sdo_geor.getRasterBlocks(gr, 0, sdo_number_array(11,65,192,244));
  COMMIT;
END;
/

7.81 SDO_GEOR.getRasterBlocks