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

サマリー

テーブルの行を別のテーブルにエクスポートします。

レガシー:

このツールは「非推奨」のツールです。 この機能は、[テーブルのエクスポート (Export Table)] ツールに置き換えられています。

使用法

  • このツールは、テーブル、テーブル ビュー、フィーチャクラス、フィーチャ レイヤー、区切りファイル、または属性テーブルのあるラスターの行を新しいジオデータベース テーブル、dBASE テーブル、または区切りファイルにコピーします。

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

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

  • [出力場所] パラメーターの値がジオデータベースでない場合、BLOB またはラスター フィールドは含まれません。 GlobalID フィールドはテキスト フィールドに変換されます。

  • このツールを使用して、フォルダー ワークスペース内の出力名に次のファイル拡張子のいずれかを追加することで、区切りファイルを出力することができます。

    • カンマ区切りファイル (.csv.txt、または .asc)
    • タブ区切りファイル (.tsv または .tab)
    • パイプ区切りファイル (.psv)

  • 出力データセット内のフィールドとそれらのフィールドの内容を管理するには、[フィールド マップ] パラメーターを使用します。

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

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

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

    注意:

    サブタイプの説明とドメインの説明を含めて dBASE テーブルに変換すると、説明を含めない場合に比べて時間がかかる (パフォーマンスが低下する) 場合があります。 dBASE テーブル出力にサブタイプの説明とドメインの説明が必要ない場合、パフォーマンスを最適化するために、フィールド ドメインの説明環境をオフのままにします。

パラメーター

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

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

Table View; Raster Layer
出力場所

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

Workspace
出力名

出力テーブルの名前。

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

String
(オプション)

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

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

出力に含まれる属性フィールド、およびそれに対応するフィールド プロパティとソース フィールド。 デフォルトでは、入力のすべてのフィールドが含まれます。

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

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

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

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

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

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

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

String

派生した出力

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

出力テーブル。

Table

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
(オプション)

出力に含まれる属性フィールド、およびそれに対応するフィールド プロパティとソース フィールド。 デフォルトでは、入力のすべてのフィールドが含まれます。

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

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

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

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

Field Mappings
config_keyword
(オプション)

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

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

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

String

派生した出力

名前説明データ タイプ
out_table

出力テーブル。

Table

コードのサンプル

TableToTable の例 1 (Python ウィンドウ)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.TableToTable("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'"
 
# Run TableToTable
arcpy.conversion.TableToTable(inTable, outLocation, outTable, expression)

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック