既存の MFC (マルチファイル フィーチャ コネクション) を更新し、ソースの位置に追加された新しいデータセットを登録します。
このツールには、MFC が必要です。 MFC を作成するには、[マルチファイル フィーチャ コネクションの作成 (Create Multifile Feature Connection)] ツールを使用します。
このツールは、既存のマルチファイル フィーチャ コネクションに 1 つ以上の新しいデータセットを追加するために使用します。 また、このツールは [マルチファイル フィーチャ コネクションからデータセットを削除 (Remove Dataset From Multifile Feature Connection)] ツールを使用して削除されたデータセットを再登録します。 このツールは、次のような状況で使用します。
このツールでは、[マルチファイル フィーチャ コネクション データセット プロパティの更新 (Update Multifile Feature Connection Dataset Properties)] ツールを使用して編集された既存のデータセット プロパティは更新されません。 変更されたプロパティはすべて維持されます。 推奨されるワークフローには次のシナリオがあります。
ツールのメッセージには、見つかったデータベースとそのステータスに関する次の情報が含まれています。
MFC 内のデータセットを探しているとき、次の 2 つの問題が起きることがあります:
| 問題 | 解決策 | 例 |
|---|---|---|
データセットが予期した形式ではない。 | ファイルを開き、予期した形式であるか確認します。 データが正しく構成されていない場合、更新して再度登録します。 | .csv ファイルにはデータについて数行の記述とサマリーがあるのみで、残りは空白行となっています。 |
フォルダー内にあるデータセットのスキーマが一致しない。 | データセット フォルダー内のファイルはすべて同じスキーマを持つ必要があります。 ファイルを開き、スキーマを比較します。 一致しないスキーマがあれば削除し、データセットを再度登録します。 | ある .csv ファイルは 10 個のフィールドがあり、別のファイルは 8 個のフィールドがある。 |
フォルダー内にあるデータセットのファイル タイプが一致しない。 | データセット フォルダー内のファイルはすべて同じエクステンション (ファイル タイプ) である必要があります。 データ ソースがある場所のファイル タイプを確認し、適切でないファイルは削除または移動します。 | シェープファイルのデータセットがパーケット ファイルと同じフォルダーにある。 |
認識されないフィールド形式がある。 | ORC やパーケットが予期しない形式の場合に起こることがあります。 有効なフィールド形式を使用してください。 | 不明なフィールド形式のパーケット ファイルがある。 |
MFC を更新したら、[データセットの記述 (Describe Dataset)] ツールを使用して、更新されたデータセットが期待するように表示されることを確認します。
[マルチファイル フィーチャ コネクションの更新 (Refresh Multifile Feature Connection)] ツールは、新しいデータセットを識別します。 MFC の変更には、次のツールも使用できます。
ジオプロセシング ツールは、Spark を活用しています。 マルチファイル フィーチャ コネクションの詳細と、その使用方法については、「マルチファイル フィーチャ コネクション」をご参照ください。
| ラベル | 説明 | データ タイプ |
マルチファイル フィーチャ コネクション ファイル | 更新される MFC ファイル。 | File |
ジオメトリ フィールドの表示 (オプション) | MFC ファイルを他のジオプロセシング ツールで使用するとき、ジオメトリを識別するため使用されるフィールドを分析に含める (表示) かどうかを指定します。 ジオメトリ フィールドが非表示のときでも、ジオメトリはデータセットに適用されます。 ジオメトリの表示設定は、MFC で変更できます。
| Boolean |
時間フィールドの表示 (オプション) | MFC ファイルを他のジオプロセシング ツールで使用するとき、時間を示すフィールドを分析に含める (表示) かどうかを指定します。 時間フィールドが非表示のときでも、時間はデータセットに適用されます。 時間の表示設定は、MFC で変更できます。
| Boolean |
| ラベル | 説明 | データ タイプ |
| 更新された MFC | 更新されたデータセットを含む入力 *.mfc ファイル。 | File |
arcpy.gapro.RefreshBDC(bdc_file, {visible_geometry}, {visible_time})| 名前 | 説明 | データ タイプ |
bdc_file | 更新される MFC ファイル。 | File |
visible_geometry (オプション) | MFC ファイルを他のジオプロセシング ツールで使用するとき、ジオメトリを識別するため使用されるフィールドを分析に含める (表示) かどうかを指定します。 ジオメトリ フィールドが非表示のときでも、ジオメトリはデータセットに適用されます。 ジオメトリの表示設定は、MFC で変更できます。
| Boolean |
visible_time (オプション) | MFC ファイルを他のジオプロセシング ツールで使用するとき、時間を示すフィールドを分析に含める (表示) かどうかを指定します。 時間フィールドが非表示のときでも、時間はデータセットに適用されます。 時間の表示設定は、MFC で変更できます。
| Boolean |
| 名前 | 説明 | データ タイプ |
| updated_bdc | 更新されたデータセットを含む入力 *.mfc ファイル。 | File |
次の Python スクリプトは、RefreshBDC 関数の使用方法を示しています。
# Name: RefreshBDC.py
# Description: Refreshes a multifile feature connection to automatically discover datasets that
# have been added.
#
# Requirements: ArcGIS Pro Advanced License
# Import system modules
import arcpy
# Set local variables
mfcFile = r"c:\Projects\MyProjectFolder\my_BigDataConnection.mfc"
# Run Refresh Multifile Feature Connection
arcpy.gapro.RefreshBDC(mfcFile)