Summary
Upgrades the schema of a mosaic dataset, network dataset, annotation dataset, dimension dataset, parcel fabric, parcel fabric for ArcMap or utility network to the current ArcGIS release. Upgrading the dataset allows the dataset to make use of new functionality available in the current software release.
Usage
Before a dataset can be upgraded, the geodatabase in which it resides must be upgraded to the current release using the Upgrade Geodatabase tool.
Before you upgrade your dataset, be sure to create a backup.
For utility networks, see upgrade a utility network dataset for additional requirements.
When upgrading a parcel fabric dataset, the following is required:
- Upgrading a parcel fabric requires an exclusive lock, meaning that you must close any active connections to the dataset which may include stopping the parcel fabric layer service.
- The input parcel fabric must be from a database connection established as the database parcel fabric owner.
- The parcel fabric topology must be disabled.
Versioned annotation and dimension feature classes cannot be upgraded.
Once upgraded, an annotation dataset is no longer available for use in ArcMap. The following table describes how annotation is supported:
ArcGIS version ArcGIS Desktop annotation ArcGIS Pro annotation ArcGIS Desktop 10.x
Full read, modify, and write access.
Not supported. Any feature class linked to it, or in the same feature dataset, will be read-only.
ArcGIS Pro 1.x
Read-only access.
Not supported. Any feature class linked to it, or in the same feature dataset, will be read-only.
ArcGIS Pro 2.x
Read-only access.
Full read, modify, and write access.
Once upgraded, a dimension dataset is no longer available for use in ArcMap.
Syntax
UpgradeDataset(in_dataset)
| Parameter | Explanation | Data Type |
in_dataset | The dataset that will be upgraded to the current ArcGIS client release. | Parcel Fabric Layer for ArcMap; Parcel Layer; Mosaic Layer; Network Dataset Layer; Utility Network Layer; Annotation Layer; Dimension Layer |
Derived Output
| Name | Explanation | Data Type |
| out_dataset | The upgraded input dataset. | Parcel Fabric Layer for ArcMap; Parcel Layer; Mosaic Dataset; Network Dataset Layer; Utility Network Layer; Annotation Layer; Dimension Layer |
Code sample
The following Python window example demonstrates how to use the UpgradeDataset tool in immediate mode.
import arcpy
arcpy.UpgradeDataset_management("c:/Connections/city_data.sde/MontanaMD")Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes