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