13.12 SDO_GEOR_UTL.fillEmptyBlocks

形式

SDO_GEOR_UTL.fillEmptyBlocks(
     georaster     IN OUT SDO_GEORASTER, 
     bgValues      IN SDO_NUMBER_ARRAY DEFAULT NULL,
     parallelParam IN VARCHAR2 DEFAULT NULL);

説明

すべての空のブロックに、指定した背景値を入力します。

パラメータ

georaster

空のブロックに埋め込むGeoRasterオブジェクトを指定します。

bgValues

空のラスター・ブロックに入力する背景値を指定します。SDO_NUMBER_ARRAYオブジェクト内の要素の数は、1つ(すべてのバンドに同じ入力値を使用)またはバンド次元のサイズ(各バンドにそれぞれ異なる入力値を使用)のいずれかであることが必要です。たとえば、SDO_NUMBER_ARRAY(1,5,10)では、1番目のバンドに1、2番目のバンドに5、3番目のバンドに10が入力されます。このパラメータがNULLの場合、bgValuesは0(ゼロ)になります。

parallelParam

操作の並列度を指定します。指定する場合、parallel=nという形式である必要があります(nは1より大きい)。データベース・オプティマイザでは、このパラメータによって指定された並列度を使用します。指定しない場合、デフォルトでパラレル処理は行われません。(詳細は、「GeoRasterでのパラレル処理」を参照してください。)

使用上のノート

georasterがNULLの場合、このプロシージャは処理を実行しません。

georasterにピラミッド・データが存在する場合、メタデータに格納されているピラミッド情報に基づいて、ピラミッドが再生成されます。

このプロシージャは、指定した背景値を持つブロックを空のブロックに変更するSDO_GEOR_UTL.emptyBlocksとは対照的です。

例

次の例では、背景値(255,0,0)を持つブロックを空にします。

DECLARE
  geor  SDO_GEORASTER;
BEGIN
  SELECT georaster INTO geor FROM georaster_table WHERE georid = 3 FOR UPDATE;
  SDO_GEOR_UTL.emptyBlocks(geor, SDO_NUMBER_ARRAY(255,0,0));
  UPDATE georaster_table SET georaster = geor WHERE georid = 3;
  COMMIT;
END;
/