7.136 SDO_GEOR.setLayerID

形式

SDO_GEOR.setLayerID(
     georaster    IN OUT SDO_GEORASTER, 
     layerNumber  IN NUMBER, 
     id           IN VARCHAR2);

説明

GeoRasterオブジェクトのレイヤーに関連付けるユーザー定義の識別子を設定します。または、idパラメータにNULLが指定された場合、既存の値を削除します。

パラメータ

georaster

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

layerNumber

操作を実行するレイヤーの番号を指定します。

id

GeoRasterオブジェクトの指定したレイヤーに関連付けるID値を指定します。

使用上のノート

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

GeoRasterオブジェクトのレイヤーのユーザー定義の識別子の値を戻すには、SDO_GEOR.getLayerIDファンクションを使用します。

layerNumberがNULLか、GeoRasterオブジェクトに対して無効な場合、またはidはNULLであるが、対応するレイヤー情報が存在する場合は、例外が発生します。

例

次の例では、GEORASTER_TABLE表で、GEORID列値が4である行に含まれているGeoRasterオブジェクト(GEORASTER列)のレイヤー2のユーザー定義の識別子の値として、TM_Band_2を設定します。(GEORASTER_TABLE表の定義は、「記憶域パラメータ」の例1-1の次に説明されています。)

DECLARE
  grobj sdo_georaster;
BEGIN
  SELECT georaster INTO grobj FROM georaster_table WHERE georid=4 FOR UPDATE;
  sdo_geor.setLayerID(grobj, 2, 'TM_Band_2');
  UPDATE georaster_table SET georaster = grobj WHERE georid=4;
  COMMIT;
END;
/