テーブル → テーブル (Table to Table) (変換)

サマリー

テーブル、テーブル ビュー、フィーチャ レイヤー、フィーチャクラス、または属性テーブルのあるラスターの行を新しいジオデータベースの *.csv、*.txt、または *.dbf テーブルにエクスポートします。

使用法

  • このツールは入力として次のテーブル形式をサポートします。

    • ジオデータベース
    • dBASE (*.dbf)
    • カンマ区切り値 (*.csv または *.txt)
    • Microsoft Excel ワークシート (*.xls または *.xlsx)
    • メモリ内テーブル ビュー

    ファイル入力 (*.csv または *.txt) の場合は、入力ファイルの 1 行目が出力テーブルのフィールド名として使用されます。フィールド名には空白または特殊文字 ($ または * など) を使用できません。入力ファイルの 1 行目に空白または特殊文字が含まれている場合は、エラーが表示されます。

  • 出力データセット内のすべてのフィールドおよびそのフィールドの内容は、[フィールド マップ] を使用して制御できます。

    • フィールドの順序を変更するには、フィールド名を選択して、目的の位置にドラッグします。
    • 出力フィールドのデフォルトのデータ タイプは、最初に検出した (その名前の) 入力フィールドのデータ タイプと同じになります。データ タイプをいつでも手動で他の任意の有効なデータ タイプに変更できます。
    • 使用できるマージ ルールは、最初、最後、結合、合計値、平均値、中央値、最頻値、最小値、最大値、標準偏差、個数です。
    • [結合] マージ ルールを使用している場合、スペース、カンマ、ピリオド、ダッシュなど、区切り文字を指定できます。スペースを使用する場合は、入力ボックスの先頭にポインターを置き、Space キーを 1 回押してください。
    • 形式オプションを使用すると、テキスト フィールドの開始位置および終了位置を指定できます。
    • 1 個しかないデータの標準偏差を計算しないでください。ゼロによる除算が発生するからです。したがって、入力ソースがただ 1 つである場合には、[標準偏差] オプションを使用すべきではありません。

    スクリプトでフィールドをマッピングする方法の詳細

  • サブタイプあるいはドメインを持つジオデータベース データを dBASE テーブルに変換すると、サブタイプとドメインのコードと説明の両方を出力に含むことができます。この振舞いを制御するため、フィールド ドメイン情報の転送ジオプロセシング環境を使用してください。デフォルトでは、ドメインとサブタイプのみが出力に含まれ、説明には含まれません。

    注意:

    サブタイプの説明とドメインの説明を含めて dBASE (*.dbf) テーブルに変換すると、説明を含めない場合に比べて時間がかかる (パフォーマンスが低下する) 場合があります。dBASE (*.dbf) テーブルの出力にサブタイプの説明とドメインの説明が必要ない場合、パフォーマンスを最適化するためにチェックボックスをオフにして (スクリプト中では False または NOT_TRANSFER_DOMAINS)[フィールド ドメインの説明を転送] 環境をデフォルトの振舞いにすることをお勧めします。

パラメーター

ラベル説明データ タイプ
入力テーブル

新しいテーブルにエクスポートする入力テーブル。

Table View; Raster Layer
出力場所

出力テーブルの書き込み先。

Workspace
出力名

出力テーブルの名前。

出力場所がフォルダーである場合は、テーブルをその形式にエクスポートするために、*.csv、*.txt、*.dbf などの拡張子を指定します。出力場所がジオデータベースである場合は、拡張子を指定しません。

String
条件式
(オプション)

レコードのサブセットを選択するために使用する SQL 式。

SQL Expression
フィールド マップ
(オプション)

出力でどの属性フィールドを使用するかを制御します。デフォルトでは、入力のすべてのフィールドが含まれます。

フィールドの追加、削除、名前変更、並べ替えを行うことができ、フィールドのプロパティを変更することもできます。

マージ ルールによって、複数の入力フィールドの値を単一の出力値にマージまたは結合する方法を指定できます。出力フィールドの値を指定する方法を決定するために使用できるマージ ルールは複数あります。

  • 最初 - 入力フィールドの最初の値を使用します。
  • 最後 - 入力フィールドの最後の値を使用します。
  • 結合 - 入力フィールドの値を結合します。
  • 合計値 - 入力フィールドの値の合計を計算します。
  • 平均値 - 入力フィールドの値の平均を計算します。
  • 中央値 - 入力フィールドの値の中央値を計算します。
  • 最頻値 - 最頻値を使用します。
  • 最小値 - すべての入力フィールドの値のうちの最小値を使用します。
  • 最大値 - すべての入力フィールドの値のうちの最大値を使用します。
  • 標準偏差 - すべての入力フィールドの値に、標準偏差の分類法を使用します。
  • 個数 - 計算に含まれるレコード数を検出します。

Field Mappings
コンフィグレーション キーワード
(オプション)

リレーショナル データベース管理システム (RDBMS) 内のジオデータベース用のデフォルト ストレージ パラメーター (コンフィグレーション) を指定します。この設定は、エンタープライズ ジオデータベース テーブルを使用している場合にのみ適用可能です。

コンフィグレーション キーワードは、データベース管理者によって設定されます。

コンフィグレーション キーワードの詳細

String

派生した出力

ラベル説明データ タイプ
出力テーブル

出力テーブル。

テーブル

arcpy.conversion.TableToTable(in_rows, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})
名前説明データ タイプ
in_rows

新しいテーブルにエクスポートする入力テーブル。

Table View; Raster Layer
out_path

出力テーブルの書き込み先。

Workspace
out_name

出力テーブルの名前。

出力場所がフォルダーである場合は、テーブルをその形式にエクスポートするために、*.csv、*.txt、*.dbf などの拡張子を指定します。出力場所がジオデータベースである場合は、拡張子を指定しません。

String
where_clause
(オプション)

レコードのサブセットを選択するために使用する SQL 式。SQL クエリ式の詳細

SQL Expression
field_mapping
(オプション)

出力でどの属性フィールドを使用するかを制御します。デフォルトでは、入力のすべてのフィールドが含まれます。

フィールドの追加、削除、名前変更、並べ替えを行うことができ、フィールドのプロパティを変更することもできます。

マージ ルールによって、複数の入力フィールドの値を単一の出力値にマージまたは結合する方法を指定できます。出力フィールドの値を指定する方法を決定するために使用できるマージ ルールは複数あります。

  • 最初 - 入力フィールドの最初の値を使用します。
  • 最後 - 入力フィールドの最後の値を使用します。
  • 結合 - 入力フィールドの値を結合します。
  • 合計値 - 入力フィールドの値の合計を計算します。
  • 平均値 - 入力フィールドの値の平均を計算します。
  • 中央値 - 入力フィールドの値の中央値を計算します。
  • 最頻値 - 最頻値を使用します。
  • 最小値 - すべての入力フィールドの値のうちの最小値を使用します。
  • 最大値 - すべての入力フィールドの値のうちの最大値を使用します。
  • 標準偏差 - すべての入力フィールドの値に、標準偏差の分類法を使用します。
  • 個数 - 計算に含まれるレコード数を検出します。

Python では、このパラメーターを定義するには、FieldMappings クラスを使用します。

Field Mappings
config_keyword
(オプション)

リレーショナル データベース管理システム (RDBMS) 内のジオデータベース用のデフォルト ストレージ パラメーター (コンフィグレーション) を指定します。この設定は、エンタープライズ ジオデータベース テーブルを使用している場合にのみ適用可能です。

コンフィグレーション キーワードは、データベース管理者によって設定されます。

コンフィグレーション キーワードの詳細

String

派生した出力

名前説明データ タイプ
out_table

出力テーブル。

テーブル

コードのサンプル

TableToTable (テーブル → テーブル変換) の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで TableToTable 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.TableToTable_conversion("vegtable.dbf", "C:/output/output.gdb", "vegtable")
TableToTable (テーブル → テーブル変換) の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトで、TableToTable 関数を使用する方法を示します。

# 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"
outLocation = "C:/output/output.gdb"
outTable = "estuarine"
# 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'"
 
# Execute TableToTable
arcpy.TableToTable_conversion(inTable, outLocation, outTable, expression)

関連トピック