迁移关系类 (数据管理)

摘要

用于将基于对象 ID 的关系类迁移到基于全局 ID 的关系类。

使用情况

  • 此工具可将基于对象 ID 的现有关系类修改为基于全局 ID 的关系类,从而满足运行时地理数据库的要求。

  • 在使用此工具之前,输入关系类参数值中使用的源要素类或表必须具有 GlobalID 字段。 同时,目标类也必须具有一个 GlobalID 字段。

  • 现有输入关系类必须基于 ObjectID 字段。 数据无法启用存档。

  • 此工具支持将版本化和非版本化的数据作为输入。

  • ArcGIS Desktop 中创建的关联要素的注记必须首先使用升级数据集工具进行升级。

  • 建议您创建数据的备份副本用作此工具的输入。

参数

标注说明数据类型
输入关系类

基于对象 ID 的关系类,将迁移到基于全局 ID 的关系类。 源要素类和目标要素类或表必须具有现有 GlobalID 字段。

Relationship Class

派生输出

标注说明数据类型
迁移的关系类

已更新的关系类。

Relationship Class

arcpy.management.MigrateRelationshipClass(in_relationship_class)
名称说明数据类型
in_relationship_class

基于对象 ID 的关系类,将迁移到基于全局 ID 的关系类。 源要素类和目标要素类或表必须具有现有 GlobalID 字段。

Relationship Class

派生输出

名称说明数据类型
out_relationship_class

已更新的关系类。

Relationship Class

代码示例

MigrateRelationshipClass 示例 1(Python 窗口)

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

arcpy.MigrateRelationshipClass_management(r'C:\Data\Relationships.gdb\OneToMany')
MigrateRelationshipClass 示例 2(独立脚本)

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

# Name: MigrateRelationshipClass_Example.py
# Description: Migrate an ObjectID-based relationship class to a GlobalID-based
#       relationship class. This script lists the ObjectID-based relationships classes
#       in a workspace, checks for GlobalIDs in the origin, then runs the tool

# Import system modules
import arcpy

# Set local variables
workspace = r'C:\Data\Relationships.gdb'

# List all of the relationship classes within the given workspace
rc_list = [c.name for c in arcpy.Describe(workspace).children if c.datatype == "RelationshipClass"]

# Build a list of relationship classes which have an OBJECTID based origin class key
rc_migrate = []
for rc in rc_list:
    rc_path = workspace + "\\" + rc
    rc_desc = arcpy.Describe(rc_path)
    for item in rc_desc.OriginClassKeys:
        if "OBJECTID" in item:
            rc_migrate.append(rc_path)

# Check that the origin feature classes have Global Ids
rc_final = []
for rel in rc_migrate:
    originfc = workspace + "\\" + arcpy.Describe(rel).originClassNames[0]
    if arcpy.ListFields(originfc,"","GlobalID"):
        rc_final.append(rel)
        print("Adding {0}  to the list to migrate. \n".format(rel.rsplit("\\",1)[1]))
    else:
        print("{0} must have Global Ids to migrate relationship class.\n".format(originfc.rsplit("\\",1)[1]))

# Pass the list of valid relationship classes into the Migrate Relationship tool
print("Passing valid relationship classes into the Migrate Relationship Class tool.\n")
for rel_class in rc_final:
    print("Migrating {0}... \n".format(rel_class.rsplit("\\",1)[1]))
    arcpy.MigrateRelationshipClass_management(rel_class)
    print(arcpy.GetMessages() + "\n")

相关主题