Versionen abgleichen (Data Management)

Zusammenfassung

Gleicht eine oder mehrere Versionen mit einer Zielversion ab.

Weitere Informationen zum Abgleichen und Zurückschreiben von Versionen

Verwendung

  • Voraussetzung für den Abgleichvorgang ist, dass Sie der einzige Benutzer sind, der die Version aktuell und auch während des Abgleichvorgangs bis zum Speichern oder Zurückschreiben bearbeitet.

  • Der Vorgang des Abgleichens kann nur durchgeführt werden, wenn Sie volles Zugriffsrecht auf alle Feature-Classes haben, die in der bearbeiteten Version geändert wurden.

  • Sie können Werkzeuge zur Versionierung mit Enterprise-Geodatabases anwenden. File-Geodatabases unterstützen keine Versionierung.

  • Dieses Werkzeug unterstützt Abgleich- und Zurückschreibevorgänge von Daten, die aus einem Verzweigungs-Workspace mit aktivierten Funktionen für die Versionsverwaltung veröffentlicht wurden. Abgleich- und Zurückschreibevorgänge für die Verzweigungsversionierung über eine Geodatabase-Verbindungsdatei werden dagegen nicht unterstützt.

  • Die Geodatabase ist so aufgebaut, dass lange Transaktionen mithilfe von Versionen effizient verwaltet und unterstützt werden können.

  • Beim Abgleichen werden Unterschiede zwischen der Edit-Version und der Zielversion erkannt und als Konflikte gekennzeichnet. Sind Konflikte vorhanden, müssen Sie sie lösen.

  • Wenn der Abgleichvorgang erfolgreich mit der Option Alle Versionen abgleichen ausgeführt wurde, sind alle Versionen in der Geodatabase gleich.

  • Hinweis:

    Ab ArcGIS Enterprise 10.9.1 wird bei der Arbeit mit nach Verzweigung versionierten Datasets über einen Feature-Service, für den die Funktion "Versionsverwaltung" aktiviert ist, die asynchrone Verarbeitung für Abgleich- und Zurückschreibevorgänge genutzt. Dabei wird der Geoverarbeitungsservice "VersionManagementTools" verwendet. "VersionManagementTools" ist ein vorkonfigurierter Service im Ordner "System", mit dem asynchrone Versionsverwaltungsfunktionen unterstützt werden. Er verfügt über eine längere Timeout-Einstellung und ist Geoverarbeitungs-Tasks für die Versionsverwaltung vorbehalten.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Workspace

Die Enterprise-Geodatabase, die die abzugleichenden Versionen enthält.

Bei der Verzweigungsversionierung ist dies die Feature-Service-URL (d. h. https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer) oder das Portal-Element des Feature-Layers.

Workspace
Abgleichmodus

Bestimmt, welche Versionen abgeglichen werden, wenn das Werkzeug ausgeführt wird.

Wenn es sich bei der Eingabe um einen Verzweigungs-Workspace handelt, ist die einzig gültige Option für diesen Parameter der Abgleich aller Versionen.

  • Alle Versionen abgleichenEditierversionen werden mit der Zielversion abgeglichen. Dies ist die Standardeinstellung.
  • Nur blockierende Versionen abgleichenVersionen, die die Zielversion vom Komprimieren abhalten, werden abgeglichen. Diese Option verwendet die empfohlene Abgleichreihenfolge.
String
Zielversion
(optional)

Name einer beliebigen direkten Vorgängerversion der Editierversion, beispielsweise die Parent-Version oder die Default-Version.

In der Regel sind Bearbeitungen aus anderen Versionen enthalten, die in die Editierversion einbezogen werden sollen.

Wenn es sich bei der Eingabe um einen Verzweigungs-Workspace handelt, ist die einzig gültige Option für diesen Parameter der Abgleich mit der Default-Version.

String
Edit-Versionen
(optional)

Name der Editierversion bzw. -versionen, die mit der ausgewählten Zielversion abgeglichen werden sollen.

Es werden nur Versionen angezeigt, die eine direkte Vorgängerversion der ausgewählten Zielversion sind.

String
Sperren anfordern
(optional)

Bestimmt, ob Feature-Sperrungen angefordert werden.

Wenn es sich bei der Eingabe um einen Verzweigungs-Workspace handelt, werden während des Abgleichvorgangs keine Sperren abgerufen.

  • Aktiviert: Während des Abgleichvorgangs werden Sperren angefordert. Verwenden Sie diese Option, wenn Änderungen zurückgeschrieben werden sollen. Hiermit wird sichergestellt, dass die Zielversion in der Zeit zwischen den Abgleich- und Zurückschreibevorgängen nicht geändert wird. Dies ist die Standardeinstellung.
  • Deaktiviert: Während des Abgleichvorgangs werden keine Sperren angefordert. Dadurch ist es möglich, dass mehrere Benutzer gleichzeitig einen Abgleich ausführen. Verwenden Sie diese Option, wenn die Editierversion nicht in die Zielversion zurückgeschrieben wird, da die Möglichkeit besteht, dass die Zielversion zwischen dem Abgleich- und Zurückschreibevorgang geändert wird.
Boolean
Bei Erkennung von Konflikten abbrechen
(optional)

Legt fest, ob das Abgleichen abgebrochen wird, wenn beim Abgleichvorgang Konflikte zwischen der Zielversion und der Editierversion festgestellt werden.

  • Aktiviert: Das Abgleichen wird abgebrochen, wenn Konflikte gefunden werden.
  • Deaktiviert: Das Abgleichen wird nicht abgebrochen, wenn Konflikte gefunden werden. Dies ist die Standardeinstellung.
Boolean
Konfliktdefinition
(optional)

Gibt an, ob die für einen Konflikt erforderlichen Bedingungen nach Objekt (Zeile) oder nach Attribut (Spalte) definiert werden.

  • Nach Objekt (nach Zeile) definierte KonflikteKonflikte werden nach Objekt definiert. Alle Änderungen an derselben Zeile oder demselben Feature in der Parent- oder Child-Version führen beim Abgleich zu einem Konflikt. Dies ist die Standardeinstellung.
  • Nach Attribut (nach Spalte) definierte KonflikteKonflikte werden nach Attribut definiert. Nur Änderungen an demselben Attribut (Spalte) aus derselben Zeile oder demselben Feature in der Parent- oder Child-Version führen beim Abgleich zu einem Konflikt. Änderungen an verschiedenen Attributen haben beim Abgleich keinen Konflikt zur Folge.
String
Konfliktlösung
(optional)

Gibt an, welche Lösung bei Erkennung eines Konflikts verwendet wird.

Wenn es sich bei der Eingabe um einen Verzweigungs-Workspace handelt, werden Konflikte standardmäßig zugunsten der Editierversion gelöst.

  • Konflikte zugunsten der Zielversion lösenAlle Konflikte werden zugunsten der Zielversion gelöst. Dies ist die Standardeinstellung für die traditionelle Versionierung.
  • Konflikte zugunsten der Bearbeitungsversion lösenAlle Konflikte werden zugunsten der Editierversion gelöst. Dies ist die Standardeinstellung für die Verzweigungsversionierung.
String
Versionen nach Abgleich zurückschreiben
(optional)

Gibt an, ob die aktuelle Editiersitzung in die abgeglichene Zielversion zurückgeschrieben wird.

  • Aktiviert: Die aktuelle Editierversion wird nach dem Abgleich in die Zielversion zurückgeschrieben.
  • Deaktiviert: Die aktuelle Editierversion wird nach dem Abgleich nicht in die Zielversion zurückgeschrieben. Dies ist die Standardeinstellung.
Boolean
Versionen nach Zurückschreiben löschen
(optional)

Gibt an, ob die abgeglichene Editierversion nach dem Zurückschreiben gelöscht wird. Dieser Parameter findet nur Anwendung, wenn der Parameter Versionen nach Abgleich zurückschreiben aktiviert wurde.

  • Aktiviert: Die aktuelle Editierversion, die abgeglichen wurde, wird nach dem Zurückschreiben in die Zielversion gelöscht.
  • Deaktiviert: Die aktuelle Editierversion, die abgeglichen wurde, wird nicht gelöscht. Dies ist die Standardeinstellung.
Boolean
Versionsabgleichprotokoll
(optional)

Der Name und der Speicherort, in den die Protokolldatei geschrieben wird. Die Protokolldatei ist eine ASCII-Datei, die den Inhalt der Geoverarbeitungsmeldungen enthält.

File
Fortfahren, wenn nicht geprüfte Konflikte erkannt werden
(optional)

Gibt an, ob das Abgleichen fortgesetzt wird, wenn vor Beginn des Abgleichvorgangs bestehende ungeprüfte Konflikte erkannt werden. Wenn der Vorgang fortgesetzt wird, gehen bestehende Konflikte aus vorherigen Sitzung beim Ausführen des Werkzeugs verloren. Dieser Parameter kann nur für die Verzweigungsversionierung verwendet werden.

  • Aktiviert: Der Abgleichvorgang wird fortgesetzt, wenn ungeprüfte Konflikte erkannt werden. Dies ist die Standardeinstellung.
  • Deaktiviert: Der Abgleichvorgang wird nicht fortgesetzt, wenn ungeprüfte Konflikte erkannt werden.
Boolean
Check-Out-Replikatversionen abgleichen
(optional)

Gibt an, ob Check-Out-Replikatversionen in den Abgleichvorgang einbezogen werden. Wenn Sie im Rahmen eines Workflows für die Replikation von Geodatabases ein Check-Out-Replikat erstellen, wird in der Geodatabase eine verknüpfte Version erstellt. Mit dieser Option haben Sie in der Liste der abzugleichenden Versionen die Möglichkeit, diese Versionstypen einzubeziehen bzw. aus der Liste zu entfernen. Dieser Parameter kann für die Verzweigungsversionierung nicht verwendet werden.

  • Aktiviert: Check-Out-Replikatversionen werden in den Abgleichvorgang einbezogen. Dies ist die Standardeinstellung.
  • Deaktiviert: Check-Out-Replikatversionen werden nicht in den Abgleichvorgang einbezogen.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierter Eingabe-Workspace

Der aktualisierte Eingabe-Workspace.

Workspace

arcpy.management.ReconcileVersions(input_database, reconcile_mode, {target_version}, {edit_versions}, {acquire_locks}, {abort_if_conflicts}, {conflict_definition}, {conflict_resolution}, {with_post}, {with_delete}, {out_log}, {proceed_if_conflicts_not_reviewed}, {reconcile_checkout_versions})
NameErläuterungDatentyp
input_database

Die Enterprise-Geodatabase, die die abzugleichenden Versionen enthält. Standardmäßig wird die Geoverarbeitungsumgebung Workspace verwendet.

Bei der Verzweigungsversionierung ist dies die Feature-Service-URL (d. h. https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer).

Workspace
reconcile_mode

Bestimmt, welche Versionen abgeglichen werden, wenn das Werkzeug ausgeführt wird.

Wenn es sich bei der Eingabe um einen Verzweigungs-Workspace handelt, ist die einzig gültige Option für diesen Parameter der Abgleich aller Versionen.

  • ALL_VERSIONSEditierversionen werden mit der Zielversion abgeglichen. Dies ist die Standardeinstellung.
  • BLOCKING_VERSIONSVersionen, die die Zielversion vom Komprimieren abhalten, werden abgeglichen. Diese Option verwendet die empfohlene Abgleichreihenfolge.
String
target_version
(optional)

Name einer beliebigen direkten Vorgängerversion der Editierversion, beispielsweise die Parent-Version oder die Default-Version.

In der Regel sind Bearbeitungen aus anderen Versionen enthalten, die in die Editierversion einbezogen werden sollen.

Wenn es sich bei der Eingabe um einen Verzweigungs-Workspace handelt, ist die einzig gültige Option für diesen Parameter der Abgleich mit der Default-Version.

String
edit_versions
[edit_versions,...]
(optional)

Name der Editierversion bzw. -versionen, die mit der ausgewählten Zielversion abgeglichen werden sollen. Dies kann ein einzelner Versionsname oder eine Liste von Versionsnamen sein.

String
acquire_locks
(optional)

Bestimmt, ob Feature-Sperrungen angefordert werden.

  • LOCK_ACQUIREDWährend des Abgleichvorgangs werden Sperren angefordert. Verwenden Sie diese Option, wenn Änderungen zurückgeschrieben werden sollen. Hiermit wird sichergestellt, dass die Zielversion in der Zeit zwischen den Abgleich- und Zurückschreibevorgängen nicht geändert wird. Dies ist die Standardeinstellung.
  • NO_LOCK_ACQUIREDWährend des Abgleichvorgangs werden keine Sperren angefordert. Dadurch ist es möglich, dass mehrere Benutzer gleichzeitig einen Abgleich ausführen. Verwenden Sie diese Option, wenn die Editierversion nicht in die Zielversion zurückgeschrieben wird, da die Möglichkeit besteht, dass die Zielversion zwischen dem Abgleich- und Zurückschreibevorgang geändert wird.
Boolean
abort_if_conflicts
(optional)

Legt fest, ob das Abgleichen abgebrochen wird, wenn beim Abgleichvorgang Konflikte zwischen der Zielversion und der Editierversion festgestellt werden.

  • NO_ABORTDas Abgleichen wird nicht abgebrochen, wenn Konflikte gefunden werden. Dies ist die Standardeinstellung.
  • ABORT_CONFLICTSDas Abgleichen wird abgebrochen, wenn Konflikte gefunden werden.
Boolean
conflict_definition
(optional)

Gibt an, ob die für einen Konflikt erforderlichen Bedingungen nach Objekt (Zeile) oder nach Attribut (Spalte) definiert werden.

  • BY_OBJECTKonflikte werden nach Objekt definiert. Alle Änderungen an derselben Zeile oder demselben Feature in der Parent- oder Child-Version führen beim Abgleich zu einem Konflikt. Dies ist die Standardeinstellung.
  • BY_ATTRIBUTEKonflikte werden nach Attribut definiert. Nur Änderungen an demselben Attribut (Spalte) aus derselben Zeile oder demselben Feature in der Parent- oder Child-Version führen beim Abgleich zu einem Konflikt. Änderungen an verschiedenen Attributen haben beim Abgleich keinen Konflikt zur Folge.
String
conflict_resolution
(optional)

Gibt an, welche Lösung bei Erkennung eines Konflikts verwendet wird.

Wenn es sich bei der Eingabe um einen Verzweigungs-Workspace handelt, werden Konflikte standardmäßig zugunsten der Editierversion gelöst.

  • FAVOR_TARGET_VERSIONAlle Konflikte werden zugunsten der Zielversion gelöst. Dies ist die Standardeinstellung für die traditionelle Versionierung.
  • FAVOR_EDIT_VERSIONAlle Konflikte werden zugunsten der Editierversion gelöst. Dies ist die Standardeinstellung für die Verzweigungsversionierung.
String
with_post
(optional)

Gibt an, ob die aktuelle Editiersitzung in die abgeglichene Zielversion zurückgeschrieben wird.

  • NO_POSTDie aktuelle Editierversion wird nach dem Abgleich nicht in die Zielversion zurückgeschrieben. Dies ist die Standardeinstellung.
  • POSTDie aktuelle Editierversion wird nach dem Abgleich in die Zielversion zurückgeschrieben.
Boolean
with_delete
(optional)

Gibt an, ob die abgeglichene Editierversion nach dem Zurückschreiben gelöscht wird. Dieser Parameter findet nur Anwendung, wenn der Parameter with_post auf POST festgelegt wurde.

  • DELETE_VERSIONDie aktuelle Editierversion, die abgeglichen wurde, wird nach dem Zurückschreiben in die Zielversion gelöscht.
  • KEEP_VERSIONDie aktuelle Editierversion, die abgeglichen wurde, wird nicht gelöscht. Dies ist die Standardeinstellung.
Boolean
out_log
(optional)

Der Name und der Speicherort, in den die Protokolldatei geschrieben wird. Die Protokolldatei ist eine ASCII-Datei, die den Inhalt der Geoverarbeitungsmeldungen enthält.

File
proceed_if_conflicts_not_reviewed
(optional)

Gibt an, ob das Abgleichen fortgesetzt wird, wenn vor Beginn des Abgleichvorgangs bestehende ungeprüfte Konflikte erkannt werden. Wenn der Vorgang fortgesetzt wird, gehen bestehende Konflikte aus vorherigen Sitzung beim Ausführen des Werkzeugs verloren. Dieser Parameter kann nur für die Verzweigungsversionierung verwendet werden.

  • PROCEEDDer Abgleichvorgang wird fortgesetzt, wenn ungeprüfte Konflikte erkannt werden. Dies ist die Standardeinstellung.
  • NOT_PROCEEDDer Abgleichvorgang wird nicht fortgesetzt, wenn ungeprüfte Konflikte erkannt werden.
Boolean
reconcile_checkout_versions
(optional)

Gibt an, ob Check-Out-Replikatversionen in den Abgleichvorgang einbezogen werden. Wenn Sie im Rahmen eines Workflows für die Replikation von Geodatabases ein Check-Out-Replikat erstellen, wird in der Geodatabase eine verknüpfte Version erstellt. Mit dieser Option haben Sie in der Liste der abzugleichenden Versionen die Möglichkeit, diese Versionstypen einzubeziehen bzw. aus der Liste zu entfernen. Dieser Parameter kann für die Verzweigungsversionierung nicht verwendet werden.

  • RECONCILECheck-Out-Replikatversionen werden in den Abgleichvorgang einbezogen. Dies ist die Standardeinstellung.
  • DO_NOT_RECONCILECheck-Out-Replikatversionen werden nicht in den Abgleichvorgang einbezogen.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_workspace

Der aktualisierte Eingabe-Workspace.

Workspace

Codebeispiel

ReconcileVersions – Beispiel (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie das Werkzeug ReconcileVersions verwendet wird, um alle Versionen abzugleichen, die der in der Datenbankverbindungsdatei angegebene Benutzer besitzt.

# Name: ReconcileVersions.py
# Description: Reconciles all versions owned by a user with SDE.Default

# Import system modules
import arcpy, os

# Set workspace
workspace = 'C:/Data/connections/bender@production.sde'

# Set the workspace environment
arcpy.env.workspace = workspace

# Use a list comprehension to get a list of version names where the owner
# is the current user and make sure sde.default is not selected.
verList = [ver.name for ver in arcpy.da.ListVersions() if ver.isOwner
           == True and ver.name.lower() != 'sde.default']

arcpy.ReconcileVersions_management(workspace,
                                   "ALL_VERSIONS",
                                   "SDE.Default",
                                   verList,
                                   "LOCK_ACQUIRED",
                                   "NO_ABORT",
                                   "BY_OBJECT",
                                   "FAVOR_TARGET_VERSION",
                                   "NO_POST",
                                   "KEEP_VERSION",
                                   "c:\RecLog.txt")
print('Reconciling Complete')

Lizenzinformationen

  • Basic: Nein
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen