描述
将表格、表视图、要素图层、要素类或带有属性表的栅格的行导出到新的地理数据库、.csv、.txt 或 .dbf 表中。
使用方法
此工具支持以下表格式作为输入:
- 地理数据库
- dBASE (.dbf)
- 逗号分隔值(.csv 或 .txt)
- Microsoft Excel 工作表(.xls 或 .xlsx)
- 信息
- VPF
- OLE 数据库
- 内存型表视图
对于文件输入(.csv 或 .txt),输入文件的第一行将用作输出表上的字段名称。字段名称不能包含空格或特殊字符(如 $ 或 *),如果输入文件的第一行包含空格或特殊字符,您将收到一条错误消息。
您可以使用字段映射来控制输出数据集中所有字段以及各字段中的内容。
- 可以通过单击字段名称并将其拖动到首选位置来修改字段顺序。
- 输出字段的数据类型将默认为与其所遇到的第一个名称相同的输入字段的数据类型相同。可以随时手动将该数据类型更改为任意有效的数据类型。
- 可用的“合并规则”有很多:first、last、join、sum、mean、median、mode、minimum、maximum、standard deviation 和 count。
- 如果使用 Join 合并规则,则可自行指定分隔符,例如,空格、逗号、句点和短划线等。如果想要使用空格,请确保鼠标指针位于输入框的起始位置处,然后单击空格键。
- 您可以使用格式选项来指定文本字段的起始和终止位置。
- 不应对单个输入执行标准差计算,因为数字不能被零除,因此标准差不适用于单个输入。
将包含子类型或属性域的地理数据库转换为 dBASE 表时,子类型和属性域代码以及描述都将包括在输出中。使用传送字段属性域描述地理处理环境控制此行为。默认情况下,只有属性域和子类型代码才会被包含在输出中,描述不会被包含在输出中。
语法
arcpy.conversion.TableToTable(in_rows, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})
参数 | 说明 | 数据类型 |
in_rows | 要导出到新表格的输入表。 | Table View; Raster Layer |
out_path | 写入输出表的目标位置。 | Workspace; Feature Dataset |
out_name | 输出表的名称。 如果输出位置为文件夹,则需要包含扩展名,例如 .csv、.txt 或 .dbf,以将表格导出为该格式。如果输出位置为地理数据库,则无需指定扩展名。 | String |
where_clause (可选) | 用于选择记录子集的 SQL 表达式。了解有关 SQL 查询表达式的详细信息 | SQL Expression |
field_mapping (可选) | 从输入表中选择的字段和字段内容。您可添加、重命名或删除输出字段,还可设置诸如数据类型和合并规则等属性。 针对该参数,您可以使用 ArcPy 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(独立 Python 脚本)
以下独立脚本演示了如何使用 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)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是