フォルダーを監視 (新規 GeoJSON ファイル)—GeoEvent Server

[フォルダーを監視 (GeoJSON ファイル)] 入力コネクタは、GeoJSON として書式設定されたイベントデータをシステムファイルから読み込み、適合させるために使用されます。

GeoJSON ファイルで複数のイベントデータレコードが指定されている場合、下に示すように、FearureCollection に整理します。GeoJSON インバウンドアダプターは、フィーチャコレクションの各フィーチャレコードを、個別のイベントデータレコードとして処理します。以下に示す GeoJSON は、GeoEvent Service が処理するイベントデータレコードを 2 つ生成するよう適合されます。

GeoJSON データレコードの書式設定の詳細の例については、「GeoJSON の仕様」をご参照ください。

使用上の注意

この入力コネクタを使用し、GeoJSON として書式設定されたデータをシステムファイルから読み込み、それを適合してイベントレコードを作成して処理します。
この入力コネクタは、GeoJSON インバウンドアダプターとファイルインバウンドトランスポートを組み合わせます。
入力コネクタは、特定のシステムフォルダーを監視して、ファイルがフォルダーに出現すると同時にファイル全体を読み取ります。
ファイルに対して変更が加えられ、保存されると、ファイル全体のコンテンツが再読み込みされます。
次のような場合には、監視対象のフォルダーに含まれるすべてのファイルが、ファイルの最初から再読み込みされます。
- 入力コネクタのプロパティが更新され、保存された。
- 入力コネクタが停止し、再起動された (または ArcGIS GeoEvent Server サービスが再起動された)。
GeoJSON フィーチャレコードには、ジオメトリメンバーとプロパティメンバーの両方が含まれます。
GeoJSON インバウンドアダプターは [フィールドからジオメトリを作成] 機能をサポートしていません。
登録されたサーバーフォルダーの [入力フォルダのデータストア] は、絶対パスか UNC パスを使用して指定できます。 UNC パスが使用される場合、ArcGIS GeoEvent Server を実行する Windows サービスアカウントにはフォルダーへの読み取り/書き込み許可が必要です。
[入力フォルダーのデータストア] プロパティには、C:\GeoEvent\input のような絶対パスを使用することをお勧めします。
[入力ディレクトリ] では、登録されたサーバーフォルダーの相対的なサブフォルダーを指定できます。
[サブフォルダーを含める] では、[入力フォルダーのデータストア] を再帰的に検索するかどうかを指定できます。多くの場合、異なるスキーマを持つデータを異なるフォルダーに分けて整理し、[サブフォルダーを含める] をデフォルト設定から変更して再帰的検索を無効にすることで、この入力コネクタの構成をより直接的、かつシンプルにすることができます。
ネットワーク遅延が発生すると、大量のイベントデータを取得する GeoEvent Server の機能に悪影響が及びます。

パラメーター


パラメーター	説明
名前	GeoEvent Manager で参照用として使用される入力コネクタの記述名。
入力フォルダーデータストア	登録されたシステムフォルダーで、その直下にファイルがあります。
入力ディレクトリ	登録されたシステムフォルダーの直下のサブフォルダー。登録されたシステムフォルダーの直下にサブフォルダーが存在しない場合は、[入力ディレクトリ] を空のままにしておく必要があります。
入力ファイルフィルター	この入力に適したファイルを識別するための正規表現のパターン。入力は、このファイルを取り込んで適合し、処理を行うイベントデータレコードを作成します。 GeoJSON は、実質的には Generic JSON のサブタイプであるため、デフォルト値 ([.\.json]) は、末尾にリテラル接尾辞 ([.json]) が付くファイル名 ([.]) と一致させるために使用されます。入力ファイルがすべて (.geojson) 拡張子で名付けられることを想定し、汎用的な JSON ファイルとの混乱を避けるために、デフォルトのパターンを [.\.geojson] に変更することができます。このプロパティは必須ではないので空にしておくことができますが、この入力で使用するよう構成されたジオイベント定義と一致するスキーマを持つファイル名と一致するパターンを指定し、入力で取り込まないファイルを (名前を指定して) 除外することをお勧めします。
デフォルト空間参照	ジオメトリの座標が表される空間参照系の Well-Known ID (WKID) または Well-Known Text (WKT)。このプロパティにはデフォルト値はありません。
サブフォルダーを含める	[入力フォルダーのデータストア] と [入力ディレクトリ] (任意) のサブフォルダーも、ファイル検索の対象にするかどうかを指定します。デフォルトは [はい] です。ただし、スキーマの異なるデータを異なるフォルダーに分け、そのプロパティを [いいえ] に変更して再帰的検索を無効にすることで、シンプルな構成が可能になります。 [はい] – ファイルに対して再帰的検索を行います。これらのファイルのコンテンツは、イベントデータレコードを作成するために読み込まれ、適合されます。 [いいえ] – [入力フォルダーのデータストア] と [入力ディレクトリ] (任意) サブフォルダーのみが、ファイル検索の対象となります。
処理後にファイルを削除	登録済みシステムフォルダーのファイルのコンテンツを処理後、これらのファイルを削除するかどうかを指定します。ファイルのコンテンツを適合できない場合でもイベントレコードは作成されず、リアルタイムのイベント処理は行われず、コンテンツが正常に読み込まれたファイルであってもインバウンドトランスポートによって削除されます。デフォルトは [いいえ] です。 [はい] – 処理されたファイルは、登録済みシステムフォルダーから削除されます。 [いいえ] – 処理されたファイルは、登録済みシステムフォルダーから削除されません。
ジオイベント定義の作成	インバウンドイベントデータに新しいジオイベント定義を使用するか、既存のジオイベント定義を使用するかを指定します。 GeoEvent Server がインバウンドデータ属性フィールドおよびデータタイプを理解するには、ジオイベント定義が必要です。 [はい] – 最初に受信したイベントレコードのスキーマに基づき、新しいジオイベント定義が作成されます。 [いいえ] – 新しいジオイベント定義は作成されません。インバウンドイベントデータのスキーマに一致する、既存のジオイベント定義が選択されます。
ジオイベント定義名 (新規) (条件)	新しいジオイベント定義に与えられる名前。指定した名前を持つジオイベント定義がすでに存在する場合、既存のジオイベント定義が使用されます。最初に受信したデータレコードを使用し、後続のデータレコードで予期されるスキーマを決定します。新しいジオイベント定義は、最初のデータレコードのスキーマに基づいて作成されます。このプロパティは、[ジオイベント定義の作成] が [はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。
ジオイベント定義名 (既存) (条件)	受信したデータを適合して、GeoEvent Service によって処理されるイベントデータを作成する際に使用する、既存のジオイベント定義の名前。このプロパティは、[ジオイベント定義の作成] が [いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。
推定される日付形式	日付時間値として予期される文字列表現を一致させ、それを Java Date 値に変換するために使用されるパターン。パターンの形式は、Java SimpleDateFormat クラス変換に従います。このプロパティにはデフォルト値はありません。 GeoEvent Server では、日付/時間値を ISO 8601 標準で表すことを推奨していますが、日付値として一般的に認識されている日付/時間値の文字列表現のいくつかは、[推定される日付形式] パターンを指定しなくても Java Date 値に変換することができます。これらの要件を次に示します。 "2019-12-31T23:59:59" – ISO 8601 標準形式 1577836799000 – Java Date (紀元からの時間を示す Long 型整数、UTC) "Tue Dec 31 23:59:59 -0000 2019" – 一般的な Web サービス文字列形式 "12/31/2019 11:59:59 PM" – 米国で使用される一般的な形式 (12 時間形式) "12/31/2019 23:59:59" – 米国で使用される一般的な形式 (24 時間形式) 受信した日付/時間の値が、上記の 5 つ以外の形式で表される場合は、GeoEvent Server が日付/時間値を適合する方法を把握できるよう、[推定される日付形式] を指定する必要があります。
ファイルテキスト	ファイルがテキストベースかバイナリ形式かを指定します。デフォルトは [はい] です。 [はい] – ファイルはテキストベースです。 [いいえ] – ファイルはバイナリです。
バッチあたりの最大行数 (条件)	各バッチまたは間隔ごとに、ファイルから読み取る最大行数。デフォルトは [1000] 行です。各イベントレコードに多くの属性が含まれている場合、テキストアダプターにバッチとして送信されるデータの量を制限するには、この値を減らします。このプロパティは、[ファイルテキスト] が [はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。
バッチフラッシュ間隔 (ミリ秒) (条件)	ファイルから別のバッチの行を読み取るまでの待機時間 (ミリ秒) を指定します。デフォルトは [500] です。ファイルサイズが非常に大きくなることが予期される場合や、ファイルから取得されるバッチの行を処理するために長時間を要する場合には、この値を減らします。このプロパティは、[ファイルテキスト] が [はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。
ファイルの先頭からスキップする行の数 (条件)	ファイルの先頭からスキップする行の数。デフォルトは [0] です。属性フィールド名やデータタイプを指定するヘッダー行に、処理に使用される実際のデータが含まれない場合などに、一定の行数をスキップする場合には、この値を増やします。このプロパティは、[ファイルテキスト] が [はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。

このトピックへのフィードバック