Codesteuerung

In diesem Dokument erfahren Sie, wie Sie mit der Versionsverwaltung in Dataform die Entwicklung verfolgen.

In Dataform wird Git verwendet, um jede Änderung an den Dateien in einem Repository zu verfolgen.

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

In einem verbundenen Repository interagieren Sie mit dem Tracking-Branch des Remote-Repositories, den Sie beim Verbinden des Repositories konfiguriert haben.

Dataform zeigt Optionen für die Versionskontrolle an, die auf dem Status der Änderungen in Ihrem Entwicklungsarbeitsbereich basieren. In Dataform wird die Commit-Option beispielsweise nur angezeigt, wenn es in Ihrem Arbeitsbereich nicht committete lokale Änderungen gibt. Wenn die Dateien in Ihrem Arbeitsbereich eine exakte Kopie Ihres Standard- oder Tracking-Branches sind, wird in Dataform der Status Arbeitsbereich ist auf dem neuesten Stand angezeigt.

In Dataform werden die folgenden Versionskontrolloptionen angezeigt:

X Änderungen committen
Übernehmen Sie die X lokalen Änderungen in Ihrem Arbeitsbereich oder in den ausgewählten geänderten Dateien. In Dataform werden die nicht bestätigten Änderungen angezeigt.
An Standardzweig übertragen
Übertragen Sie die Commits an Ihren Standardzweig. Diese Option ist in einem Dataform-Repository verfügbar, wenn Sie in Ihrem Arbeitsbereich keine nicht bestätigten Änderungen haben.
Zu your-branch-name übertragen
Übertragen Sie die angewandten Änderungen per Push in your-branch-name. Diese Option ist in einem Repository verfügbar, das mit einem Git-Repository eines Drittanbieters verbunden ist, wenn Sie in Ihrem Arbeitsbereich keine nicht committeten Änderungen haben.
Aus Standardzweig abrufen
Aktualisieren Sie Ihre Arbeitsbereiche mit den letzten Änderungen aus Ihrem Standard-Branch. Diese Option ist in einem Dataform-Repository verfügbar, wenn Sie in Ihrem Arbeitsbereich keine nicht bestätigten oder nicht gepushten bestätigten Änderungen 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 Sie in Ihrem Arbeitsbereich keine nicht committierten oder nicht gepushten Änderungen haben.
Letzten Commit wiederherstellen
Stellen Sie die Dateien in Ihrem Arbeitsbereich in den Zustand des letzten Commits wieder her.

Hinweis

  1. Wählen Sie ein Repository aus oder erstellen Sie ein neues.
  2. Optional: Verbinden Sie Ihr Repository mit einem Git-Repository eines Drittanbieters.
  3. Wählen Sie einen Entwicklungsarbeitsbereich aus oder erstellen Sie einen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Dataform Editor (roles/dataform.editor) für Arbeitsbereiche zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie für die Versionskontrolle in Dataform benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

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

Änderungen abrufen

Wenn Ihr Entwicklungsbereich nicht mit Ihrem Repository synchronisiert ist, wird in Dataform die Option Pull angezeigt. So holen Sie Änderungen aus Ihrem Repository in Ihren Entwicklungsbereich ab:

  1. Wählen Sie auf der Seite Dataform ein Repository aus.
  2. Wählen Sie auf dem Tab Entwicklungsarbeitsbereiche einen Entwicklungsarbeitsbereich aus.
  3. Führen Sie auf der Seite „Entwicklungsarbeitsbereich“ 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, wird in Dataform die Option Commit angezeigt. Sie können alle lokalen Änderungen oder ausgewählte Dateien festschreiben.

Im Dialogfeld Neuer Commit werden die nicht committierten Änderungen angezeigt.

So übernehmen Sie Änderungen aus Ihrem Entwicklungsbereich 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. Klicken Sie auf der Seite des Entwicklungsbereichs 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 ein Commit durchgeführt werden soll.

      Wenn Sie keine Dateien auswählen, werden alle lokalen Änderungen in Dataform committet. Sie können geänderte Dateien nach Dateistatus, Dateiname und Pfad filtern.

    3. Klicken Sie auf Alle Änderungen übernehmen oder X Änderungen übernehmen.

      Der Name der Schaltfläche hängt von der Auswahl der zu committenden Dateien ab.

Änderungen übertragen

In Dataform wird die Option Push angezeigt, nachdem Sie Änderungen übernommen haben. So übertragen Sie Änderungen aus Ihrem Entwicklungsbereich 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. Änderungen übernehmen
  4. Führen Sie auf der Seite „Entwicklungsarbeitsbereich“ die folgenden Schritte aus:
    1. Wenn Sie sich in einem Dataform-Repository befinden, klicken Sie auf An Standardzweig übertragen.
    2. Wenn Sie sich in einem Repository befinden, das mit einem Git-Repository eines Drittanbieters verbunden ist, klicken Sie auf Push to your-branch-name.

Änderungen ohne durchgeführten Commit zurücksetzen

So heben Sie nicht committete Änderungen auf:

  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 Dateien auf das Dreipunkt-Menü Mehr und wählen Sie Zum letzten Commit zurückkehren aus.

Zusammenführungskonflikte beheben

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

Ein Konflikt beim Zusammenführen tritt in der Regel auf, wenn Sie aus einem Branch ziehen, nachdem ein anderer Nutzer eine in Konflikt stehende Änderung auf denselben Branch gepusht 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 Konflikt beim Zusammenführen:

  1. Wählen Sie in Ihrem Entwicklungsbereich im Bereich Dateien eine betroffene Datei aus.
  2. Bearbeiten Sie die Datei mit den gewünschten Änderungen.
  3. Änderungen übernehmen
  4. Optional: Änderungen per Push übertragen

Nächste Schritte