マルチファイル フィーチャ コネクション データセット プロパティの更新 (Update Multifile Feature Connection Dataset Properties) (GeoAnalytics Desktop)

サマリー

マルチファイル フィーチャ コネクション (MFC) データセットのプロパティを更新します。 このツールは、指定された MFC データセットのフィールド、ジオメトリ、時間、ファイル設定を変更します。

使用法

• このツールには、MFC が必要です。 MFC を作成するには、[新しいマルチファイル フィーチャ コネクション] ダイアログまたは [マルチファイル フィーチャ コネクションの作成 (Create Multifile Feature Connection)] ツールを使用します。

• このツールを使用し、以下のようなシナリオの解析または視覚化において、MFC データセット スキーマ、ジオメトリ、または使用タイミングを変更します。

  • CSV データセットがすべて文字列型フィールドで登録されているとき、解析で使用するためにフィールドを数値に設定します。
  • MFC データセットに、タクシー乗り場と降車場などの 2 つの個別の場所を表す属性値があり、解析に使用するジオメトリを変更するとします。
  • このワークフローでは、入力レイヤーに時間を設定する必要があります。
  • 一部のフィーチャにのみ関心がある同僚に MFC データセットを共有するため、フィルター設定式を追加して、未使用の一部フィールドを非表示にします。

• 次のプロパティを変更できます。

  • [フィルター設定] - 解析で使用するフィーチャの制限に使用される式。
  • [フィールド] - フィールド名、フィールド タイプ、および表示設定。
  • [ジオメトリ] - ジオメトリの表記方法。 シェープファイルでは編集できません。
  • [時間] - 時間の表記方法。
  • [ファイル] - データセットの読み取りに使用するファイル プロパティ。

• [新しいマルチファイル フィーチャ コネクション] ダイアログ ボックスを使用すると、マルチファイル フィーチャ コネクションを簡単に作成、編集、プレビューできます。

• [マルチファイル フィーチャ コネクション データセット] パラメーターを使用し、変更したいプロパティを含む MFC データセットを指定します。 データセットを参照するか、c:\<path>\MyMFC.mfc\<dataset_name> などのパス (c:\MyMFCFolder\MyMFC.mfc\earthquakes_dataset など) を使用して指定できます。

• [式] パラメーターを使用し、解析で使用するフィーチャを制限する式を定義します。 MFC データセットにフィルターを追加する操作は、マップのデータセットにフィルター設定を適用する操作と似ており、SQL 式を指定して対象フィーチャをフィルタリングします。

• フィールド タイプは、区切り付きファイルで更新できます。 他のデータ ソース (シェープファイル、ORC、パーケット ファイルなど) のフィールド タイプは更新できません。

• 区切り文字で区切られたファイル、ORC、パーケット ファイルのジオメトリを変更できます。 シェープファイルから取得したデータセットのジオメトリを変更することはできません。

• 以下の表に、MFC データセットを編集するときに [開始時間] パラメーターと [終了時間] パラメーターの時間形式を指定する方法をまとめます。 例では、2016 年 1 月 2 日 9:45:02.05 PM の時間を表す方法を示します。

  マルチファイル フィーチャ コネクションの時間形式

  シンボル	意味	例
  yy	2 桁で表された年。	16
  yyyy	4 桁で表された年。	2016
  MM	数値で表された月。	01 または 1
  MMM	3 文字で表された月。	Jan
  MMMM	完全なつづりで表された月。	January
  dd	日。	02 または 2
  HH	24 時間表記の場合の時。値の範囲は 0 ~ 23 です。	21
  hh	12 時間表記の場合の時。値の範囲は 1 ～ 12 です。	9
  mm	分 (値の範囲は 0 ～ 59)。	45
  ss	秒 (値の範囲は 0 ～ 59)。	02
  SSS	ミリ秒 (値の範囲は 0 ～ 999)。	50
  a	AM/PM マーカー。	PM
  epoch_millis	エポックからの時間 (ミリ秒)。	1509581781000
  epoch_seconds	エポックからの時間 (秒)。	1509747601
  Z	タイムゾーンのオフセット (時)。	-0100 または -01:00
  ZZZ	タイムゾーンのオフセット (ID)。	America/Los_Angeles
  ''	この表に説明されている値を表していないテキストを追加するには、一重引用符を使用します。	'T'

  以下の表では、同じ日付 (2016 年 1 月 2 日 9:45:02.05 PM) の異なるフォーマットの例を示します。

  時間フォーマットの例

  入力データ	日付フォーマット
  01/02/2016 9:45:02PM	MM/dd/yyyy hh:mm:ssa
  Jan02-16 21:45:02	MMMdd-yy HH:mm:ss
  January 02 2016 9:45:02.050PM	MMMM dd yyyy hh:mm:ss.SSSa
  01/02/2017T9:45:14:05-0000	MM/dd/yyyy'T'HH:mm:ssZ

  You can specify the time zone using one of the following:
  • タイム ゾーンの完全な名称 (太平洋標準時など)。
  • タイムゾーンのオフセット (時): -0100 または -01:00
  • UTC または GMT 略称

• 区切り文字で区切ったファイルの次のプロパティを変更できます。

  • フィールド区切り文字 - フィールドごとの区切り文字。 一般的な区切り文字はカンマ (,) またはセミコロン (;) です。
  • レコード ターミネーター - データの行ごとのターミネーター。 一般的なターミネーターは \n と \t です。
  • 引用符 - ソース データセットの引用に使用する文字。
  • ヘッダー行を含む - ソース データセットにヘッダーが含まれるかどうかを示す true または false 値。 ヘッダー行がデータセットに含まれている場合、そのヘッダーがフィールド名に使用されます。
  • エンコード - ソース データセットが使用するエンコードのタイプ。 デフォルトは UTF-8 です。

• [マルチファイル フィーチャ コネクション データセット プロパティの更新 (Update Multifile Feature Connection Dataset Properties)] ツールは、個々のデータセットのプロパティを更新します。 MFC を変更するには、次のツールを使用します。

  • [マルチファイル フィーチャ コネクションからデータセットをコピー (Copy Dataset From Multifile Feature Connection)] - MFC からフィーチャクラスにデータセットをコピーします。
  • [マルチファイル フィーチャ コネクションからデータセットを複製 (Duplicate Dataset From Multifile Feature Connection)] - 既存の MFC データセットのビューを作成します。
  • [マルチファイル フィーチャ コネクションの更新 (Refresh Multifile Feature Connection)] - 新しいデータセットを確認して MFC に追加します。
  • [マルチファイル フィーチャ コネクションからデータセットを削除 (Remove Dataset From Multifile Feature Connection)] - データセットを MFC から削除します。
  • [マルチファイル フィーチャ コネクション データセット プロパティの更新 (Update Multifile Feature Connection Dataset Properties)] - 個々の MFC データセットのプロパティを変更します。
  • [マルチファイル フィーチャ コネクションからデータセットをプレビュー (Preview Dataset From Multifile Feature Connection)] - データセットのフィーチャが正しく登録していることを確認するため、最初の 10 のフィーチャをプレビューします。
  • [データセットの記述 (Describe Dataset)] - データセットが期待どおりに表示されるかどうかを確認します。

• オプションとして、MFC ファイルを手動で編集することもできます。 次のような状況では、常に *.mfc ファイルを手動で変更します。

  • x、y、z 座標を表すフィールドが 1 つ以上存在する。
  • ソース パスを更新する。

  マルチファイル フィーチャ コネクション ファイルの形式の詳細について説明します。

• ジオプロセシング ツールは、Spark を活用しています。 マルチファイル フィーチャ コネクションの詳細と、その使用方法については、「マルチファイル フィーチャ コネクション」をご参照ください。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
マルチファイル フィーチャ コネクション データセット	更新される MFC データセット。 編集のオプションは、ソース データ (シェープファイル、区切り、ORC、パーケット ファイル) によって異なります。	Table View
式 (オプション)	解析で使用するフィーチャの制限に使用される式。	SQL Expression
フィールド プロパティ (オプション)	変更するフィールド名とプロパティを指定します。 フィールドを表示するか非表示にするかを指定します。 オン - フィールドは表示され、ジオプロセシング ツールで使用可能です。 これがデフォルトです。 オフ - フィールドは非表示で、ジオプロセシング ツールの入力として使用されます。 Short—フィールド タイプは short です。 Long—フィールド タイプは long です。 Double—フィールド タイプは double です。 Float—フィールド タイプは float です。 String—フィールド タイプは string です。 Date—フィールド タイプは date です。 BLOB—フィールド タイプは BLOB です。	Value Table
ジオメトリ タイプ (オプション)	データセットを空間的に表現するために使用するジオメトリのタイプを指定します。 シェープファイルから取得したデータセットでは、ジオメトリを変更できません。 ポイント—ジオメトリ タイプはポイントです。 ポリライン—ジオメトリ タイプはポリラインです。 ポリゴン—ジオメトリ タイプはポリゴンです。 なし—ジオメトリ タイプは指定されません。	String
空間参照 (オプション)	データセットの空間参照に使用される WKID 値または WKT 文字列。 データセットは WKID 4326 (WGS84) です。 シェープファイルから取得したデータでは、空間参照を変更できません。	String
ジオメトリ形式タイプ (オプション)	ジオメトリの形式設定の方法を指定します。 シェープファイルから取得したデータでは、ジオメトリを変更できません。 XYZ—2 つ以上のフィールドが X、Y、および Z (オプション) を表します。 WKT—ジオメトリが WKT フィールド内の単一のフィールドで表されます。 WKB—ジオメトリが WKB (Well-Known Binary) フィールド内の単一のフィールドで表されます。 GeoJSON—ジオメトリは、GeoJSON 形式の単一のフィールドで表されます。 EsriJSON—ジオメトリは、EsriJSON 形式の単一のフィールドで表されます。 EsriShape—ジオメトリは、EsriShape 形式の単一のフィールドで表されます。	String
ジオメトリ フィールド (オプション)	ジオメトリの表現に使用される単一のフィールド。 このフィールドは、ジオメトリ形式が WKT、WKB、GeoJSON、EsriJSON、または EsriShape である場合に使用されます。	String
X フィールド (オプション)	X 位置を表示するフィールド。 複数のフィールドが X 位置を表示する場合は、*.mfc ファイルを手動で変更します。	String
Y フィールド (オプション)	Y 位置を表示するフィールド。 複数のフィールドが Y 位置を表示する場合は、*.mfc ファイルを手動で変更します。	String
Z フィールド (オプション)	Z 位置を表示するフィールド。 複数のフィールドが Z 位置を表示する場合は、*.mfc ファイルを手動で変更します。	String
時間タイプ (オプション)	データセットを時間的に表現するために使用する時間タイプを指定します。 間隔—時間タイプは、開始時間と終了時間で期間を表します。 インスタント—時間タイプは、時間内の瞬間を表します。 なし—時間が有効になっていません。	String
タイム ゾーン (オプション)	データセットのタイムゾーン。	String
開始時間 (オプション)	開始時間と時間形式を定義するためのフィールド。	Value Table
終了時間 (オプション)	終了時間と時間形式を定義するためのフィールド。	Value Table
ファイル拡張子 (オプション)	ソース データセットのファイル拡張子。 パラメーター値は変更できません。	String
フィールド区切り文字 (オプション)	ソース データセットで使用されるフィールド区切り文字。	String
レコード ターミネーター (オプション)	ソース データセットで使用されるレコード ターミネーター。	String
引用符 (オプション)	ソース データセットに使用する引用符。	String
ヘッダー行を含む (オプション)	ソース データセットにヘッダー行が含まれるかどうかを示します。 オン - ソース データセットにヘッダー行が含まれます。 オフ - ソース データセットにヘッダー行は含まれません。	Boolean
エンコード (オプション)	ソース データセットで使用されるエンコードのタイプ。 デフォルトは UTF-8 です。	String

派生した出力

ラベル	説明	データ タイプ
更新された MFC	編集されたプロパティを含む更新済み MFC ファイルを、指定データセットに適用します。	File

Python

arcpy.geoanalytics.UpdateBDCDatasetProperties(bdc_dataset, {expression}, {field_properties}, {geometry_type}, {spatial_reference}, {geometry_format_type}, {geometry_field}, {x_field}, {y_field}, {z_field}, {time_type}, {time_zone}, {start_time_format}, {end_time_format}, {file_extension}, {field_delimiter}, {record_terminator}, {quote_character}, {has_header_row}, {encoding})

名前	説明	データ タイプ
bdc_dataset	更新される MFC データセット。 編集のオプションは、ソース データ (シェープファイル、区切り、ORC、パーケット ファイル) によって異なります。	Table View
expression (オプション)	解析で使用するフィーチャの制限に使用される式。	SQL Expression
field_properties [field_properties,...] (オプション)	変更するフィールド名とプロパティを指定します。 SHORT—フィールド タイプは short です。 LONG—フィールド タイプは long です。 DOUBLE—フィールド タイプは double です。 FLOAT—フィールド タイプは float です。 STRING—フィールド タイプは string です。 DATE—フィールド タイプは date です。 BLOB—フィールド タイプは BLOB です。 フィールドを表示するか非表示にするかを指定します。 TRUE—フィールドは表示され、ジオプロセシング ツールで使用可能です。 これがデフォルトです。 FALSE—フィールドは非表示で、ジオプロセシング ツールの入力として使用されます。	Value Table
geometry_type (オプション)	データセットを空間的に表現するために使用するジオメトリのタイプを指定します。 シェープファイルから取得したデータセットでは、ジオメトリを変更できません。 POINT—ジオメトリ タイプはポイントです。 LINE—ジオメトリ タイプはポリラインです。 POLYGON—ジオメトリ タイプはポリゴンです。 NONE—ジオメトリ タイプは指定されません。	String
spatial_reference (オプション)	データセットの空間参照に使用される WKID 値または WKT 文字列。 データセットは WKID 4326 (WGS84) です。 シェープファイルから取得したデータでは、空間参照を変更できません。	String
geometry_format_type (オプション)	ジオメトリの形式設定の方法を指定します。 シェープファイルから取得したデータでは、ジオメトリを変更できません。 XYZ—2 つ以上のフィールドが X、Y、および Z (オプション) を表します。 WKT—ジオメトリが WKT フィールド内の単一のフィールドで表されます。 WKB—ジオメトリが WKB (Well-Known Binary) フィールド内の単一のフィールドで表されます。 GEOJSON—ジオメトリは、GeoJSON 形式の単一のフィールドで表されます。 ESRIJSON—ジオメトリは、EsriJSON 形式の単一のフィールドで表されます。 ESRISHAPE—ジオメトリは、EsriShape 形式の単一のフィールドで表されます。	String
geometry_field (オプション)	ジオメトリの表現に使用される単一のフィールド。 このフィールドは、ジオメトリ形式が WKT、WKB、GeoJSON、EsriJSON、または EsriShape である場合に使用されます。	String
x_field (オプション)	X 位置を表示するフィールド。 複数のフィールドが X 位置を表示する場合は、*.mfc ファイルを手動で変更します。	String
y_field (オプション)	Y 位置を表示するフィールド。 複数のフィールドが Y 位置を表示する場合は、*.mfc ファイルを手動で変更します。	String
z_field (オプション)	Z 位置を表示するフィールド。 複数のフィールドが Z 位置を表示する場合は、*.mfc ファイルを手動で変更します。	String
time_type (オプション)	データセットを時間的に表現するために使用する時間タイプを指定します。 INTERVAL—時間タイプは、開始時間と終了時間で期間を表します。 INSTANT—時間タイプは、時間内の瞬間を表します。 NONE—時間が有効になっていません。	String
time_zone (オプション)	データセットのタイムゾーン。	String
start_time_format [start_time_format,...] (オプション)	開始時間と時間形式を定義するためのフィールド。	Value Table
end_time_format [end_time_format,...] (オプション)	終了時間と時間形式を定義するためのフィールド。	Value Table
file_extension (オプション)	ソース データセットのファイル拡張子。 パラメーター値は変更できません。	String
field_delimiter (オプション)	ソース データセットで使用されるフィールド区切り文字。	String
record_terminator (オプション)	ソース データセットで使用されるレコード ターミネーター。	String
quote_character (オプション)	ソース データセットに使用する引用符。	String
has_header_row (オプション)	ソース データセットにヘッダー行が含まれるかどうかを示します。 HAS_HEADER—ソース データセットにヘッダー行が含まれます。 NO_HEADER—ソース データセットにヘッダー行は含まれません。	Boolean
encoding (オプション)	ソース データセットで使用されるエンコードのタイプ。 デフォルトは UTF-8 です。	String

派生した出力

名前	説明	データ タイプ
updated_bdc	編集されたプロパティを含む更新済み MFC ファイルを、指定データセットに適用します。	File

コードのサンプル

UpdateBDCDatasetProperties の例 (スタンドアロン スクリプト)

次の Python スクリプトは、UpdateBDCDatasetProperties 関数の使用方法を示しています。

# Name: UpdateBDCDatasetProperties.py
# Description: Add a filter and modify the schema, time, and geometry for a MFC dataset
# Requirements: ArcGIS Pro Advanced License

# Import system modules
import arcpy

# Set local variables
dataset = r"c:\Projects\MyProjectFolder\my_BigDataConnection.mfc\myBigDataset"
filter = "COUNT > 500"
field_properties = "Field1 FLOAT true;Field2 STRING true;Field3 DOUBLE true"
geometry_type = "POINT"
sref = "4326"
geometry_format = "XYZ"
x_field = "Long"
y_field = "Lat"
z_field = ""
time_type = "INSTANT"
time_zone = "UTC"
time_formats = "Year yyyy"
file_extension = "csv"
file_delimiter = ","
file_terminator = r"\n"
file_quotechar = '"'
has_header_row = True
file_encoding = "UTF-8"


# Run Update MFC Dataset Properties
arcpy.gapro.UpdateBDCDatasetProperties(dataset, filter, field_properties, geometry_type, sref, geometry_format, "",
x_field, y_field, z_field, time_type, time_zone, time_formats, None, file_extension, file_delimiter, file_terminator, 
file_quotechar, has_header_row, file_encoding)

環境

このツールは、ジオプロセシング環境を使用しません。