添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接

摘要

基于字段值将图层关联到另一图层或表。 支持带有栅格属性表的要素图层、表视图、子类型值图层或表和栅格图层。

关联表 参数值中的记录与输入 图层名称或表视图 参数值中的记录相匹配。 当 输入相关字段 参数值中的字段值与 输出相关字段 参数值中的字段值相等时,发生匹配。

  • 如果输入为要素类或数据集路径,则此工具将创建并返回应用了该工具结果的新图层。

  • 关联不会修改数据;关联是图层或表视图的属性。

  • 关联表中的记录可以与输入图层或表视图中的多个记录相匹配。

  • 关联表可以为地理数据库表或 dBASE 文件。 关联表不必是图层。

  • 输入必须具有对象 ID 字段。 关联表不需要包含对象 ID 字段。

  • 要保存关联以便用于另一工程,请使用 保存图层至文件 工具将图层保存到图层文件中。 这仅适用于图层;无法以此方式保存表视图。

  • 要建立永久性关联,可使用 创建关系类 工具。

  • 通过对输入图层或表视图以及关联基于的关联表中的字段建立索引,可以提高性能。 此操作可以通过 添加属性索引 工具完成。

  • 当输入图层具有关系并且选中 自动选择相关数据 属性时,输入图层上的选择也将选择相关表中的记录。

  • 参数

    标注 说明 数据类型
    图层名称或表视图

    关联表将关联到的图层或表视图。

    Mosaic Layer; Raster Layer; Table View
    输入关联字段

    关联所基于的输入图层或表视图中的主键字段。

    Field
    关联表

    要与输入图层或表视图关联的表或表视图。

    Mosaic Layer; Raster Layer; Table View
    输出关联字段

    关联表中用于匹配主键的外键字段。

    Field
    关联名称

    关联的唯一名称。

    String
    基数
    (可选)

    指定关系的基数。

    • 一对一 输入表和关联表之间将为一对一关系。 例如,输入表中的一条记录在关联表中只有一条匹配记录。
    • 一对多 输入表和关联表之间将为一对多关系。 例如,输入表中的一个记录在关联表中有多个匹配记录。 这是默认设置。
    • 多对多 输入表和关联表之间将为多对多关系。 例如,输入表中具有相同值的许多记录可以在相关表中具有多条匹配记录。
    String

    派生输出

    标注 说明 数据类型
    更新的输入图层或表视图

    已更新的输入数据集。

    Table View; Raster Layer; Mosaic Layer

    arcpy.management.AddRelate(in_layer_or_view, in_field, relate_table, relate_field, relate_name, {cardinality})
    名称 说明 数据类型
    in_layer_or_view

    关联表将关联到的图层或表视图。

    Mosaic Layer; Raster Layer; Table View
    in_field

    关联所基于的输入图层或表视图中的主键字段。

    Field
    relate_table

    要与输入图层或表视图关联的表或表视图。

    Mosaic Layer; Raster Layer; Table View
    relate_field

    关联表中用于匹配主键的外键字段。

    Field
    relate_name

    关联的唯一名称。

    String
    cardinality
    (可选)

    指定关系的基数。

    • ONE_TO_ONE 输入表和关联表之间将为一对一关系。 例如,输入表中的一条记录在关联表中只有一条匹配记录。
    • ONE_TO_MANY 输入表和关联表之间将为一对多关系。 例如,输入表中的一个记录在关联表中有多个匹配记录。 这是默认设置。
    • MANY_TO_MANY 输入表和关联表之间将为多对多关系。 例如,输入表中具有相同值的许多记录可以在相关表中具有多条匹配记录。
    String

    派生输出

    名称 说明 数据类型
    out_layer_or_view

    已更新的输入数据集。

    Table View; Raster Layer; Mosaic Layer

    代码示例

    AddRelate 示例 1( Python 窗口)

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

    import arcpy
    arcpy.management.AddRelate("Parcel", "ParcelID", "owner_table", "ParcelID", 
                               "Owner2Parcel")

    许可信息

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

    相关主题