将镶嵌数据集、网络数据集、注记数据集、尺寸数据集、宗地结构、追踪网络、公共设施网络或 3D 对象要素类的方案升级到 ArcGIS 的当前版本。 通过升级数据集，可使其能够使用当前软件版本中的新增功能。
在升级数据集之前，请创建数据集的备份。
先使用升级地理数据库工具将地理数据库升级到当前版本，然后再运行此工具，以升级除追踪网络或公共设施网络之外的任何数据集。
有关公共设施网络的其他要求，请参阅公共设施网络数据集管理。
有关追踪网络的其他要求，请参阅追踪网络数据集管理。
升级宗地结构数据集时，需要以下内容：
在升级之前，存储在企业地理数据库中的版本化注记和尺寸要素类必须已取消注册为版本。
在 ArcGIS Desktop 注记要素类中，升级过程不支持非文本图形类型的图形，它们将被删除。 将创建其 OID 列表，并将该列表包含在该工具的消息中。
可以使用此工具将 ArcGIS Desktop 8.x 注记升级为 ArcGIS Pro 注记。 字段将被添加到要素类（TextString、FontName、FontStyle 等），符号将被添加到符号集合。
升级后，注记数据集将不再可用于之前的版本。 在要素类属性对话框的源选项卡中显示了注记要素类的当前版本。 下表描述支持注记的方式：
| ArcGIS 版本 | ArcGIS Desktop 注记 | ArcGIS Pro 注记 2.x | ArcGIS Pro 注记 3.x |
|---|---|---|---|
| ArcGIS Desktop 10.x | 完全读取、修改和写入权限。 | 不支持。 任何与它相关联的或与它处于同一要素数据集中的要素类都将是只读的。 | 不支持。 任何与它相关联的或与它处于同一要素数据集中的要素类都将是只读的。 |
| ArcGIS Pro 1.x | 只读权限。 | 不支持。 任何与它相关联的或与它处于同一要素数据集中的要素类都将是只读的。 | 不支持。 任何与它相关联的或与它处于同一要素数据集中的要素类都将是只读的。 |
| ArcGIS Pro 2.x | 只读权限。 | 完全读取、修改和写入权限。 | 不支持。 任何与它相关联的或与它处于同一要素数据集中的要素类都将是只读的。 |
ArcGIS Pro 3.x | 只读权限。 | 完全读取权限。 部分修改和写入权限。 它可能会根据使用的符号和注记属性进行降级。 | 完全读取、修改和写入权限。 |
升级后，尺寸数据集将不再可用于之前的版本。
在要素类属性对话框的源选项卡中显示了尺寸要素类的当前版本。
如果在 ArcGIS Pro 3.1 中创建的目录数据集在 ArcGIS Pro 3.2 或更高版本中进行升级，则升级后的目录数据集将无法继续在 ArcGIS Pro 3.1 中使用。
| 标注 | 说明 | 数据类型 |
要升级的数据集 | 将升级到当前 ArcGIS 客户端版本的数据集。 | Parcel Fabric Layer for ArcMap; Parcel Layer; Mosaic Layer; Network Dataset Layer; Trace Network Layer; Utility Network Layer; Annotation Layer; Dimension Layer; Catalog Layer; 3D Object Feature Layer |
| 标注 | 说明 | 数据类型 |
| 升级的数据集 | 已升级的输入数据集。 | Parcel Fabric Layer for ArcMap; Parcel Layer; Mosaic Dataset; Network Dataset Layer; Trace Network Layer; Utility Network Layer; Annotation Layer; Dimension Layer; Catalog Layer; 3D Object Feature Layer |
arcpy.management.UpgradeDataset(in_dataset)
| 名称 | 说明 | 数据类型 |
in_dataset | 将升级到当前 ArcGIS 客户端版本的数据集。 | Parcel Fabric Layer for ArcMap; Parcel Layer; Mosaic Layer; Network Dataset Layer; Trace Network Layer; Utility Network Layer; Annotation Layer; Dimension Layer; Catalog Layer; 3D Object Feature Layer |
| 名称 | 说明 | 数据类型 |
| out_dataset | 已升级的输入数据集。 | Parcel Fabric Layer for ArcMap; Parcel Layer; Mosaic Dataset; Network Dataset Layer; Trace Network Layer; Utility Network Layer; Annotation Layer; Dimension Layer; Catalog Layer; 3D Object Feature Layer |
以下 Python 窗口示例演示了如何在即时模式下使用 UpgradeDataset 函数。
import arcpy
arcpy.UpgradeDataset_management("c:/Connections/city_data.sde/MontanaMD")