サマリー
入力テーブル、テーブル ビュー、フィーチャクラス、またはフィーチャ レイヤーの行を新しいテーブル (タブ区切りの *.txt ファイルを含む) に書き出します。フィーチャクラスまたはフィーチャ レイヤーで選択セットが定義されている場合は、選択された行のみがコピーされます。
使用法
入力がフィーチャクラスまたはテーブルの場合、すべての行がコピーされます。入力行がレイヤーまたはテーブル ビューからのもので、対象範囲の選択が可能な場合は、選択したフィーチャまたは行だけが使用されます。
入力行がフィーチャクラスである場合は、属性のみ (ジオメトリを含まない) が出力テーブルにコピーされます。
このツールは入力として次のテーブル形式をサポートします。
- ジオデータベース
- dBASE (*.dbf)
- カンマ区切り値 (*.csv)
- タブ区切りテキスト (*.txt)
- Microsoft Excel ワークシート (*.xls または *.xlsx)
- INFO
- VPF
- OLE データベース
- メモリ内テーブル ビュー
ファイル入力 (*.csv または *.txt) の場合は、入力ファイルの 1 行目が出力テーブルのフィールド名として使用されます。フィールド名には空白または特殊文字 ($ または * など) を使用できません。入力ファイルの 1 行目に空白または特殊文字が含まれている場合は、エラーが表示されます。
コピーされた行を既存のテーブルに追加またはアペンドするには、[アペンド (Append)] ツールを使用します。
出力テーブルは dBASE、ジオデータベース、またはタブ区切りの .txt ファイルに保存できます。
構文
CopyRows_management (in_rows, out_table, {config_keyword})
パラメーター | 説明 | データ タイプ |
in_rows | コピー元のフィーチャクラス、レイヤー、テーブルまたはテーブル ビューからの行。 | Table View ; Raster Layer |
out_table | 行が書き込まれるテーブル。出力テーブルは、ジオデータベース、dBASE、またはタブ区切りファイルに保存できます。dBASE テーブルに保存するには、拡張子を .dbf にした名前を指定します。タブ区切りファイルに保存するには、拡張子を .txt にした名前を指定します。 | Table |
config_keyword (オプション) | config キーワードには、エンタープライズ ジオデータベース用のデフォルトのストレージ パラメーターを指定します。 | String |
コードのサンプル
CopyRows (行のコピー) の例 1 (Python ウィンドウ)
次の Python ウィンドウ スクリプトは、イミディエイト モードで CopyRows (行のコピー) 関数を使用する方法を示しています。
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CopyRows_management("vegtable.dbf", "C:/output/output.gdb/vegtable")
CopyRows (行のコピー) の例 2 (スタンドアロン スクリプト)
次のスタンドアロン スクリプトは、CopyRows (行のコピー) を使用してフォルダー内のテーブルをファイル ジオデータベースにコピーする方法を示しています。
# Name: CopyRows_Example2.py
# Description: Convert all dBASE tables in a folder to geodatabase tables
# Requirement: os module
# Import system modules
import arcpy
from arcpy import env
import os
# Set environment settings
env.workspace = "C:/data"
# Set local variables
outWorkspace = "c:/output/output.gdb"
# Use ListTables to generate a list of dBASE tables in the
# workspace shown above.
tableList = arcpy.ListTables()
# Execute CopyRows for each input table
for dbaseTable in tableList:
# Determine the new output feature class path and name
outTable = os.path.join(outWorkspace, dbaseTable.strip(".dbf"))
arcpy.CopyRows_management(dbaseTable, outTable)
環境
ライセンス情報
- ArcGIS Desktop Basic: はい
- ArcGIS Desktop Standard: はい
- ArcGIS Desktop Advanced: はい