生成更新相关属性规则 (数据管理)

摘要

生成在对输入表进行更新时更新其他类中相关记录的属性规则。 该操作可基于以下一项或多项:公共设施网络关联、关系类、匹配字段和空间关系。

使用情况

  • 工具运行后,请导入属性规则并将其应用到相应数据集中。 如果数据集位于企业级地理数据库中,您必须是数据所有者才能应用输出的模板属性规则。

    了解关于属性规则导入的详细信息

  • 如果输入表参数值或搜索选项参数的目标图层值不是公共设施网络类或表,则搜索类型值不能是公共设施网络关联类型。

  • 如果输入表参数值或搜索选项参数的目标图层值是一个表,则搜索类型值不能为仅空间

  • 如果输入表参数值和搜索选项参数的目标图层值彼此不参与关系类,则搜索类型值不能为关系类

参数

标注说明数据类型
输入表

将应用新规则的表或要素类。

Table View
输出文件夹

用于保存输出的文件夹。

Folder
搜索选项

使用公共设施网络关联、关系类、匹配字段或输入类与任何目标类之间的空间关系来更新目标图层中的相关值。

搜索选项包括以下部分:

  • 目标图层 - 将应用搜索选项的图层。
  • 目标字段 - 目标图层中将由属性规则进行更新的字段。
  • 搜索类型 - 将应用于输入表和目标表的搜索类型。
  • 输入字段或值 - 将在输入类中编辑的字段或值。
  • 运算符 - 将用于关联目标字段和输入字段的方法。
  • 搜索距离 - 目标要素与输入要素之间的最大距离。 将仅更新此距离内的要素。
  • 目标匹配字段 - 目标类中链接到输入类中输入匹配字段值的外键字段。
  • 输入匹配字段 - 源类中链接到目标类中目标匹配字段值的主键字段。

搜索类型选项如下:

  • 关系类 - 将使用输入类与任何目标类之间的关系类来更新目标类中的相关值。
  • 匹配字段 - 目标类中的字段将根据匹配字段(主键或外键关系)对输入类中字段的更新进行更新。
  • 仅空间 - 目标图层中的字段将根据输入类和任何输出类中的要素之间的交叉点进行更新。
  • 已连接(UN 关联)- 将返回通过连通性关联连接到指定要素的要素。
  • 容器(UN 关联)- 将返回包含通过包含关联的指定要素的要素。
  • 内容(UN 关联)- 将返回包含通过包含关联的指定要素的要素。
  • 结构(UN 关联)- 将返回指定要素通过结构附件关联附加到的要素。
  • 已附加(UN 关联)- 将返回通过结构附件关联附加到指定要素的要素。
  • 交汇点-边(UN 关联)- 返回通过交汇点-边连通性关联与指定要素相连的要素。
  • 中跨(UN 关联)- 返回通过交汇点-边中跨连通性关联与指定要素相连的要素。

运算符选项如下:

  • 设置值 - 目标字段中的值将使用输入字段中的值进行更新
  • 串连 - 目标字段中的现有值将通过与源字段中的值进行串连来更新。 默认情况下,这些值将与连字符 (-) 进行串连。
  • 按位或 - 将使用来自源字段的传入值对目标字段中的现有值执行按位运算。 源字段和目标字段都必须是数值字段。
Value Table
表达式

用于限制参与属性规则的输入要素的 SQL 表达式。

SQL Expression

派生输出

标注说明数据类型
输出 CSV 文件

包含模板属性规则的输出 .csv 文件。

File

arcpy.management.GenerateUpdateRelatedAttributeRule(in_table, out_folder, search_options, where_clause)
名称说明数据类型
in_table

将应用新规则的表或要素类。

Table View
out_folder

用于保存输出的文件夹。

Folder
search_options
[search_options,...]

使用公共设施网络关联、关系类、匹配字段或输入类与任何目标类之间的空间关系来更新目标图层中的相关值。

搜索选项包括以下部分:

  • 目标图层 - 将应用搜索选项的图层。
  • 目标字段 - 目标图层中将由属性规则进行更新的字段。
  • 搜索类型 - 将应用于输入表和目标表的搜索类型。
  • 输入字段或值 - 将在输入类中编辑的字段或值。
  • 运算符 - 将用于关联目标字段和输入字段的方法。
  • 搜索距离 - 目标要素与输入要素之间的最大距离。 将仅更新此距离内的要素。
  • 目标匹配字段 - 目标类中链接到输入类中输入匹配字段值的外键字段。
  • 输入匹配字段 - 源类中链接到目标类中目标匹配字段值的主键字段。

搜索类型选项如下:

  • RELATIONSHIP_CLASS - 将使用输入类与任何目标类之间的关系类来更新目标类中的相关值。
  • MATCH_FIELDS - 目标类中的字段将根据匹配字段(主键或外键关系)对输入类中字段的更新进行更新。
  • SPATIAL_ONLY - 目标图层中的字段将根据输入类和任何输出类中的要素之间的交叉点进行更新。
  • UN_CONNECTED - 将返回通过连通性关联连接到指定要素的要素。
  • UN_CONTAINER - 将返回包含通过包含关联的指定要素的要素。
  • UN_CONTENT - 将返回包含通过包含关联的指定要素的要素。
  • UN_STRUCTURE - 将返回指定要素通过结构附件关联附加到的要素。
  • UN_ATTACHED - 将返回通过结构附件关联附加到指定要素的要素。
  • UN_JUNCTION_EDGE - 将返回通过交汇点-边连通性关联连接到指定要素的要素。
  • UN_MIDSPAN - 将返回通过交汇点-边中跨连通性关联连接到指定要素的要素。

运算符选项如下:

  • SET_VALUE - 目标字段中的值将使用输入字段中的值进行更新
  • CONCATENATE - 目标字段中的现有值将通过与源字段中的值进行串连来更新。 默认情况下,这些值将与连字符 (-) 进行串连。
  • BITWISE_OR - 将使用来自源字段的传入值对目标字段中的现有值执行按位运算。 源字段和目标字段都必须是数值字段。
Value Table
where_clause

用于限制参与属性规则的输入要素的 SQL 表达式。

SQL Expression

派生输出

名称说明数据类型
out_rule_csv

包含模板属性规则的输出 .csv 文件。

File

代码示例

GenerateUpdateRelatedAttributeRule 示例(Python 窗口)

以下示例演示了 GenerateUpdateRelatedAttributeRule 函数的使用过程。

import arcpy
arcpy.management.GenerateUpdateRelatedAttributeRule(
    in_table="A_Table",
    out_folder=r"C:/project/path/to/folder",
    search_options="Test Field 'Match Fields' Field 'Set Value' '20 Feet' Field_1 Field_1"
)

环境

此工具不使用任何地理处理环境。

相关主题