Upgrade Dataset (Data Management)

Summary

Upgrades the schema of a mosaic dataset, network dataset, annotation dataset, dimension dataset, parcel fabric, trace network, utility network, or 3D object feature class to the current ArcGIS release. Upgrading a dataset enables it to use new functionality in the current software release.

Usage

  • Before you upgrade a dataset, create a backup of it.

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

    • When upgrading ArcGIS AllSource annotation and dimensions to ArcGIS AllSource 3.0, the Upgrade Geodatabase tool does not need to be run.
  • For utility networks, see Utility network dataset administration for additional requirements.

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

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

    • An exclusive lock must be used, 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 that are stored in an enterprise geodatabase must be unregistered as versioned prior to the upgrade.

  • In an ArcGIS Desktop 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

  • Legacy:

    ArcGIS Desktop 8.x annotation can be upgraded to ArcGIS AllSource annotation using this tool. Fields will be added to the feature class (TextString, FontName, FontStyle, and so on) and a symbol will be added to the symbol collection.

  • Once upgraded, an annotation dataset is no longer available for use in previous versions. The present version of an annotation feature class is displayed on the Source tab of the Feature Class Properties dialog box. The following table describes how annotation is supported:

    ArcGIS versionArcGIS Desktop annotationArcGIS AllSource annotation 2.xArcGIS AllSource annotation 3.x
    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.

    Not supported. Any feature class linked to it or in the same feature dataset will be read-only.

    ArcGIS AllSource

    1.x

    Read-only access.

    Not supported. Any feature class linked to it or in the same feature dataset will be read-only.

    Not supported. Any feature class linked to it or in the same feature dataset will be read-only.

    ArcGIS AllSource

    2.x

    Read-only access.

    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 AllSource 3.x

    Read-only access.

    Full read access. Partial modify and write access. It may be downgraded based on symbols and annotation properties used.

    Full read, modify, and write access.

    Consult the Companion ArcGIS AllSource and ArcGIS Enterprise versions section in the Release notes when using annotation with ArcGIS Enterprise. The ArcGIS Enterprise version needs to match or be greater than the ArcGIS AllSource version for use in GIS services. For instance, ArcGIS AllSource 3.x annotation requires ArcGIS Enterprise 11.0 or higher.

  • Once upgraded, a dimension dataset is no longer available for use in previous versions. The present version of a dimension feature class is displayed on the Source tab of the Feature Class Properties dialog box. The following table describes how annotation is supported:

    ArcGIS versionArcGIS Desktop dimensionsArcGIS AllSource dimensions 2.xArcGIS AllSource dimensions 3.x
    ArcGIS Desktop

    10.x

    Full read, modify, and write access.

    Not supported. Any feature class in the same feature dataset will be read-only.

    Not supported. Any feature class in the same feature dataset will be read-only.

    ArcGIS AllSource

    1.x

    Read-only access.

    Not supported. Any feature class in the same feature dataset will be read-only.

    Not supported. Any feature class in the same feature dataset will be read-only.

    ArcGIS AllSource

    2.x

    Read-only access.

    Full read, modify, and write access.

    Not supported. Any feature class in the same feature dataset will be read-only.

    ArcGIS AllSource 3.x

    Read-only access.

    Full read access. Partial modify and write access. It may be downgraded based on symbols and dimension properties used.

    Full read, modify, and write access.

    Consult the Companion ArcGIS AllSource and ArcGIS Enterprise versions section in the Release notes when using dimensions with ArcGIS Enterprise. The ArcGIS Enterprise version needs to match or be greater than the ArcGIS AllSource version for use in GIS services. For instance, ArcGIS AllSource 3.x dimensions require ArcGIS Enterprise 11.0 or higher.

  • If a catalog dataset created in ArcGIS Pro 3.1 is upgraded in ArcGIS Pro 3.3 or later versions, the upgraded catalog dataset is no longer available for use in ArcGIS Pro 3.1.

Parameters

LabelExplanationData 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; Catalog Layer; 3D Object Feature Layer

Derived Output

LabelExplanationData 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; Catalog Layer; 3D Object Feature Layer

arcpy.management.UpgradeDataset(in_dataset)
NameExplanationData 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; Catalog Layer; 3D Object Feature Layer

Derived Output

NameExplanationData 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; Catalog Layer; 3D Object Feature 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

Related topics