Upgrade Dataset (Data Management)

Summary

Upgrades the schema of a mosaic dataset, network dataset, annotation dataset, dimension dataset, parcel fabric, parcel fabric for ArcMap, trace network, or utility network to the current ArcGIS release. Upgrading the dataset allows the dataset to use new functionality in the current software release.

Usage

• Use the Upgrade Geodatabase tool to upgrade the geodatabase to the current release before running this tool to upgrade any dataset except a trace network or utility network.

• Before you upgrade a dataset, create a backup.

• For utility networks, see upgrade a utility network dataset for additional requirements.

• For trace networks, see Trace network dataset administration for additional requirements.

• When upgrading a parcel fabric dataset, the following is required:

  • An exclusive lock is required, meaning that you must close 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.

• Versioned annotation and dimension feature classes cannot be upgraded.

• In an annotation feature class, graphics that are not text graphics are not supported by the upgrade process and will be deleted. A list of their OIDs will be created and included in the tool's messages.

  Learn more about moving the graphics out of the annotation feature class

• 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.

Parameters

Dialog

Label	Explanation	Data Type
Dataset to upgrade	The dataset that will be upgraded to the current ArcGIS client release.	Parcel Fabric Layer for ArcMap; Parcel Layer; Mosaic Layer; Network Dataset Layer; Trace Network Layer; Utility Network Layer; Annotation Layer; Dimension Layer

Derived Output

Label	Explanation	Data Type
Upgraded Dataset	The upgraded input dataset.	Parcel Fabric Layer for ArcMap; Parcel Layer; Mosaic Dataset; Network Dataset Layer; Trace Network Layer; Utility Network Layer; Annotation Layer; Dimension Layer

Python

arcpy.management.UpgradeDataset(in_dataset)

Name	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; Trace Network 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; Trace Network Layer; Utility Network Layer; Annotation Layer; Dimension Layer

Code sample

UpgradeDataset example 1 (Python window)

The following Python window example demonstrates how to use the UpgradeDataset function in immediate mode.

import arcpy
arcpy.UpgradeDataset_management("c:/Connections/city_data.sde/MontanaMD")

Environments

Current Workspace

Licensing information

• Basic: Yes
• Standard: Yes
• Advanced: Yes