6.5 SDO_NET.ADD_FEATURE_ELEMENTS

構文

SDO_NET.ADD_FEATURE_ELEMENTS(
     feature_layer_id IN NUMBER,
     feature_id       IN NUMBER,
     feature_elements IN SDO_NET_FEAT_ELEM,_ARRAY,
     check_integrity  IN BOOLEAN DEFAULT TRUE);

説明

フィーチャ要素の配列をフィーチャに追加します。

パラメータ

feature_layer_id

フィーチャのフィーチャ・レイヤーのIDを指定します。

feature_id

フィーチャのIDです。

feature_elements

フィーチャに追加されるフィーチャ要素を指定します。これらのフィーチャ要素は、フィーチャに含まれる既存の任意のフィーチャ要素の最後に自動的に追加されます。(SDO_NET_FEAT_ELEM_ARRAY型の詳細は、「フィーチャ・モデリングに使用するデータ型」を参照してください。)

check_integrity

TRUE (デフォルト)を指定すると、入力ネットワーク要素が存在するかどうかを確認し、存在しない場合はエラーが生成されます。FALSEを指定すると、入力ネットワーク要素が存在するかどうかを確認しません。

使用上のノート

単一のフィーチャ要素をフィーチャに追加するには、SDO_NET.ADD_FEATURE_ELEMENTプロシージャを使用します。

次の例では、2つの点フィーチャ要素を、フィーチャID 1に関連付けられたフィーチャ要素の最後に追加します。

DECLARE
  feature_layer_id NUMBER;
  feature_id NUMBER := 1;
  elements SDO_NET_FEAT_ELEM_ARRAY := SDO_NET_FEAT_ELEM_ARRAY();
  link_id NUMBER := 1314;
BEGIN
  feature_layer_id := sdo_net.get_feature_layer_id('GRID', 'POI');
  elements.extend;
  elements(1) := SDO_NET_FEAT_ELEM(SDO_NET.FEAT_ELEM_TYPE_POL, link_id, 0.7, null);
  elements.extend;
  elements(2) := SDO_NET_FEAT_ELEM(SDO_NET.FEAT_ELEM_TYPE_POL, link_id, 0.8, null);
  sdo_net.add_feature_elements(feature_layer_id, feature_id, elements);
END;
/