追加 (数据管理)

摘要

用于将多个输入数据集追加到现有目标数据集,或者可选地更新现有目标数据集。 输入数据集可以是要素类、表格、shapefile、栅格、注记或尺寸注记要素类。

要将输入数据集合并到新的输出数据集中,请使用合并工具。

插图

追加工具图示

使用情况

  • 使用该工具,可将多个数据集中的新要素或其他数据添加至现有数据集。 该工具可将点、线、面要素类、表、栅格、注记要素类或尺寸要素类追加到现有的相同类型数据集中。 例如,可以将多个表附加到现有表,或者可以将多个栅格附加到现有栅格数据集,但不能将线要素类附加到点要素类。

  • 您可以使用字段映射参数控制如何将输入数据集字段中的属性信息传输到目标数据集。 只有在指定使用字段映射协调方案差异作为方案类型参数时,才能使用字段映射参数。

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

    • 可以使用以下合并规则:first、last、join、sum、mean、median、mode、minimum、maximum、standard deviation 和 count。
    • 如果使用连接合并规则,则可指定分隔符,例如,空格、逗号、句点和短划线等。 要使用空格,请确保指针位于输入框的起始位置处,然后按一次空格键
    • 您可以使用格式选项来指定文本字段的起始和终止位置。
    • 请勿对单个输入执行标准差计算,因为数字不能被零除,因此标准差不适用于单个输入。

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

  • 向目标数据集添加要素时,此工具不会打断要素。 输入要素类和目标要素类中的所有要素都将在追加后保持原样,即使出现要素相互叠置情况也是如此。 要合并或打断要素几何,请使用联合工具。

  • 如果将字段匹配类型参数设置为输入字段必须匹配目标字段,则输入数据集的方案必须与目标数据集的方案相匹配,然后才能追加要素。

    如果将字段匹配类型参数设置为使用字段映射协调字段差异,则该方案无需匹配。 不会将与目标数据集字段不匹配的输入数据集字段映射到目标数据集,除非在字段映射参数中设置了映射。 目标数据集中未映射到输入数据集中字段的字段将包含空值。

    如果字段匹配类型参数设置为方案不匹配时跳过并警告,则输入数据集的方案必须与要追加要素的目标数据集的方案相匹配。 如果输入数据集包含与目标数据集中的字段不匹配的字段,则将忽略该输入数据集。

  • 由于输入数据集的数据被写入具有预定义方案的现有目标数据集中,因此您无法使用字段映射参数在目标数据集中添加或移除字段。

  • 您可以使用此工具在同一操作(相当于 UPSERT 数据库操作)中插入新记录并更新目标数据集中的现有记录。 可以使用用于更新的匹配字段参数指定输入数据集中要与目标数据集中的字段匹配的字段。 对于具有匹配字段值的记录,将使用输入记录中同名字段的值来更新目标记录中的任何字段。 如果选中更新几何参数,则将更新几何。

  • 如果输入要素类和目标要素类的空间参考不匹配,则输入要素类中的要素将投影到目标要素类所使用的坐标系中。

  • 此工具不会执行边匹配;不会对要素的几何进行任何调整。

  • 可将地图图层用作输入数据集参数值。 如果图层具有选定内容,则只会使用所选记录(要素或表行)。

  • 无法此工具中使用同名的多个输入图层。 相反,请使用工具对话框浏览按钮以浏览至各输入数据集值的完整路径。

  • 要使用子类型参数,目标数据集必须已定义子类型字段且已分配子类型代码。 在子类型参数中,提供子类型描述以将该子类型分配给已追加到目标数据集中的所有新数据。

  • 该工具可以直接在 Web 要素图层的后端数据存储、服务器或数据库上使用,以确保最佳性能。 对于引用地理数据库的要素服务,该工具可以与数据库连接配合使用,以执行直接将大型数据加载到基础数据库的操作。 对于 ArcGIS Enterprise 上的托管服务,您可以从要素图层项目页面或 ArcGIS REST API 使用 append 操作

    要实现 ArcGIS Online 上托管服务的最佳性能,当 supportAppend 属性为 true 时,管理员和服务所有者可以通过 ArcGIS REST API 使用此工具。 必须为非管理用户启用要素服务追加功能才能将追加工具与 ArcGIS REST API 一起使用。

参数

标注说明数据类型
输入数据集

所含数据将被追加到目标数据集的输入数据集。 输入数据集可以是点、线、面要素类、表、栅格、注记要素类或尺寸要素类。

可将表和要素类组合起来。 如果将要素类追加到表,则将传递属性,但不会移除要素。 如果将表追加到要素类中,则输入表中的行将具有空几何。

Table View; Raster Layer
目标数据集

将追加输入数据集数据的现有数据集。

Table View; Raster Layer
字段匹配类型
(可选)

指定输入数据集的方案是否必须与目标数据集的字段相匹配才能追加数据。

  • 输入字段必须与目标字段匹配输入数据集的字段必须与目标数据集的字段相匹配。 如果字段不匹配,则系统将返回一条错误。
  • 使用字段映射协调字段差异输入数据集的字段不需要与目标数据集的字段相匹配。 不会将与目标数据集字段不匹配的输入数据集字段映射到目标数据集,除非在字段映射参数中显式设置了映射。
  • 方案不匹配时跳过并警告输入数据集的字段必须与目标数据集的字段相匹配。 如果任何输入数据集包含与目标数据集不匹配的字段,则该输入数据集将被忽略,并会出现警告消息。
String
字段映射
(可选)

控制如何将输入数据集中的属性字段传输或映射到目标数据集。

仅当将字段匹配类型参数设置为使用字段映射协调字段差异时,才能使用此参数。

由于输入数据集追加到具有预定义字段的现有目标数据集,因此无法在字段映射中添加、删除或更改字段类型。 您可以为每个输出字段设置合并规则。

合并规则用于指定如何将两个或更多个输入字段的值合并或组合为一个输出值。 以下合并规则可用于确定如何用值填充输出字段。

  • First - 使用输入字段的第一个值。
  • Last - 使用输入字段的最后一个值。
  • Join - 串连(连接)输入字段的值。
  • Sum - 计算输入字段值的总和。
  • Mean - 计算输入字段值的平均值。
  • Median - 计算输入字段值的中值。
  • Mode - 使用具有最高频率的值。
  • Min - 使用所有输入字段值中的最小值。
  • Max - 使用所有输入字段值中的最大值。
  • Standard deviation - 对所有输入字段值使用标准差分类方法。
  • Count - 查找计算中所包含的记录数。

Field Mappings
子类型
(可选)

将分配给追加到目标数据集的所有新数据的子类型描述。

String
表达式
(可选)

用于选择输入数据集记录子集的 SQL 表达式。 如果指定了多个输入数据集,将使用表达式对它们进行评估。 如果没有与输入数据集表达式匹配的记录,将不会向目标追加该数据集的记录。

有关 SQL 语法的详细信息,请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考

SQL Expression
用于更新的匹配字段
(可选)

将用于匹配目标数据集的输入数据集中的字段。 如果这些字段的值相匹配,则来自输入数据集的记录将更新目标数据集的相应记录。

Value Table
更新几何
(可选)

指定如果用于更新的匹配字段参数字段值相匹配,是否将使用输入数据集中的几何来更新目标数据集中的几何。

  • 选中 - 如果用于更新的匹配字段参数字段值相匹配,则将更新目标数据集中的几何。
  • 未选中 - 将不会更新几何。 这是默认设置。
Boolean

派生输出

标注说明数据类型
更新的目标数据集

已更新的目标数据集。

Table View; Raster Layer

arcpy.management.Append(inputs, target, {schema_type}, {field_mapping}, {subtype}, {expression}, {match_fields}, {update_geometry})
名称说明数据类型
inputs
[inputs,...]

所含数据将被追加到目标数据集的输入数据集。 输入数据集可以是点、线、面要素类、表、栅格、注记要素类或尺寸要素类。

可将表和要素类组合起来。 如果将要素类追加到表,则将传递属性,但不会移除要素。 如果将表追加到要素类中,则输入表中的行将具有空几何。

Table View; Raster Layer
target

将追加输入数据集数据的现有数据集。

Table View; Raster Layer
schema_type
(可选)

指定输入数据集的方案是否必须与目标数据集的字段相匹配才能追加数据。

  • TEST输入数据集的字段必须与目标数据集的字段相匹配。 如果字段不匹配,则系统将返回一条错误。
  • NO_TEST输入数据集的字段不需要与目标数据集的字段相匹配。 不会将与目标数据集字段不匹配的输入数据集字段映射到目标数据集,除非在字段映射参数中显式设置了映射。
  • TEST_AND_SKIP输入数据集的字段必须与目标数据集的字段相匹配。 如果任何输入数据集包含与目标数据集不匹配的字段,则该输入数据集将被忽略,并会出现警告消息。
String
field_mapping
(可选)

控制如何将输入数据集中的属性字段传输或映射到目标数据集。

仅在 schema_type 参数设置为 NO_TEST 时才能使用此参数。

由于输入数据集追加到具有预定义字段的现有目标数据集,因此无法在字段映射中添加、删除或更改字段类型。 您可以为每个输出字段设置合并规则。

合并规则用于指定如何将两个或更多个输入字段的值合并或组合为一个输出值。 以下合并规则可用于确定如何用值填充输出字段。

  • First - 使用输入字段的第一个值。
  • Last - 使用输入字段的最后一个值。
  • Join - 串连(连接)输入字段的值。
  • Sum - 计算输入字段值的总和。
  • Mean - 计算输入字段值的平均值。
  • Median - 计算输入字段值的中值。
  • Mode - 使用具有最高频率的值。
  • Min - 使用所有输入字段值中的最小值。
  • Max - 使用所有输入字段值中的最大值。
  • Standard deviation - 对所有输入字段值使用标准差分类方法。
  • Count - 查找计算中所包含的记录数。

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

Field Mappings
subtype
(可选)

将分配给追加到目标数据集的所有新数据的子类型描述。

String
expression
(可选)

用于选择输入数据集记录子集的 SQL 表达式。 如果指定了多个输入数据集,将使用表达式对它们进行评估。 如果没有与输入数据集表达式匹配的记录,将不会向目标追加该数据集的记录。

有关 SQL 语法的详细信息,请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考

SQL Expression
match_fields
[match_fields,...]
(可选)

将用于匹配目标数据集的输入数据集中的字段。 如果这些字段的值相匹配,则来自输入数据集的记录将更新目标数据集的相应记录。

Value Table
update_geometry
(可选)

指定如果 match_fields 参数字段值相匹配,是否将使用输入数据集中的几何来更新目标数据集中的几何。

  • UPDATE_GEOMETRY如果 match_fields 参数字段值相匹配,则将更新目标数据集中的几何。
  • NOT_UPDATE_GEOMETRY将不会更新几何。 这是默认设置。
Boolean

派生输出

名称说明数据类型
output

已更新的目标数据集。

Table View; Raster Layer

代码示例

Append 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.Append(["north.shp", "south.shp", "east.shp", "west.shp"], 
                        "wholecity.shp", "TEST")
Append 示例 2(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用具有 match_fieldsupdate_geometry 参数的 Append 函数。

import arcpy
arcpy.env.workspace = "C:/data/zoning.gdb"
arcpy.management.Append("Zoning_update_2040", "Zoning_2020", "TEST", 
                        match_fields=[["ZONEID", "ZONEID"]], update_geometry="UPDATE_GEOMETRY")
Append 示例 3(独立脚本)

以下脚本演示了如何使用 Append 函数。

# Name: Append.py
# Description: Use the Append tool to combine several polygon feature classes

# Import system modules 
import arcpy
import os

# Set environment settings
arcpy.env.workspace = "C:/data/towns.gdb"

# Set local variables
outLocation = "C:/data/output.gdb"
outName = "MA_towns.shp"
schemaType = "NO_TEST"
fieldMappings = ""
subtype = ""

# Process: Append to an existing "amherst" polygon feature class
target = os.path.join(outLocation, "amherst")

# All polygon FCs in the workspace are MA town FCs, you want to append these
# to the target FC. The list will resemble ["amherst", "hadley", "pelham",
# "coldspring"]

fcList = arcpy.ListFeatureClasses("", "POLYGON")

# Create FieldMappings object to manage merge output fields
fieldMappings = arcpy.FieldMappings()

# Add the target table to the field mappings class to set the schema
fieldMappings.addTable(target)

# Add input fields for the town name to TOWNNAME field that matches the 
# target dataset since each input dataset has a different field name for 
# this info
fldMap = arcpy.FieldMap()
fldMap.addInputField("amherst","TOWNNAME")
fldMap.addInputField("hadley","NAME")
fldMap.addInputField("pelham","TOWN_NAME")
fldMap.addInputField("coldspring","TOWN")

# Set name of new output field "TOWNNAME"
townName = fldMap.outputField
townName.name, townName.aliasName, townName.type = "TOWNNAME", "TOWNNAME", "TEXT"
fldMap.outputField = townName

# Add output field to field mappings object
fieldMappings.addFieldMap(fldMap)

# Do the same thing for the POPULATION field
fldMap = arcpy.FieldMap()
fldMap.addInputField("amherst","POPULATION")
fldMap.addInputField("hadley","POP")
fldMap.addInputField("pelham","POP_2010")
fldMap.addInputField("coldspring","POP")

# Set name of new output field "POPULATION"
pop = fldMap.outputField
pop.name, pop.aliasName, pop.type = "POPULATION", "POPULATION", "LONG"
fldMap.outputField = pop

# Add output field to field mappings object
fieldMappings.addFieldMap(fldMap)

# Process: Append the feature classes to the target feature class
arcpy.management.Append(fcList, os.path.join(outLocation, "amherst"), schemaType, 
                        fieldMappings, subtype)

环境

特殊情况

保留全局 ID

对于追加工具而言,此环境仅适用于企业级地理数据库数据,且仅作用于拥有含唯一索引的全局 ID 字段的数据。 若全局 ID 字段不具有唯一索引,则此工具可能无法使用。 要赋予全局 ID 字段一个唯一索引,可使用添加属性索引工具。