| ラベル | 説明 | データ タイプ |
入力テーブル | 新しいテーブルにエクスポートされる行を含む入力テーブル。 | Table View; Raster Layer |
出力テーブル | エクスポートされた行を含む出力テーブル。 出力場所がフォルダーである場合は、テーブルをそれぞれの形式にエクスポートするために、.csv、.txt、.dbf などの拡張子を指定します。 出力場所がジオデータベースである場合は、拡張子を指定しません。 | Table |
式 (オプション) | レコードのサブセットを選択するために使用する SQL 式。 | SQL Expression |
フィールド エイリアスを名前として使用する | 入力のフィールド名またはフィールド エイリアスを出力フィールド名として使用するかどうかを指定します。
| Boolean |
フィールド マップ (オプション) | 出力に含まれる属性フィールド、およびそれに対応するフィールド プロパティとソース フィールド。 デフォルトでは、入力のすべてのフィールドが含まれます。 フィールドの追加、削除、名前変更、並べ替えを行うことができ、フィールドのプロパティを変更することもできます。 マージ ルールによって、複数の入力フィールドの値を単一の出力値にマージまたは結合する方法を指定できます。 出力フィールドの値を指定する方法を決定するために使用できるマージ ルールは次のとおりです。
| Field Mappings |
ソート フィールド (オプション) | 入力レコードを並べ替えるために値を使用するフィールドと、レコードを格納する方向。
| Value Table |
サマリー
テーブルまたはテーブル ビューの行をテーブルにエクスポートします。
使用法
このツールは、テーブル、テーブル ビュー、フィーチャクラス、フィーチャ レイヤー、区切りファイル、または属性テーブルのあるラスターの行を新しいジオデータベース/dBASE テーブル、または区切りファイルにコピーします。
このツールは入力として次のテーブル形式をサポートします。
- ジオデータベース
- dBASE (.dbf)
- Microsoft Excel ワークシート (.xls および .xlsx)
- メモリベースのテーブル
- 区切り文字で区切られたファイル
- カンマ区切りファイル (.csv、.txt、および .asc)
- タブ区切りファイル (.tsv および .tab)
- パイプ区切りファイル (.psv)
区切りファイルの場合は、入力ファイルの 1 行目が出力テーブルのフィールド名として使用されます。 フィールド名には空白または特殊文字 ($、* など) を使用できません。入力ファイルの 1 行目に空白または特殊文字が含まれている場合は、エラーが発生します。
このツールを使用して、フォルダー ワークスペース内の出力名に次のファイル拡張子のいずれかを追加することで、区切りファイルを出力することができます。
- カンマ区切りファイル (.csv、.txt、または .asc)
- タブ区切りファイル (.tsv または .tab)
- パイプ区切りファイル (.psv)
出力がジオデータベース内にない場合、BLOB またはラスター フィールドは含まれません。 GlobalID フィールドはテキスト フィールドに変換されます。
出力データセット内のフィールドとそれらのフィールドの内容を管理するには、[フィールド マップ] パラメーターを使用します。
- フィールドの順序を変更するには、フィールド名を選択して、新しい位置にドラッグします。
- 出力フィールドのデフォルトのデータ タイプは、最初に検出した (その名前の) 入力フィールドのデータ タイプと同じになります。 データ タイプをいつでも手動で他の任意の有効なデータ タイプに変更できます。
- 使用できるマージ ルールは、最初、最後、結合、合計、平均、中央値、最頻値、最小、最大、標準偏差、個数です。
- [結合] マージ ルールを使用している場合、スペース、カンマ、ピリオド、ダッシュなど、区切り文字を指定できます。 スペースを使用する場合は、入力ボックスの先頭にポインターを置き、Space キーを 1 回押してください。
- 書式設定オプションを使用して、テキスト フィールドの開始位置と終了位置を指定できます。
- ゼロによる除算が発生するため、1 個しかないデータの標準偏差を計算しないでください。したがって、入力ソースがただ 1 つである場合には、標準偏差オプションを使用すべきではありません。
フィーチャのサブセットを選択するために、SQL 式を使用できます。 [式] パラメーターの構文の詳細については、「ArcGIS で使用されるクエリ式への SQL リファレンス」をご参照ください。
行は、[並べ替えフィールド] のパラメーター値を指定することにより、昇順または降順で並べ替えできます。 2 つ以上のフィールドを指定した場合、最初のフィールドによって行が並べ替えられ、次にその順序内で 2 番目のフィールドによって並べ替えられ、以降、同様に並べ替えが続けられます。
サブタイプあるいはドメインを持つジオデータベース データを変換し、出力ワークスペースがジオデータベースではない場合、サブタイプとドメインのコードおよび説明の両方を出力に含むことができます。 この振舞いを制御するため、フィールド ドメインの説明を転送環境を使用してください。 デフォルトでは、ドメインとサブタイプのみが出力に含まれ、説明には含まれません。
注意:
サブタイプの説明とドメインの説明を含めて dBASE テーブルに変換すると、説明を含めない場合に比べて時間がかかる (パフォーマンスが低下する) 場合があります。 出力にサブタイプの説明とドメインの説明が必要ない場合、パフォーマンスを最適化するために、フィールド ドメインの説明を転送環境のデフォルト設定 (オフ) を使用することをお勧めします。
パラメーター
arcpy.conversion.ExportTable(in_table, out_table, {where_clause}, use_field_alias_as_name, {field_mapping}, {sort_field})| 名前 | 説明 | データ タイプ |
in_table | 新しいテーブルにエクスポートされる行を含む入力テーブル。 | Table View; Raster Layer |
out_table | エクスポートされた行を含む出力テーブル。 出力場所がフォルダーである場合は、テーブルをそれぞれの形式にエクスポートするために、.csv、.txt、.dbf などの拡張子を指定します。 出力場所がジオデータベースである場合は、拡張子を指定しません。 | Table |
where_clause (オプション) | レコードのサブセットを選択するために使用する SQL 式。SQL 構文の詳細については、ヘルプ トピックの「ArcGIS で使用されるクエリ式への SQL リファレンス」をご参照ください。 | SQL Expression |
use_field_alias_as_name | 入力のフィールド名またはフィールド エイリアスを出力フィールド名として使用するかどうかを指定します。
| Boolean |
field_mapping (オプション) | 出力に含まれる属性フィールド、およびそれに対応するフィールド プロパティとソース フィールド。 デフォルトでは、入力のすべてのフィールドが含まれます。 フィールドの追加、削除、名前変更、並べ替えを行うことができ、フィールドのプロパティを変更することもできます。 マージ ルールによって、複数の入力フィールドの値を単一の出力値にマージまたは結合する方法を指定できます。 出力フィールドの値を指定する方法を決定するために使用できるマージ ルールは次のとおりです。
| Field Mappings |
sort_field [sort_field,...] (オプション) | 入力レコードを並べ替えるために値を使用するフィールドと、レコードを格納する方向。
| Value Table |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで ExportTable 関数を使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.ExportTable("vegtable.dbf", "C:/output/output.gdb/vegtable")次のスタンドアロン スクリプトで、ExportTable 関数を使用する方法を示します。
# Description: Use TableToTable with an expression to create a subset
# of the original table.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inTable = "vegtable.dbf"
outTable = "C:/output/output.gdb/estuarine.csv"
# Set the expression, with help from the AddFieldDelimiters function, to select
# the appropriate field delimiters for the data type
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "VEG_TYPE") + " = 'Estuarine'"
# Run TableToTable
arcpy.conversion.ExportTable(inTable, outTable, expression, "NOT_USE_ALIAS")