フィーチャ レイヤー

フィーチャ レイヤー出力では、データ パイプライン データセットをホスト フィーチャ レイヤーまたはホスト テーブルに書き込みます。 フィーチャ レイヤーまたはテーブルを作成したり、既存のフィーチャ レイヤーまたはテーブル内のデータを置き換えたり、既存のフィーチャ レイヤーまたはテーブルにレコードを追加したり、既存のフィーチャ レイヤーまたはテーブル内のレコードを更新したりできます。

パラメーター

フィーチャ レイヤー出力で使用するパラメーターの概要を次の表に示します。

パラメーター	説明
入力データセット	フィーチャ レイヤーとして書き込まれるデータセット。
ジオメトリ	出力フィーチャ レイヤーで使用する位置を含むポイント、ライン、またはポリゴン ジオメトリ フィールド。 ジオメトリ フィールドを指定しない場合、出力はホスト テーブルになります。
時間タイプ	出力フィーチャ レイヤーの時間タイプを指定します。 [特定時点]、[間隔]、[なし] のいずれかから指定します。 デフォルトは [なし] です。
時間	出力レイヤーで使用するタイム スタンプを含む時間フィールド。 [時間タイプ] が [特定時点] の場合、このパラメーターは必須です。
開始時刻	出力レイヤーで使用する開始タイム スタンプを含む時間フィールド。 [時間タイプ] が [間隔] の場合、このパラメーターは必須です。
終了時間	出力レイヤーで使用する終了タイム スタンプを含む時間フィールド。 [時間タイプ] が [間隔] の場合、このパラメーターは必須です。
出力方法	出力結果を書き込むために使用する方法を指定します。 [作成] (デフォルト)、[置換]、[追加および更新] のいずれかから指定します。
フィーチャ レイヤー	新しいデータで置き換えられるホスト フィーチャ レイヤーまたはテーブル。 [出力方法] が [置換] または [追加および更新] の場合、このパラメーターは必須です。
一意識別子	レコードごとに一意の値を含むフィールド。 [追加および更新] 出力方法を使用してフィーチャ レイヤーの既存のレコードを更新する際に、このパラメーターは必須です。
出力名	出力フィーチャ レイヤーまたはテーブルの名前。
レイヤーがすでに存在する場合は上書き	提供した出力名を持つ既存のレイヤーを上書きするかどうかを指定します (オン)。
フォルダー	フィーチャ レイヤーまたはテーブルを保存する出力フォルダー。
文字列フィールド長	すべての出力文字列フィールドの長さを指定するオプションのパラメーター。 デフォルト値は、シングルバイト文字で 4,000 文字です。

使用上の注意

データ パイプラインを実行するには、少なくとも 1 つの出力が構成されている必要があります。

[入力データセット] パラメーターを使用して、ホスト フィーチャ レイヤーまたはテーブルとして書き込まれるデータセットを特定します。

必要に応じて、[ジオメトリ] パラメーターを使用して、出力のジオメトリを設定します。 入力データセットに含まれているジオメトリ フィールドが 1 つの場合は、デフォルトでそのフィールドが指定されます。 入力データセットに複数のジオメトリ フィールドが含まれている場合は、フィーチャ レイヤーで使用するフィールドを 1 つ指定します。 このパラメーターで指定されていないジオメトリ フィールドは削除され、出力には含まれません。 ジオメトリ フィールドを指定しない場合、出力結果はテーブルになります。

必要に応じて、[時間タイプ] に値を指定することで、出力に時間を設定できます。 次のようなオプションがあります。

• [特定時点] - 時系列内の 1 つの瞬間。 [時間] パラメーターを使用して、レコードの時間を表すフィールドを指定します。 時間フィールドは、日付タイプである必要があります。
• [間隔] - 開始時間と終了時間で表される時間間隔。 [開始時間] パラメーターを使用してレコードの開始時間を表すフィールドを指定し、[終了時間] パラメーターを使用してレコードの終了時間を表すフィールドを指定します。 時間フィールドは、日付タイプである必要があります。
• [なし] - 出力フィーチャ レイヤーに時間は含まれません。

日付フィールドは、エポックからのミリ秒形式および UTC (協定世界時) を使用してフィーチャ レイヤーまたはテーブルに格納されます。 データを見る場所によって値が表示される方法は異なります。 たとえば、フィーチャ サービスの REST エンド ポイントを検索すると、エポックからのミリ秒単位の値 (1667411518878 など) が返されます。 Data Pipelines エディターでは、同じ値が 11/02/2022 5:51 PM と表示されます。

サマリーやタグなどのアイテム プロパティを変更するには、ポータルのコンテンツ ページを参照して、フィーチャ レイヤー アイテムを直接編集します。

ArcGIS Online のアイテム詳細について

[出力方法] パラメーターを使用して、データ パイプラインの結果をフィーチャ レイヤーまたはテーブルに書き込む方法を指定します。 次のようなオプションがあります。

• [作成] - ホスト フィーチャ レイヤーまたはテーブルが作成されます。 この出力は、使用しているポータル コンテンツに格納されます。 出力には、入力データセットのフィーチャ (または行) とフィールド (または列) が含まれます。 [作成] 出力メソッドを選択すると、次のパラメーターを使用できます。
  • [出力名] パラメーターは、作成または上書きされるレイヤーの名前を指定します。
  • [レイヤーがすでに存在する場合は上書き] パラメーターを使用すると、出力名を変更せずにデータ パイプラインを再実行したり、既存のレイヤーのスキーマまたはジオメトリ タイプを変更したりできます。 このパラメーターは、デフォルトで有効になっています。 そのレイヤーが組織にまだ存在しない場合、データ パイプラインの初回実行時に新しいレイヤーが作成され、その後の実行時に上書きされます。 レイヤーの上書きは恒久的であり、取り消すことはできません。
• [置換] - 既存のフィーチャ レイヤーまたはテーブル内のデータが完全に置き換えられます。
• [追加および更新] - フィーチャ レイヤーまたはテーブルに新しいレコードを追加するか、フィーチャ レイヤーまたはテーブル内の既存のレコードを更新します。 既存のレコードを更新するには、[一意識別子] パラメーターを使用して、既存のレコードを識別する一意の値を含むフィールドを指定する必要があります。 指定したフィールドは、フィーチャ レイヤーまたはテーブルのアイテム ページで一意のフィールドとして設定する必要があります。 詳細については、「フィールドへの一意制約の追加」をご参照ください。

[文字列フィールド長] パラメーターを使用して、出力フィーチャ レイヤー内に作成される文字列フィールドの長さを指定します。 指定した長さは、すべての出力文字列フィールドに適用されます。 デフォルト値は、シングルバイト文字で 4,000 文字です。 入力データセット内の文字列が指定した文字列長を超えている場合、その値は切り捨てられて出力フィーチャ レイヤーに書き込まれます。

制限事項

以下に、フィーチャ レイヤー出力の既知の制限事項を示します。

• 出力ごとに 1 つのレイヤーまたはテーブルにしか書き込むことができません。 複数の出力を作成するには、ダイアグラム内で複数の出力フィーチャ レイヤー エレメントを構成する必要があります。 各出力は、独自のアイテムとしてポータル コンテンツに格納されます。
• 複数の出力フィーチャ レイヤーを構成している場合に 1 つの出力フィーチャ レイヤーの書き込みに失敗しても、データ パイプラインは残りの出力フィーチャ レイヤーの書き込みを続行します。 書き込みに失敗した出力フィーチャ レイヤーはロールバックされます。
• フィーチャ レイヤーに結果を書き込む際、入力ソースでサポートされているすべてのフィールド タイプが維持されるわけではありません。 フィールド タイプの変換の詳細については、次の表をご参照ください。
• 自分が管理者である場合と、自分がメンバーになっている共有更新グループでレイヤーまたはテーブルが共有されている場合を除いて、所有していないフィーチャ レイヤーまたはテーブルに対して [置換] と [追加および更新] を使用することはできません。
• [置換] または [追加および更新] を使用すると、一致するフィールド名に基づいてフィールドが更新されます。 フィールドの一致では、大文字と小文字が区別されます。 フィールド名を目的の出力レイヤーと一致させる場合は、フィールドの割り当てツールを使用します。 選択した一連のフィールド名を変更する場合は、フィールドの更新ツールを使用します。
• [置換] オプションを使用する際には、次の制限が適用されます。
  • リレーションシップの起点であるフィーチャ レイヤーまたはテーブルのデータの置換はサポートされていません。
  • フィーチャ レイヤーまたはテーブルで同期が有効になっている場合、置換はサポートされません。
  • 置き換えるレイヤーのジオメトリ タイプは、入力データセットと同じである必要があります。 たとえば、テーブルをポリゴンに置き換えたり、ポイントをポリラインに置き換えたりすることはできません。
  • 置き換えるレイヤーの時間タイプは、入力データセットと同じである必要があります。 たとえば、特定時間プロパティを間隔時間プロパティに置き換えることはできません。
  • 置き換えるレイヤーの空間参照が入力ジオメトリと異なる場合、入力ジオメトリは置き換えるレイヤーの空間参照に投影変換されます。
  • フィールドがデータ パイプラインの結果には存在し、置き換えるレイヤーには存在しない場合、そのフィールドはレイヤーに追加されません。
  • フィールドが置き換えるレイヤーには存在し、データ パイプラインの結果には存在しない場合、そのフィールドはレイヤー内で維持され、NULL 値またはフィーチャ レイヤーで定義されたデフォルト値が付加されます。
• 作成および [レイヤーがすでに存在する場合は上書き] 出力オプションを組み合わせて使用​​する場合、次の制限が適用されます。
  • 上書きするレイヤーは自分が所有している必要があります。
  • 上書きするレイヤーは Data Pipelines によって作成されている必要があります。
  • 上書きオプションは、スケジュール化または自動化された実行では推奨されていません。 [置換] や [追加および更新] とは異なり、上書きオプションではスキーマ、ジオメトリ、レコードが変更される可能性があり、その結果、ポップアップやフィルターなどの下流方向ワークフローが中断される可能性があります。
  • 書き込み失敗が発生しても、上書き操作はロールバックされないため、データ パイプラインが再度実行されるまでレイヤーが失われる可能性があります。 置換および [追加および更新] オプションは、障害が発生した場合にロールバックされ、元のデータは維持されます。
  • 上書きオプションを使用して既存のフィーチャ レイヤーの空間参照を更新することはできません。 ジオメトリ フィールドは、既存のフィーチャ レイヤーと同じ空間参照内に存在する必要があります。 入力ジオメトリの空間参照を更新するには、ジオメトリの投影変換ツールを使用します。
• [文字列フィールド長] パラメーターは、すべての出力文字列フィールドに適用されます。 長さの異なる文字列フィールドを含むフィーチャ レイヤーを作成する場合は、新しいレイヤーを作成し、そのレイヤーに対して置換出力方法を使用します。 これにより、定義したフィールドの長さが維持され、データ パイプラインのレコードがフィーチャ レイヤーに反映されます。 フィーチャ レイヤーを作成する方法の詳細については、「独自のレイヤーの定義」をご参照ください。

入力データセットのフィールド タイプと値は、出力フィーチャ レイヤーでサポートされている新しいタイプと値に変換することができます。 次の表に、データ タイプの変換の概要を示します。

入力データセットのフィールド タイプ	出力フィーチャ レイヤーのフィールド タイプ	備考
String	esriFieldTypeString	デフォルトで、出力フィーチャ レイヤー内の文字列フィールドは 4,000 文字の長さで作成されます。 [文字列フィールド長] パラメーターを使用して、異なる長さを指定します。 指定した長さを超えている値は切り捨てられます。
Small Integer	esriFieldTypeInteger
Integer	esriFieldTypeInteger
Big Integer	esriFieldTypeBigInteger
Float	esriFieldTypeSingle
Double	esriFieldTypeDouble
Date	esriFieldTypeDate	日付フィールドはタイム ゾーンを含めずに書き込まれ、エポックからのミリ秒形式で格納されます。 プレビューを使用して日付の値を表示する場合、ブラウザーまたはクライアントのロケールのタイム ゾーンが使用されます。 ArcGIS Online の日付フィールドの詳細
Date Only	esriFieldTypeDateOnly
Blob	esriFieldTypeString	Blob 値は、出力フィーチャ レイヤーで base64 エンコード文字列に変換されます。 アプリでこのフィールドをプレビューする場合、値は文字列 ("BLOB") に変換されます。
Boolean	esriFieldTypeString	Boolean 値は文字列に変換され、フィーチャ レイヤーの文字列フィールドに格納されます。 true 値は "True"、false 値は "False" として書き込まれます。
Array	esriFieldTypeString	Array 値は変換され、文字列フィールドとして格納されます。
Map	esriFieldTypeString	Map 値は変換され、文字列フィールドとして格納されます。
Struct	esriFieldTypeString	Struct 値は変換され、文字列フィールドとして格納されます。
Geometry	esriFieldTypeGeometry	Geometry フィールドは、[ジオメトリ] パラメーター値に応じて、ポイント、ライン、またはポリゴン ジオメトリを表すことができます。

ライセンス要件

次のライセンスと構成が必要です。

• Creator または Professional ユーザー タイプ
• 公開者、ファシリテーター、管理者ロール、またはそれと同等のカスタム ロール

Data Pipelines の要件の詳細については、要件をご参照ください。

関連トピック

詳細については、以下をご参照ください。

• 自動化されたスケジュールで既存のフィーチャ レイヤーを更新する方法については、「データ パイプライン タスクのスケジュール設定」をご参照ください。
• フィーチャ レイヤーに設定されているプロパティの詳細については、「ホスト フィーチャ レイヤーの管理」をご参照ください。
• フィーチャ レイヤーの詳細については、ArcGIS Online ヘルプの「フィーチャ レイヤー」をご参照ください。