7.119 SDO_GEOR.setBlankCellValue

形式

SDO_GEOR.setBlankCellValue(
     georaster  IN OUT SDO_GEORASTER, 
     value      IN NUMBER);

説明

指定されたGeoRasterオブジェクトが空白のGeoRasterオブジェクトである場合に、すべてのセルに使用されるセル値を設定(変更)します。

パラメータ

georaster

GeoRasterオブジェクトを指定します。

value

空白のGeoRasterオブジェクトに使用するセル値を指定します。NULL値は指定できません。

使用上のノート

空白のGeoRasterオブジェクトでは、すべてのセルが同じセル値を持ちます。

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

空白のGeoRasterオブジェクトの空白のセル値を戻すには、SDO_GEOR.getBlankCellValueファンクションを使用します。指定したGeoRasterオブジェクトが空白のGeoRasterオブジェクトかどうかを確認するには、SDO_GEOR.isBlankファンクションを使用します。

valueがNULLか、またはcellDepthの指定と一貫性がない場合、あるいはGeoRasterオブジェクトが空白以外の場合は、例外が発生します。

例

次の例では、GEORASTER_TABLE表で、GEORID列値が1である行に含まれているGeoRasterオブジェクト(GEORASTER列)のすべてのセルで使用する値に、255を指定します。(GEORASTER_TABLE表の定義は、「記憶域パラメータ」の例1-1の次に説明されています。)

DECLARE
  grobj sdo_georaster;
BEGIN
  SELECT georaster INTO grobj FROM georaster_table WHERE georid=1 FOR UPDATE;
  sdo_geor.setBlankCellValue(grobj, 255);
  UPDATE georaster_table SET georaster = grobj WHERE georid=1;
  COMMIT;
END;
/