Versionsverwaltung für Code

In diesem Dokument erfahren Sie, wie Sie mit der Versionsverwaltung in Dataform die Entwicklung im Blick behalten.

Dataform verfolgt mithilfe von Git jede Änderung, die an den Dateien in einem Repository vorgenommen wurde.

In einem Dataform-Repository interagieren Sie direkt mit dem Git-Repository.

In einem verbundenen Repository interagieren Sie mit dem Tracking-Zweig des Remote-Repositorys, das Sie beim Verbinden des Repositorys konfiguriert haben.

Dataform zeigt Optionen zur Versionsverwaltung basierend auf dem Status der Änderungen in Ihrem Entwicklungsarbeitsbereich an. Dataform zeigt die Commit-Option beispielsweise nur dann an, wenn in Ihrem Arbeitsbereich lokale Änderungen ohne Commit vorhanden sind. Wenn die Dateien in Ihrem Arbeitsbereich eine exakte Kopie Ihres Standard- oder Tracking-Zweigs sind, zeigt Dataform den Status Arbeitsbereich ist auf dem neuesten Stand an.

Dataform zeigt die folgenden Optionen zur Versionsverwaltung an:

Commit für X Änderung(en) durchführen
Commit für die Anzahl der lokalen Änderungen von X in Ihrem Arbeitsbereich oder für ausgewählte geänderte Dateien durchführen.
An Standardzweig übertragen
Übertragen Sie die per Commit durchgeführten Änderungen per Push an Ihren Standardzweig. Diese Option ist in einem Dataform-Repository verfügbar, wenn in Ihrem Arbeitsbereich keine Änderungen ohne Commit vorhanden sind.
Zu your-branch-name übertragen
Übertragen Sie die übernommenen Änderungen auf your-branch-name. Diese Option ist in einem Repository verfügbar, das mit einem Git-Repository eines Drittanbieters verbunden ist, wenn in Ihrem Arbeitsbereich keine Änderungen ohne Commit vorhanden sind.
Aus Standardzweig abrufen
Aktualisieren Sie Ihre Arbeitsbereiche mit den letzten Änderungen aus Ihrem Standardzweig. Diese Option ist in einem Dataform-Repository verfügbar, wenn Sie in Ihrem Arbeitsbereich keine Änderungen ohne Commit oder ohne Push mit Commit haben.
Aus your-branch-name abrufen
Aktualisieren Sie Ihren Arbeitsbereich mit den letzten Änderungen von your-branch-name. Diese Option ist in einem Repository verfügbar, das mit einem Git-Repository eines Drittanbieters verbunden ist, wenn in Ihrem Arbeitsbereich keine Änderungen ohne Commit oder ohne Push mit Commit gespeichert sind.
Letzten Commit wiederherstellen
Stellen Sie die Dateien in Ihrem Arbeitsbereich auf den Status Ihres letzten Commits wieder her.

Hinweise

  1. Wählen Sie Repository erstellen aus.
  2. Optional: Repository mit einem Git-Repository eines Drittanbieters verbinden
  3. Wählen Sie Entwicklungsarbeitsbereich erstellen aus.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Dataform Editor (roles/dataform.editor) für Arbeitsbereiche zu gewähren, um die Berechtigungen zu erhalten, die Sie zur Verwendung der Versionsverwaltung in Dataform benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Änderungen abrufen

Wenn Ihr Entwicklungsarbeitsbereich nicht mit Ihrem Repository synchron ist, zeigt Dataform die Option Pull an. So übertragen Sie Änderungen aus Ihrem Repository in Ihren Entwicklungsarbeitsbereich:

  1. Wählen Sie auf der Seite Dataform ein Repository aus.
  2. Wählen Sie auf dem Tab Entwicklungsbereiche einen Entwicklungsarbeitsbereich aus.
  3. Führen Sie auf der Seite des Entwicklungsarbeitsbereichs die folgenden Schritte aus:
    1. Wenn Sie sich in einem Dataform-Repository befinden, klicken Sie auf Aus Standardzweig abrufen.
    2. Wenn Sie sich in einem Repository befinden, das mit einem Git-Repository eines Drittanbieters verbunden ist, klicken Sie auf Von your-branch-name abrufen.

Commit für Änderungen durchführen

Nachdem Sie eine Änderung in einem Entwicklungsarbeitsbereich vorgenommen haben, zeigt Dataform die Option Commit an. Sie können für alle lokalen Änderungen oder für ausgewählte Dateien einen Commit durchführen.

Führen Sie die folgenden Schritte aus, um Änderungen aus Ihrem Entwicklungsarbeitsbereich per Commit an Ihr Repository zu übertragen:

  1. Wählen Sie auf der Seite Dataform ein Repository aus.
  2. Wählen Sie auf der Repository-Seite einen Entwicklungsarbeitsbereich aus.
  3. Klicken Sie auf der Seite des Entwicklungsarbeitsbereichs auf Commit.
  4. Führen Sie im Bereich Neuer Commit die folgenden Schritte aus:

    1. Geben Sie im Feld Commit-Nachricht hinzufügen eine Beschreibung für den Commit ein.
    2. Wählen Sie die geänderten Dateien aus, für die Sie einen Commit ausführen möchten.

      Wenn Sie keine Dateien auswählen, führt Dataform einen Commit für alle lokalen Änderungen durch. Sie können geänderte Dateien nach Dateistatus, Dateiname und Dateipfad filtern.

    3. Klicken Sie auf Commit für alle Änderungen oder Commit für X-Änderungen.

      Der Name der Schaltfläche hängt von Ihrer Auswahl der Dateien für den Commit ab.

Änderungen per Push übertragen

Dataform zeigt nach dem Commit von Änderungen die Option Push an. So übertragen Sie Änderungen aus Ihrem Entwicklungsarbeitsbereich in Ihr Repository:

  1. Wählen Sie auf der Seite Dataform ein Repository aus.
  2. Wählen Sie auf der Repository-Seite einen Entwicklungsarbeitsbereich aus.
  3. Commit für Änderungen durchführen
  4. Führen Sie auf der Seite des Entwicklungsarbeitsbereichs die folgenden Schritte aus:
    1. Wenn Sie sich in einem Dataform-Repository befinden, klicken Sie auf Push an Standardzweig.
    2. Wenn Sie sich in einem Repository befinden, das mit einem Git-Repository eines Drittanbieters verbunden ist, klicken Sie auf Push zu your-branch-name.

Änderungen ohne durchgeführten Commit zurücksetzen

So setzen Sie Änderungen ohne Commit zurück:

  1. Wählen Sie auf der Seite Dataform ein Repository aus.
  2. Wählen Sie auf der Repository-Seite einen Entwicklungsarbeitsbereich aus.
  3. Klicken Sie über dem Bereich Files (Dateien) auf das Menü More (Mehr) und wählen Sie Reset to last commit (Letzten Commit wiederherstellen) aus.

Zusammenführungskonflikte lösen

Ein Zusammenführungskonflikt kann auftreten, wenn eine lokale Änderung in Ihrem Entwicklungsarbeitsbereich nicht mit einer Änderung kompatibel ist, die am Standard-Tracking-Zweig Ihres Repositorys vorgenommen wurde. Zusammenführungskonflikte treten normalerweise auf, wenn mehrere Nutzer gleichzeitig dieselbe Datei bearbeiten.

Ein Zusammenführungskonflikt tritt normalerweise auf, wenn Sie Daten aus einem Zweig abrufen, nachdem ein anderer Nutzer eine in Konflikt stehende Änderung per Push an denselben Zweig übertragen hat. Sie müssen einen Zusammenführungskonflikt manuell lösen, indem Sie die betroffene Datei bearbeiten.

Das folgende Codebeispiel zeigt einen Zusammenführungskonflikt, der in einer SQLX-Datei angezeigt wird:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

So lösen Sie einen Zusammenführungskonflikt:

  1. Wählen Sie in Ihrem Entwicklungsarbeitsbereich im Bereich Files (Dateien) eine betroffene Datei aus.
  2. Nehmen Sie die gewünschten Änderungen in der Datei vor.
  3. Commit für Änderungen durchführen
  4. Optional: Änderungen per Push übertragen

Nächste Schritte