6.4 SDO_NET.ADD_FEATURE_ELEMENT

構文

SDO_NET.ADD_FEATURE_ELEMENT(
     feature_layer_id IN NUMBER,
     feature_id       IN NUMBER,
     feature_element  IN SDO_NET_FEAT_ELEM,
     sequence_number  IN NUMBER DEFAULT NULL,
     check_integrity  IN BOOLEAN DEFAULT TRUE);

説明

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

パラメータ

feature_layer_id

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

feature_id

フィーチャのIDです。

feature_element

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

sequence_number

フィーチャに追加されるフィーチャ要素の順序番号を指定します。このパラメータがNULLの場合、現在の最終番号の次の順序番号が割り当てられます。

check_integrity

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

使用上のノート

1回の操作で複数のフィーチャ要素をフィーチャに追加するには、SDO_NET.ADD_FEATURE_ELEMENTSプロシージャを使用します。

フィーチャ要素を更新するには、SDO_NET.UPDATE_FEATURE_ELEMENTプロシージャを使用します。

例

次の例では、ノードID 13の点フィーチャを順序番号2で追加します。

DECLARE
  feature_layer_id NUMBER;
  feature_id NUMBER := 1;
  feature_element SDO_NET_FEAT_ELEM;
  node_id NUMBER := 13;
BEGIN
  feature_layer_id := sdo_net.get_feature_layer_id('GRID', 'POI');
  feature_element := SDO_NET_FEAT_ELEM(SDO_NET.FEAT_ELEM_TYPE_PON, node_id, null, null);
  sdo_net.add_feature_element(feature_layer_id, feature_id, feature_element, 2);
END;
/