要素类至要素类 (转换)

摘要

用于将要素类或要素图层转换为另一个要素类。

旧版本:

此工具已弃用。 此功能已由导出要素工具替代。

使用情况

  • 使用字段映射参数管理输出数据集中的字段及其内容。

    • 您可以向字段列表中添加和移除字段,重新排序字段列表,并重命名字段。
    • 输出字段的默认数据类型与其所遇到的第一个名称相同的输入字段的数据类型相同。 可以将数据类型更改为其他有效的数据类型。
    • 使用操作确定如何将一个或多个输入字段的值合并到单个输出字段中。 可用的操作包括第一个最后一个串连求和平均值中位数众数最小值最大值标准差计数
    • 当使用串连操作时,可以指定分隔符,例如逗号或其他字符。 单击分隔符文本框的开始部分以添加分隔符。
    • 单个输入值不支持标准差选项。
    • 对于文本源字段,使用分割文本按钮,可以选择从输入值中提取到输出字段的字符。 要访问分割文本按钮,需将鼠标悬停在输入字段列表中的文本字段上,然后指定起始和结束字符位置。
    • 还可以使用 Python 脚本映射字段。

  • 可用于选择要素子集的 SQL 表达式。 有关表达式参数语法的详细信息,请参阅 ArcGIS 中使用的查询表达式的 SQL 参考

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

    注:

    转换为包含子类型和域描述的 shapefile 比转换为不包含描述的 shapefile 可能需要更多时间(性能降低)。 如果输出中不需要子类型和属性域描述,请取消选中“传输字段属性域描述”环境(Python 中的 FalseNOT_TRANSFER_DOMAINS)以获得最佳性能。

参数

标注说明数据类型
输入要素

要转换的要素类或要素图层。

Feature Layer
输出位置

将创建输出要素类的位置。 该位置可以是地理数据库或文件夹。 如果输出位置为文件夹,则输出将为 shapefile。

Workspace;Feature Dataset
输出名称

输出要素类的名称。

String
表达式
(可选)

用于选择要素子集的 SQL 表达式。

SQL Expression
字段映射
(可选)

将字段及其各自属性和源字段传输到输出数据集中。 默认情况下,输出包括来自输入数据集的所有字段。

使用字段映射来添加、删除、重命名和重新排序字段,以及更改其他字段属性。

字段映射还可以用于将两个或多个输入字段的值合并为单个输出字段。

Field Mappings
配置关键字
(可选)

指定关系数据库管理系统 (RDBMS) 中的地理数据库的默认存储参数(配置)。此设置仅在使用企业级地理数据库表时可用。

配置关键字由数据库管理员进行设置。

String

派生输出

标注说明数据类型
输出要素类

输出要素类。

Feature Class

arcpy.conversion.FeatureClassToFeatureClass(in_features, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})
名称说明数据类型
in_features

要转换的要素类或要素图层。

Feature Layer
out_path

将创建输出要素类的位置。 该位置可以是地理数据库或文件夹。 如果输出位置为文件夹,则输出将为 shapefile。

Workspace;Feature Dataset
out_name

输出要素类的名称。

String
where_clause
(可选)

用于选择要素子集的 SQL 表达式。有关 SQL 语法的详细信息,请参阅帮助主题在 ArcGIS 中使用的查询表达式的 SQL 参考

SQL Expression
field_mapping
(可选)

将字段及其各自属性和源字段传输到输出数据集中。 默认情况下,输出包括来自输入数据集的所有字段。

使用字段映射来添加、删除、重命名和重新排序字段,以及更改其他字段属性。

字段映射还可以用于将两个或多个输入字段的值合并为单个输出字段。

Python 中,使用 FieldMappings 类来定义此参数。

Field Mappings
config_keyword
(可选)

指定关系数据库管理系统 (RDBMS) 中的地理数据库的默认存储参数(配置)。此设置仅在使用企业级地理数据库表时可用。

配置关键字由数据库管理员进行设置。

String

派生输出

名称说明数据类型
out_feature_class

输出要素类。

Feature Class

代码示例

FeatureClassToFeatureClass 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 FeatureClassToFeatureClass 函数。

import arcpy
arcpy.env.workspace = "C:/data/GreenvalleyDB.gdb/Public Buildings"
arcpy.conversion.FeatureClassToFeatureClass("buildings_point", 
                                            "C:/output/output.gdb", 
                                            "buildings_point")
FeatureClassToFeatureClass 示例 2(独立脚本)

以下独立脚本演示了如何使用 FeatureClassToFeatureClass 函数。

# Name: FeatureClassToFeatureClass_Example2.py
# Description: Use FeatureClassToFeatureClass with an expression to create a subset
#  of the original feature class.  
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/GreenvalleyDB.gdb/Public Buildings"
 
# Set local variables
inFeatures = "buildings_point"
outLocation = "C:/output/output.gdb"
outFeatureClass = "postoffices"
delimitedField = arcpy.AddFieldDelimiters(arcpy.env.workspace, "NAME")
expression = delimitedField + " = 'Post Office'"
 
# Run FeatureClassToFeatureClass
arcpy.conversion.FeatureClassToFeatureClass(inFeatures, outLocation, 
                                            outFeatureClass, expression)