表至表 (转换)

摘要

可将表的行导出到不同表中。

使用情况

• 该工具将表、表视图、要素类、要素图层、分隔文件或具有属性表的栅格的行复制到新的地理数据库或 dBASE 表或分隔文件。

• 此工具支持将以下表格式作为输入：

  • 地理数据库
  • dBASE (.dbf)
  • Microsoft Excel 工作表（.xls 和 .xlsx）
  • 基于内存的表
  • 分割文件
    • 逗号分隔的文件（.csv、.txt 和 .asc）
    • 制表符分隔的文件（.tsv 和 .tab）
    • 竖线分隔的文件（.psv）

  对于分隔文件来说，输入文件的第一行将用作输出表上的字段名称。 字段名称不能包含空格或特殊字符（如 $ 或 *），如果输入文件的第一行包含空格或特殊字符，将出现一条错误消息。

• 如果输出位置参数值不为地理数据库，则不会包含 BLOB 或栅格字段。 GlobalID 字段将转换为文本字段。

• 该工具可用于通过将以下文件扩展名之一添加到文件夹工作区中的输出名称来输出带分隔符的文件：

  • 逗号分隔的文件（.csv、.txt 或 .asc）
  • 制表符分隔的文件（.tsv 或 .tab）
  • 竖线分隔的文件（.psv）

• 要管理输出数据集中的字段和这些字段的内容，请使用字段映射参数。

  • 要更改字段顺序，请选择一个字段名称并将其拖动到新位置。
  • 输出字段的默认数据类型与其所遇到的第一个名称相同的输入字段的数据类型相同。 您可以随时将该数据类型手动更改为其他任何有效的数据类型。
  • 可以使用以下合并规则：first、last、join、sum、mean、median、mode、minimum、maximum、standard deviation 和 count。
  • 如果使用连接合并规则，则可指定分隔符，例如，空格、逗号、句点和短划线等。 要使用空格，请确保指针位于输入框的起始位置处，然后按一次空格键。
  • 您可以使用格式选项来指定文本字段的起始和终止位置。
  • 请勿对单个输入执行标准差计算，因为数字不能被零除，因此标准差不适用于单个输入。

  了解有关在脚本中映射字段的详细信息

• 将包含子类型或域的地理数据库数据转换为 dBASE 表时，子类型和域代码以及描述都将包含在输出中。 使用传送字段属性域描述地理处理环境控制此行为。 默认情况下，只有属性域和子类型代码才会被包含在输出中，描述不会被包含在输出中。

  注：

  与没有描述相比，转换为带有子类型和域描述的 dBASE 表可能需要更多时间（性能更慢）。 如果在 dBASE 表输出中不需要子类型和属性域描述，则建议取消选中传送字段属性域描述环境的默认行为以实现最佳性能。

参数

对话框

标注	说明	数据类型
输入行	要导出到新表格的输入表。	Table View; Raster Layer
输出位置	将写入输出表的目标位置。	Workspace
输出名称	输出表的名称。 如果输出位置为文件夹，则需要包含扩展名，例如 .csv、.txt 或 .dbf，以将表格导出为该格式。 如果输出位置为地理数据库，则无需指定扩展名。	String
表达式 (可选)	用于选择记录子集的 SQL 表达式。	SQL Expression
字段映射 (可选)	输出中将包括的具有相应字段属性和源字段的属性字段。 默认情况下，将包括输入的所有字段。 可以添加、删除、重命名和重新排序字段，且可以更改其属性。 合并规则用于指定如何将两个或更多个输入字段的值合并或组合为一个输出值。 有多种合并规则可用于确定如何用值填充输出字段。 First - 使用输入字段的第一个值。 Last - 使用输入字段的最后一个值。 Join - 串连（连接）输入字段的值。 Sum - 计算输入字段值的总和。 Mean - 计算输入字段值的平均值。 Median - 计算输入字段值的中值。 Mode - 使用具有最高频率的值。 Min - 使用所有输入字段值中的最小值。 Max - 使用所有输入字段值中的最大值。 Standard deviation - 对所有输入字段值使用标准差分类方法。 Count - 查找计算中所包含的记录数。	Field Mappings
配置关键字 (可选)	指定关系数据库管理系统 (RDBMS) 中的地理数据库的默认存储参数（配置）。此设置仅在使用企业级地理数据库表时可用。 配置关键字由数据库管理员进行设置。 了解有关配置关键字的详细信息	String

派生输出

标注	说明	数据类型
输出表	输出表。	Table

Python

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 (可选)	输出中将包括的具有相应字段属性和源字段的属性字段。 默认情况下，将包括输入的所有字段。 可以添加、删除、重命名和重新排序字段，且可以更改其属性。 合并规则用于指定如何将两个或更多个输入字段的值合并或组合为一个输出值。 有多种合并规则可用于确定如何用值填充输出字段。 First - 使用输入字段的第一个值。 Last - 使用输入字段的最后一个值。 Join - 串连（连接）输入字段的值。 Sum - 计算输入字段值的总和。 Mean - 计算输入字段值的平均值。 Median - 计算输入字段值的中值。 Mode - 使用具有最高频率的值。 Min - 使用所有输入字段值中的最小值。 Max - 使用所有输入字段值中的最大值。 Standard deviation - 对所有输入字段值使用标准差分类方法。 Count - 查找计算中所包含的记录数。 在 Python 中，您可使用 FieldMappings 类来定义此参数。	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)

环境

当前工作空间, 输出配置关键字, 维护附件, 临时工作空间, 传送字段属性域描述, 范围, 限定的字段名, 保留全局 ID

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是