合并图层 (GeoAnalytics Server 工具)

汇总

合并要素图层以创建单个输出图层。

旧版本：

即将在 ArcGIS Enterprise 中弃用 ArcGIS GeoAnalytics Server 扩展模块。 GeoAnalytics Server 的最终版本已随 ArcGIS Enterprise 11.3 一同发布。可通过 ArcGIS Enterprise 11.3 及较早版本获取此地理处理工具。

工具要求两个输入具有相同的几何类型（点、线或面），或者均为表。如果一个图层上启用了时间，则另一个图层上也必须启用了时间，并且具有相同的时间类型（时刻或间隔）。结果将始终包含输入图层中的所有字段。默认情况下，将包含合并图层中的所有字段，或者可以指定自定义合并规则以定义生成的方案。以下为示例：

您拥有三个分别代表英格兰、威尔士和苏格兰行政边界的图层，并希望将其合并为一个代表大不列颠的单一图层。您可以使用合并图层来合并区域，并保留每个区域中的所有字段。
您拥有两个图层，其中包含连续乡镇的宗地信息。您希望将它们合并为单个图层，仅保留两个图层中名称和类型均相同的字段。

插图

用法

两个输入必须具有相同的几何类型（点、线或面），或者均为表。
两个输入必须具有相同的时间类型（时刻或间隔），或者均未启用时间。

默认情况下，两个输入的所有字段都会复制到输出。（可选）可重命名、移除合并图层中的字段或将其与输入图层相匹配。


操作	描述	示例
重命名	字段将在输出中重命名。将显示一个文本框，可在其中指定新名称。	您想要合并两个图层，并且每个图层都具有一个名为 `COUNT` 的字段。此字段在一个图层中表示个体计数，但在另一个图层中表示家庭计数。默认情况下，两个 `COUNT` 字段会合并，因为它们具有匹配的字段名称。使用重命名，可将合并图层中该字段的名称更改为 `MERGE_COUNT` 以保持结果图层中的两个字段分开。
移除	字段将从输出中移除。	您想要合并两个图层，但不想保留合并图层中的某些字段，例如 `OBJECTID`。使用移除可以阻止将这些字段写入结果图层并仅保留感兴趣的字段。
匹配	字段名保持不变。待合并图层的字段值将复制到匹配的输出字段。	您想要合并两个调查结果表格图层。输入图层具有一个名为 `Name` 的字段，其中包含调查参与者的姓名。合并图层中的等效字段名为 `Participant`。使用匹配可表明这些字段是等效的，两者在结果图层中将合并为一个名为 `Name` 的字段。

如果输入图层和合并图层包含名称匹配但字段类型不匹配的字段，则除非两个字段类型可以成功合并，否则该工具将运行失败。如果输入字段是字符串字段且合并字段是数值字段，则这些字段将合并为输出图层中的单个字符串字段。如果输入字段是双精度字段且合并字段是数值字段，则这些字段将合并为输出图层中的单个双精度字段。在所有其他情况下，合并属性必须用于重命名或移除任一匹配字段才能运行该工具。
您可以执行以下一项或多项操作来提高合并图层工具的性能：
- 设置范围环境，以便仅分析感兴趣的数据。
- 使用与分析运行位置同属本地的数据。
该地理处理工具由 ArcGIS GeoAnalytics Server 提供支持。分析将在 GeoAnalytics Server 上完成，且结果将存储在 ArcGIS Enterprise 的内容中。
运行 GeoAnalytics Server 工具时，分析将在 GeoAnalytics Server 上完成。要获得最佳性能，请通过在 ArcGIS Enterprise 门户上托管的要素图层或通过大数据文件共享，使 GeoAnalytics Server 可以访问数据。非 GeoAnalytics Server 本地的数据，将在分析开始前移动至 GeoAnalytics Server。这意味着运行工具需要更长时间，并且在某些情况下，从 ArcGIS Pro 到 GeoAnalytics Server 移动数据可能会失败。失败的阈值取决于网络速度，以及数据的大小和复杂性。建议您始终共享数据或创建大数据文件共享。

了解有关将数据共享至您的门户的详细信息

了解有关通过 Server Manager 创建大数据文件共享的详细信息

标注	说明	数据类型
输入图层	将与合并图层进行合并的点、线或面要素或者表格。	Record Set
合并图层	将与输入图层进行合并的点、线或面要素或者表格。合并图层必须包含与输入图层相同的要素类型和时间类型。	Record Set
输出名称	输出要素服务的名称。	String
合并属性（可选）	用于描述将如何修改合并图层中的字段并将其与输入图层中的字段相匹配的值列表。输入图层中的所有字段将写入输出图层。如果未定义合并属性，合并图层中的所有字段将写入输出图层。如果某个字段存在于一个图层中但不存在于另一个图层中，则输出图层将仍包含这两个字段。对于不含该字段的输入要素，输出字段中将包含空值。例如，如果输入图层中含有名为 `TYPE` 的字段，但合并图层中不含有 `TYPE`，则输出图层中将含有 `TYPE`，但从合并图层复制的所有要素的该字段值均将为空。您可以使用以下合并类型，控制合并图层中的字段写入输出图层的方式。值表列： Merge field—Fields from the merge layer. Action—How the field on the merge layer is written to the output. Remove—The merge layer field will be removed from the output layer. Rename—The merge layer field will be renamed in the output. You cannot rename a field from the merge layer to a field from the input layer. To make field names equivalent, use the match option. Match—The merge layer field is renamed and matched to a field from the input layer. For example, the input layer has a field named `CODE` and the merge layer has a field named `STATUS`. You can match `STATUS` to `CODE`, and the output will contain the `CODE` field with values of the `STATUS` field used for features copied from the merge layer. Type casting is supported for numeric values. Matching numeric fields to string fields is not supported. Input Field—The input layer field to match to, or the name to give, the merge field when renaming.	Value Table
数据存储（可选）	指定将用于存储输出的 ArcGIS Data Store。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。时空大数据存储—输出将存储在时空大数据存储中。这是默认设置。关系数据存储—输出将存储在关系数据存储中。	String

派生输出

标注	说明	数据类型
输出	包含来自输入图层和合并图层的合并要素和属性的输出图层。	Record Set

arcpy.geoanalytics.MergeLayers(input_layer, merge_layer, output_name, {merging_attributes}, {data_store})

名称	说明	数据类型
input_layer	将与合并图层进行合并的点、线或面要素或者表格。	Record Set
merge_layer	将与输入图层进行合并的点、线或面要素或者表格。合并图层必须包含与输入图层相同的要素类型和时间类型。	Record Set
output_name	输出要素服务的名称。	String
merging_attributes [[Merge Field, Action, Input Field],...] （可选）	用于描述将如何修改合并图层中的字段并将其与输入图层中的字段相匹配的值列表。输入图层中的所有字段将写入输出图层。如果未定义合并属性，合并图层中的所有字段将写入输出图层。如果某个字段存在于一个图层中但不存在于另一个图层中，则输出图层将仍包含这两个字段。对于不含该字段的输入要素，输出字段中将包含空值。例如，如果输入图层中含有名为 `TYPE` 的字段，但合并图层中不含有 `TYPE`，则输出图层中将含有 `TYPE`，但从合并图层复制的所有要素的该字段值均将为空。您可以使用以下合并类型，控制合并图层中的字段写入输出图层的方式。值表列： `Merge field`—Fields from the merge layer. `Action`—How the field on the merge layer is written to the output. `Remove`—The merge layer field will be removed from the output layer. `Rename`—The merge layer field will be renamed in the output. You cannot rename a field from the merge layer to a field from the input layer. To make field names equivalent, use the match option. `Match`—The merge layer field is renamed and matched to a field from the input layer. For example, the input layer has a field named `CODE` and the merge layer has a field named `STATUS`. You can match `STATUS` to `CODE`, and the output will contain the `CODE` field with values of the `STATUS` field used for features copied from the merge layer. Type casting is supported for numeric values. Matching numeric fields to string fields is not supported. `Input Field`—The input layer field to match to, or the name to give, the merge field when renaming.	Value Table
data_store （可选）	指定将用于存储输出的 ArcGIS Data Store。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。 `SPATIOTEMPORAL_DATA_STORE`—输出将存储在时空大数据存储中。这是默认设置。 `RELATIONAL_DATA_STORE`—输出将存储在关系数据存储中。	String

派生输出

名称	说明	数据类型
output	包含来自输入图层和合并图层的合并要素和属性的输出图层。	Record Set

代码示例

MergeLayers 示例（Python 窗口）

下面的 Python 窗口脚本演示了如何使用 MergeLayers 工具。

#-------------------------------------------------------------------------------
# Name: MergeLayers.py
# Description: Merge two layers containing parcel information.
#
# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inputFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/parcels_west/FeatureServer/0"
mergeFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/east_parcels/FeatureServer/0"
mergingAttributes = [["CODE", "MATCH", "ID"], ["globalid", "REMOVE"]]
outFS = "all_parcels"
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run Merge Layers
arcpy.geoanalytics.MergeLayers(inputFeatures, mergeFeatures, outFS,
                               mergingAttributes, dataStore)

环境

输出坐标系, 范围, 当前工作空间

特殊情况

输出坐标系: The coordinate system that will be used for analysis. Analysis will be completed in the input coordinate system unless specified by this parameter. For GeoAnalytics Tools, final results will be stored in the spatiotemporal data store in WGS84.

许可信息

基本: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.7
标准: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.7
高级: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.7

合并图层 (GeoAnalytics Server 工具)

汇总

旧版本：

插图

用法

参数

派生输出

环境

特殊情况

许可信息

相关主题