Delete Version (Data Management)

Summary

Deletes the specified version from the input enterprise, workgroup, or desktop geodatabase.

Usage

  • Only the version's owner can delete the version.

  • A parent version cannot be deleted until all dependent child versions are deleted.

  • Versions are not affected by changes occurring in other versions of the geodatabase.

  • Versioning tools only work with enterprise, workgroup, and desktop geodatabase data. File geodatabases do not support versioning.

  • This tool supports deleting a branch version through the version service.

Parameters

LabelExplanationData Type
Input Workspace

The database connection file to the enterprise, workgroup, or desktop geodatabase containing the version to be deleted.

For branch versioning, you can use a feature service URL (that is, https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer) or a feature layer portal item. You can also delete a branch version using a database connection file (connected to a branch versioned workspace) when connected as the geodatabase admin user (sde).

Workspace
Version Name

The name of the version to be deleted.

For branch versioning, if the input workspace is a database connection file, the name of the branch version to delete should be fully qualified (for example servicename.portaluser.versionname). If the input workspace is a feature service URL, the name of the branch version to delete should not include the service name (for example. portaluser.versionname).

String

Derived Output

LabelExplanationData Type
Updated Geodatabase

The updated input workspace.

Workspace

arcpy.management.DeleteVersion(in_workspace, version_name)
NameExplanationData Type
in_workspace

The database connection file to the enterprise, workgroup, or desktop geodatabase containing the version to be deleted. The default is the workspace defined in the Current Workspace environment.

For branch versioning, you can use a feature service URL (that is, https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer) or a feature layer portal item. You can also delete a branch version using a database connection file (connected to a branch versioned workspace) when connected as the geodatabase admin user (sde).

Workspace
version_name

The name of the version to be deleted.

For branch versioning, if the input workspace is a database connection file, the name of the branch version to delete should be fully qualified (for example servicename.portaluser.versionname). If the input workspace is a feature service URL, the name of the branch version to delete should not include the service name (for example. portaluser.versionname).

String

Derived Output

NameExplanationData Type
out_workspace

The updated input workspace.

Workspace

Code sample

DeleteVersion example 1 (stand-alone script)

The following stand-alone script demonstrates how use the DeleteVersion function to delete a traditional version.

# Description: Deletes a version

# Import system modules
import arcpy

# Set local variables
inWorkspace = "c:/Connections/whistler@gdb.sde"
versionName = "myVersion2"

# Run DeleteVersion
arcpy.management.DeleteVersion(inWorkspace, versionName)
DeleteVersion example 2 (stand-alone script)

The following stand-alone script demonstrates how use the DeleteVersion function to delete a branch version as the geodatabase administrator.

# Description: Deletes a branch version

# Import system modules
import arcpy

# Set local variables
inWorkspace = "c:/project_path/SQL_SERV.sde"
versionName = "BuildingService.portaluser.Viewer"

# Run DeleteVersion
arcpy.management.DeleteVersion(inWorkspace, versionName)
DeleteVersion example 3 (stand-alone script)

The following stand-alone script demonstrates how use the DeleteVersion function to delete a branch version using a feature service URL.

# Description: Deletes a branch version

# Import system modules
import arcpy

# Set local variables
inWorkspace = "https://myserver.mydomain.com/server/rest/services/MyService/FeatureServer"
versionName = "PORTALUSER1.newversion2"

# Run DeleteVersion
arcpy.management.DeleteVersion(inWorkspace, versionName)

Environments

Licensing information

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

Related topics