Help

Alter Version

Summary

The Alter Version tool allows you to change the geodatabase version's name, description, and access permissions.

Usage

  • Versioning tools only work with enterprise, workgroup, and desktop geodatabase data. Personal and file geodatabases do not support versioning.
  • Versions are not affected by changes occurring in other versions of the geodatabase.
  • A version's permission can only be changed by the version owner.

Syntax

AlterVersion_management (in_workspace, in_version, {name}, {description}, {access})
ParameterExplanationData Type
in_workspace

The database connection file to the enterprise, workgroup, or desktop geodatabase where the version to be altered is located. The default is to use the workspace defined in the Current Workspace environment.

Workspace
in_version

The name of the version to be altered.

String
name
(Optional)

If you are changing the version name, enter the new name for the version.

String
description
(Optional)

If you are changing the version description, enter the new description for the version.

String
access
(Optional)

Specify the access permission you want to set for the version. The following values are supported:

  • PRIVATE —Only the owner may view the version and modify available feature classes. This is the default.
  • PUBLIC — Any user may view the version and modify available feature classes.
  • PROTECTED —Any user may view the version, but only the owner may modify available feature classes.
String

Code sample

AlterVersion example:

The following stand-alone Python script uses the AlterVersion geoprocessing tool to alter a version. 

# Name: AlterVersion_Example.py
# Description: Changes the name of a version

# Import system modules
import arcpy

# Set local variables
inWorkspace = "c:/ConnectionFiles/ninefour@gdb.sde"
versionName = "myVersion"
newName = "myVersion2"

# Execute AlterVersion
arcpy.AlterVersion_management(inWorkspace, versionName, newName, "#", "PUBLIC")

Environments

Licensing information

  • ArcGIS for Desktop Basic: No
  • ArcGIS for Desktop Standard: Yes
  • ArcGIS for Desktop Advanced: Yes

Related topics