Diese Seite wurde von der Cloud Translation API übersetzt.

Repository verwalten

In diesem Dokument wird Folgendes beschrieben:

Dataform-Workfloweinstellungen konfigurieren
Dataform-Kernpaket verwalten
Verwenden Sie eine Versionskontrolle für Ihren Code.

Hinweise

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen der Aufgaben in diesem Dokument benötigen:

Dataform-Einstellungen konfigurieren und den Speicherort des Dataform-Kernpakets verwalten: Dataform Admin (roles/dataform.admin) für Repositories.
Aktualisieren Sie das Dataform-Core-Paket und verwenden Sie die Versionskontrolle in Dataform: Dataform-Bearbeiter (roles/dataform.editor) für Arbeitsbereiche.

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.

Dataform-Workfloweinstellungen konfigurieren

In diesem Abschnitt erfahren Sie, wie Sie die Verarbeitungseinstellungen für den Dataform-Workflow für ein bestimmtes Repository bearbeiten.

Sie können die Einstellungsdatei bearbeiten, um die Schemas umzubenennen oder Ihrem Repository benutzerdefinierte Kompilierungsvariablen hinzuzufügen.

Repository-Einstellungen

Jedes Dataform-Repository enthält eine eindeutige Datei mit Workflow-Einstellungen. Die Datei enthält die Google Cloud-Projekt-ID und das Schema, in dem Dataform Assets in BigQuery veröffentlicht. Dataform verwendet Standardeinstellungen, die Sie überschreiben können, um sie an Ihre Anforderungen anzupassen. Bearbeiten Sie dazu die Einstellungsdatei.

Ab Dataform Core 3.0.0 werden Workflow-Einstellungen standardmäßig in der Datei workflow_settings.yaml gespeichert. In früheren Versionen von Dataform Core werden Workflow-Einstellungen in der Datei dataform.json gespeichert. Die Dataform Core 3.0-workflow_settings.yaml-Datei ist abwärtskompatibel mit der dataform.json-Datei. Sie können die dataform.json-Datei weiterhin zum Speichern von Workfloweinstellungen verwenden. Aus Gründen der zukünftigen Kompatibilität sollten Sie Ihre Repository-Workflow-Einstellungen in das workflow_settings.yaml-Format migrieren.

Über `workflow_settings.yaml`

Die Datei workflow_settings.yaml, die in Dataform Core 3.0 eingeführt wurde, speichert Dataform-Workflow-Einstellungen im YAML-Format.

Das folgende Codebeispiel zeigt eine workflow_settings.yaml-Beispieldatei:

  defaultProject: my-gcp-project-id
  defaultDataset: dataform
  defaultLocation: australia-southeast2
  defaultAssertionDataset: dataform_assertions

Im vorherigen Codebeispiel werden die Schlüssel/Wert-Paare so beschrieben:

defaultProject: Die Google Cloud-Projekt-ID Ihres BigQuery-Projekts.
defaultDataset: Das BigQuery-Dataset, in dem Dataform Assets erstellt. Standardmäßig heißt es dataform.
defaultLocation: Die Standardregion Ihres BigQuery-Datasets. An diesem Speicherort verarbeitet Dataform Ihren Code und speichert die ausgeführten Daten. Diese Verarbeitungsregion muss mit dem Speicherort Ihrer BigQuery-Datasets übereinstimmen, aber nicht mit der Region des Dataform-Repositories. Weitere Informationen zu BigQuery-Datensatzstandorten finden Sie unter Dataset-Standorte.
defaultAssertionDataset: Das BigQuery-Dataset, in dem Dataform Ansichten mit Assertion-Ergebnissen erstellt. Standardmäßig heißt es dataform_assertions.

Weitere Informationen zu workflow_settings.yaml-Properties findest du unter WorkflowSettings auf GitHub.

Sie können im Dataform-Code auf die in workflow_settings.yaml definierten Eigenschaften als Eigenschaften des Objekts dataform.projectConfig zugreifen.

Die folgenden Zuordnungen von workflow_settings.yaml-Optionen zu den über Code zugänglichen dataform.projectConfig-Optionen gelten:

defaultProject => defaultDatabase
defaultDataset => defaultSchema
defaultAssertionDataset => assertionSchema
projectSuffix => databaseSuffix
datasetSuffix => schemaSuffix
namePrefix => tablePrefix

Im folgenden Codebeispiel wird das dataform.projectConfig-Objekt gezeigt, auf das in einer SELECT-Anweisung in einer Ansicht verwiesen wird:

  config { type: "view" }
  SELECT ${when(
    !dataform.projectConfig.tablePrefix,
    "table prefix is set!",
    "table prefix is not set!"
  )}

Über `dataform.json`

In der Datei dataform.json werden die Dataform-Workflow-Einstellungen im JSON-Format gespeichert.

Das folgende Codebeispiel zeigt eine dataform.json-Beispieldatei:

  {
    "warehouse": "bigquery",
    "defaultDatabase": "my-gcp-project-id",
    "defaultSchema": "dataform",
    "defaultLocation": "australia-southeast2",
    "assertionSchema": "dataform_assertions"
  }

Im vorherigen Codebeispiel werden die Schlüssel/Wert-Paare so beschrieben:

warehouse: Verweis auf BigQuery, in dem Dataform Assets erstellt.
defaultDatabase: Die Google Cloud-Projekt-ID Ihres BigQuery-Projekts.
defaultSchema: Das BigQuery-Dataset, in dem Dataform Assets erstellt.
defaultLocation: Die Standardregion Ihres BigQuery-Datasets. An diesem Speicherort verarbeitet Dataform Ihren Code und speichert die ausgeführten Daten. Diese Verarbeitungsregion muss mit dem Speicherort Ihrer BigQuery-Datasets übereinstimmen, aber nicht mit der Region des Dataform-Repositories. Weitere Informationen zu BigQuery-Datensatzstandorten finden Sie unter Dataset-Standorte.
assertionSchema: Das BigQuery-Dataset, in dem Dataform Ansichten mit Assertion-Ergebnissen erstellt. Standardmäßig heißt es dataform_assertions.

Sie können auf die in der dataform.json-Datei definierten Eigenschaften im Projektcode als Eigenschaften des Objekts dataform.projectConfig zugreifen.

Schemanamen konfigurieren

Wenn Sie Schemanamen konfigurieren möchten, müssen Sie die Eigenschaften defaultDataset und defaultAssertionSchema in der Datei workflow_settings.yaml oder die Eigenschaften defaultSchema und assertionSchema in der Datei dataform.json bearbeiten.

So konfigurieren Sie den Namen eines Schemas:

`workflow_settings.yaml`

Klicken Sie in Ihrem Entwicklungsbereich im Bereich Dateien auf die Datei workflow_settings.yaml.
Bearbeiten Sie den Wert von defaultDataset, defaultAssertionSchema oder beiden.

Das folgende Codebeispiel zeigt einen benutzerdefinierten defaultDataset-Namen, der in der Datei workflow_settings.yaml definiert ist:

  ...
  defaultDataset: mytables
  ...

`dataform.json`

Klicken Sie in Ihrem Entwicklungsbereich im Bereich Dateien auf die Datei dataform.json.
Bearbeiten Sie den Wert von defaultSchema, assertionSchema oder beiden.

Das folgende Codebeispiel zeigt einen benutzerdefinierten defaultSchema-Namen, der in der Datei dataform.json definiert ist:

{
  ...
  "defaultSchema": "mytables",
  ...
}

Benutzerdefinierte Kompilierungsvariablen erstellen

Kompilierungsvariablen enthalten Werte, die Sie mit Kompilierungsüberschreibungen in einer Release-Konfiguration oder in einer Dataform API-Anfrage ändern können.

Nachdem Sie eine Kompilierungsvariable in workflow_settings.yaml definiert und ausgewählten Tabellen hinzugefügt haben, können Sie ihren Wert in einer Release-Konfiguration oder in Überschreibungen für die Dataform API-Kompilierung ändern, um Tabellen bedingt auszuführen.

Weitere Informationen zum bedingten Ausführen von Tabellen mithilfe von Kompilierungsvariablen finden Sie unter Einführung in den Codelebenszyklus in Dataform.

So erstellen Sie eine Kompilierungsvariable, die Sie für ein gesamtes Repository verwenden können:

`workflow_settings.yaml`

Rufen Sie Ihren Dataform-Entwicklungsarbeitsbereich auf.
Wählen Sie im Bereich Dateien die Datei workflow_settings.yaml aus.
Geben Sie das folgende Code-Snippet ein:
```
"vars": {
  "VARIABLE":"VALUE"
}
```
Ersetzen Sie Folgendes:
- VARIABLE: ein Name für die Variable
- VALUE: der Standardwert der Kompilierungsvariablen

Im folgenden Codebeispiel ist die myVariableName-Kompilierungsvariable in der Datei workflow_settings.yaml auf myVariableValue festgelegt:

...
vars:
  myVariableName: myVariableValue
...

Das folgende Codebeispiel zeigt die workflow_settings.yaml-Datei mit der executionSetting-Kompilierungsvariablen, die auf dev festgelegt ist:

defaultProject: default_bigquery_database
defaultLocation: us-west1
defaultDataset: dataform_data,
vars:
executionSetting: dev

`dataform.json`

Rufen Sie Ihren Dataform-Entwicklungsarbeitsbereich auf.
Wählen Sie im Bereich Dateien die Datei dataform.json aus.
Geben Sie das folgende Code-Snippet ein:
```
"vars": {
  "VARIABLE":"VALUE"
}
```
Ersetzen Sie Folgendes:
- VARIABLE: ein Name für die Variable
- VALUE: mit dem Standardwert der Kompilierungsvariablen

Im folgenden Codebeispiel ist die myVariableName-Kompilierungsvariable in der Datei dataform.json auf myVariableValue festgelegt:

{
  ...
  "vars": {
    "myVariableName": "myVariableValue"
  },
  ...
}

Das folgende Codebeispiel zeigt die dataform.json-Datei mit der executionSetting-Kompilierungsvariablen, die auf dev festgelegt ist:

{
"warehouse": "bigquery",
"defaultSchema": "dataform_data",
"defaultDatabase": "default_bigquery_database".
"defaultLocation":"us-west-1",
"vars": {
"executionSetting":"dev"
}
}

Tabelle eine Kompilierungsvariable hinzufügen

So fügen Sie einer SQLX-Tabellendefinition eine Kompilierungsvariable hinzu:

Rufen Sie Ihren Dataform-Entwicklungsarbeitsbereich auf.
Wählen Sie im Bereich Dateien eine SQLX-Tabellendefinitiondatei aus.
Geben Sie in der Datei eine when-Klausel im folgenden Format ein:
```
${when(dataform.projectConfig.vars.VARIABLE === "SET_VALUE", "CONDITION")}
```
Ersetzen Sie Folgendes:
- VARIABLE: der Name der Variablen, z. B. executionSetting
- SET_VALUE: ein Wert für die Variable, z. B. staging
- CONDITION: eine Bedingung für die Ausführung der Tabelle

Im folgenden Codebeispiel wird eine SQLX-Datei mit einer when-Klausel und der Variablen executionSetting gezeigt, mit der 10% der Daten in der Einstellung für die Stagingausführung ausgeführt werden:

  select
    *
  from ${ref("data")}
  ${when(
    dataform.projectConfig.vars.executionSetting === "staging",
    "where mod(farm_fingerprint(id) / 10) = 0",
  )}

Das folgende Codebeispiel zeigt eine SQLX-Datei mit einer Sichtdefinition mit einer when-Klausel und der Variablen myVariableName:

  config { type: "view" }
  SELECT ${when(
    dataform.projectConfig.vars.myVariableName === "myVariableValue",
    "myVariableName is set to myVariableValue!",
    "myVariableName is not set to myVariableValue!"
  )}

Workfloweinstellungen zu `workflow_settings.yaml` migrieren

Damit Ihre Workflow-Einstellungen mit zukünftigen Versionen des Dataform Core-Frameworks kompatibel sind, sollten Sie Ihre Workflow-Einstellungen aus der Datei dataform.json in die Datei workflow_settings.yaml migrieren.

Die Datei workflow_settings.yaml ersetzt die Datei dataform.json.

Wenn Dataform Core das einzige Abhängigkeitspaket in Ihrem Repository ist, ersetzt die Datei workflow_settings.yaml auch die Datei package.json. Weitere Informationen zum Ersetzen der Datei package.json durch die Datei workflow_settings.yaml finden Sie unter Dataform-Kernpaket verwalten.

In der folgenden Tabelle ist die Zuordnung der Workflow-Einstellungen aus der Datei dataform.json zur Datei workflow_settings.yaml dargestellt:

Unterkunft in `dataform.json`	Unterkunft in `workflow_settings.yaml`	Beschreibung
`assertionSchema`	`defaultAssertionDataset`	Pflichtangabe. Der Standarddatensatz für Behauptungen.
`defaultDatabase`	`defaultProject`	Pflichtangabe. Der Standardprojektname Google Cloud .
`defaultLocation`	`defaultLocation`	Pflichtangabe. Der Standardspeicherort in BigQuery, an dem Dataform Tabellen erstellt. Weitere Informationen zu BigQuery-Standorten finden Sie unter Dataset-Standorte.
`defaultSchema`	`defaultDataset`	Pflichtangabe. Der Standard-Dataset.
`databaseSuffix`	`projectSuffix`	Optional. Das Suffix, das an alle Google Cloud -Projektverweise angehängt werden soll.
`schemaSuffix`	`datasetSuffix`	Optional. Das Suffix, das an alle Aktionsdatensätze angehängt werden soll.
`tablePrefix`	`namePrefix`	Optional. Das Präfix, das allen Aktionsnamen vorangestellt werden soll.
`vars`	`vars`	Optional. Benutzerdefinierte Variablen, die dem Projektcode während der Kompilierung zur Verfügung gestellt werden. Ein Objekt, das eine Liste von `key: value`-Paaren enthält.
`warehouse`	-	Erforderlich in `dataform.json`. Dieses Feld muss auf `bigquery` festgelegt sein. In `workflow_settings.yaml` nicht verfügbar.
-	`dataformCoreVersion`	In `dataform.json` nicht verfügbar. Wird bei neuen Repositories standardmäßig in `workflow_settings.yaml` installiert. Weitere Informationen finden Sie unter Dataform-Kernpaket verwalten.

So migrieren Sie Workflow-Einstellungen zu workflow_settings.yaml:

Öffnen Sie in der Google Cloud Console die Seite Dataform.

Zu Dataform
Wählen Sie ein Repository und dann einen Arbeitsbereich aus.
Klicken Sie im Bereich Dateien auf HinzufügenHinzufügen und dann auf Datei erstellen.
Geben Sie im Feld Dateipfad hinzufügen workflow_settings.yaml ein.
Klicken Sie auf Datei erstellen.
Fügen Sie in der workflow_settings.yaml-Datei die Einstellungen aus der dataform.json-Datei hinzu, die dem YAML-Format zugeordnet sind.
Klicken Sie im Bereich Dateien neben dataform.json auf das Dreipunkt-Menü Mehr und dann auf Löschen.
Klicken Sie auf Löschen, um das Löschen von dataform.json zu bestätigen.

Das folgende Codebeispiel zeigt Workfloweinstellungen, die in einer dataform.json-Datei definiert sind:

{
  "warehouse": "bigquery",
  "defaultDatabase": "dataform-demos",
  "defaultLocation": "US",
  "defaultSchema": "dataform",
  "assertionSchema": "dataform_assertions"
  "vars": {
    "environmentName": "development"
  }
}

Das folgende Codebeispiel zeigt die vorherige dataform.json-Datei, die in workflow_settings.yaml konvertiert wurde:

defaultProject: dataform-demos
defaultLocation: US
defaultDataset: dataform
defaultAssertionDataset: dataform_assertions
vars:
    environmentName: "development"

Dataform-Kernpaket verwalten

In diesem Abschnitt erfahren Sie, wie Sie das Abhängigkeitspaket des Dataform-Kernframeworks verwalten und auf die neueste Version aktualisieren.

Dataform Core ist das Open-Source-Dataform-Framework zum Entwickeln von Workflows mit SQL, SQLX und JavaScript. Verwenden Sie immer die neueste verfügbare Version des Dataform-Kernframeworks. Informationen zu Releases des Dataform-Kernframeworks finden Sie unter Dataform-Releases auf GitHub.

Speicherort des Dataform-Kernpakets verwalten

Wenn Sie den ersten Arbeitsbereich in einem Repository initialisieren, wird Dataform Core automatisch als Abhängigkeitspaket festgelegt. Ab Dataform Core 3.0.0 installiert Dataform das Dataform-Kernpaket standardmäßig in der Datei workflow_settings.yaml. In früheren Versionen von Dataform Core wurde Dataform Core in der Datei package.json festgelegt.

Wenn Dataform Core in Dataform Core 3.0.0 und höher das einzige Paket in Ihrem Repository ist, sollten Sie es in der Datei workflow_settings.yaml festlegen. Bei Repositories, die mit früheren Versionen von Dataform Core erstellt wurden, verschieben Sie das Dataform Core-Paket zu workflow_settings.yaml.

Die Datei package.json ist erforderlich, um zusätzliche Pakete in Dataform zu installieren. Wenn in Ihrem Repository zusätzliche Pakete verwendet werden, legen Sie das Dataform-Kernpaket in package.json fest, damit alle Pakete an einem Ort festgelegt sind. Wenn Ihr Repository die Datei package.json nicht enthält, erstellen Sie die Datei package.json und verschieben Sie das Dataform-Kernpaket, um zusätzliche Pakete zu installieren.

Dataform-Kern zu `workflow_settings.yaml` verschieben

Wenn Sie für Repositories, die mit Versionen von Dataform Core vor 3.0.0 erstellt wurden, keine anderen Abhängigkeitspakete als Dataform Core haben, sollten Sie das Dataform Core-Paket aus der Datei package.json in die Datei workflow_settings.yaml verschieben und die redundante Datei package.json löschen.

So migrieren Sie das Dataform-Kernpaket aus der Datei package.json in die Datei workflow_settings.yaml:

Öffnen Sie in der Google Cloud Console die Seite Dataform.

Zu Dataform
Wählen Sie ein Repository und dann einen Arbeitsbereich aus.
Wählen Sie im Bereich Dateien die Datei workflow_settings.yaml aus.
Fügen Sie in der Datei workflow_settings.yaml das Dataform-Kernpaket im folgenden Format hinzu:
```
dataformCoreVersion: "VERSION"
```
Ersetzen Sie VERSION durch die neueste Version von Dataform, z. B. 3.0.0.
Klicken Sie im Bereich Dateien neben der Datei package.json auf das Dreipunkt-Menü Mehr und dann auf Löschen.
Klicken Sie auf Löschen, um das Löschen der dataform.json-Datei zu bestätigen.
Klicken Sie auf Pakete installieren.

Dataform-Kern zu `package.json` verschieben

Die Datei package.json ist erforderlich, um zusätzliche Pakete in einem Repository zu installieren. Wenn in Ihrem Repository zusätzliche Pakete verwendet werden, sollten Sie alle Pakete, einschließlich des Dataform-Kernpakets, in der Datei package.json speichern.

Wenn Ihr Repository die Datei package.json nicht enthält, weil das Dataform-Kernpaket in der Datei workflow_settings.yaml festgelegt ist, müssen Sie die Datei package.json erstellen, um zusätzliche Pakete zu installieren, und dann das Dataform-Kernpaket aus der Datei workflow_settings.yaml in die neu erstellte Datei package.json verschieben.

So erstellen Sie die package.json-Datei und verschieben das Dataform-Kernpaket:

Öffnen Sie in der Google Cloud Console die Seite Dataform.

Zu Dataform
Wählen Sie ein Repository und dann einen Arbeitsbereich aus.
Klicken Sie im Bereich Dateien auf HinzufügenHinzufügen und dann auf Datei erstellen.
Geben Sie im Feld Dateipfad hinzufügen package.json ein.
Klicken Sie auf Datei erstellen.
Fügen Sie in der Datei package.json das Dataform-Kernpaket im folgenden Format hinzu:
```
{
    "dependencies": {
        "@dataform/core": "VERSION"
    }
}
```
Ersetzen Sie VERSION durch die neueste Version von Dataform, z. B. 3.0.0.
Klicken Sie auf Pakete installieren.
Wählen Sie im Bereich Dateien die Option workflow_settings.yaml aus.
Löschen Sie in der Datei workflow_settings.yaml die Property dataformCoreVersion.

Dataform-Kern aktualisieren

Testen Sie neue Paketversionen immer in einer Nicht-Produktionsumgebung, bevor Sie sie in Ihrer Produktionsumgebung bereitstellen.

So aktualisieren Sie das Abhängigkeitspaket „Dataform Core“:

Die neueste Version von @dataform/core finden Sie auf der Seite mit den Dataform-Releases auf GitHub.
Öffnen Sie in der Google Cloud Console die Seite Dataform.

Zu Dataform
Wählen Sie ein Repository und dann einen Arbeitsbereich aus.
Wählen Sie im Bereich Dateien die Datei package.json oder workflow_settings.yaml aus.

Der Speicherort, an dem das Abhängigkeitspaket für Dataform Core festgelegt ist, hängt von Ihrer Version von Dataform Core und Ihrer Verwendung von Paketen ab. Weitere Informationen finden Sie unter Speicherort des Dataform-Kernpakets verwalten.
Aktualisieren Sie das Dataform-Kernabhängigkeitspaket auf die neueste Version:
package.json
```
{
    "dependencies": {
        "@dataform/core": "VERSION"
    }
}
```
Ersetzen Sie VERSION durch die neueste Version von Dataform, z. B. 3.0.0. Geben Sie die Version des Dataform-Kernpakets an, um Probleme bei der Paketinstallation zu vermeiden. Verwenden Sie keine anderen dependencies-Optionen der package.json-Datei, z. B. >version.
workflow_settings.yaml
```
dataformCoreVersion: "VERSION"
```
Ersetzen Sie VERSION durch die neueste Version von Dataform, z. B. 3.0.0.
Klicken Sie auf Pakete installieren.
Übernehmen Sie die Änderungen.
Übertragen Sie die Änderungen per Push in Ihr Repository.

Im folgenden Codebeispiel wird die @dataform/core-Abhängigkeit in der Datei package.json auf die Version 3.0.0 aktualisiert:

{
    "dependencies": {
        "@dataform/core": "3.0.0"
    }
}

Codesteuerung

In diesem Abschnitt 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 Entwicklungsbereich 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 Workspace is up to date (Arbeitsbereich 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 Änderungen angezeigt, für die kein Commit durchgeführt wurde.
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.

Ä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 Entwicklungsarbeitsbereich ab:

Wählen Sie auf der Seite Dataform ein Repository aus.
Wählen Sie auf dem Tab Entwicklungsarbeitsbereiche einen Entwicklungsarbeitsbereich aus.
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 Entwicklungsbereich 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 Entwicklungsarbeitsbereich in Ihr Repository:

Wählen Sie auf der Seite Dataform ein Repository aus.
Wählen Sie auf der Repository-Seite einen Entwicklungsarbeitsbereich aus.
Klicken Sie auf der Seite des Entwicklungsbereichs auf Commit.
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 pushen

In Dataform wird die Option Push angezeigt, nachdem Sie Änderungen übernommen haben. So übertragen Sie Änderungen aus Ihrem Entwicklungsbereich in Ihr Repository:

Wählen Sie auf der Seite Dataform ein Repository aus.
Wählen Sie auf der Repository-Seite einen Entwicklungsarbeitsbereich aus.
Änderungen übernehmen
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:

Wählen Sie auf der Seite Dataform ein Repository aus.
Wählen Sie auf der Repository-Seite einen Entwicklungsarbeitsbereich aus.
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:

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

Nächste Schritte

Weitere Informationen zu den Projekteinstellungen von Dataform finden Sie in der IProjectConfig-Referenz.
Informationen zum Installieren zusätzlicher Pakete finden Sie unter Paket in Dataform installieren.
Informationen zum Erstellen einer Tabelle finden Sie unter Tabelle erstellen.

Repository verwalten

Hinweise

Erforderliche Rollen

Dataform-Workfloweinstellungen konfigurieren

Repository-Einstellungen

Über workflow_settings.yaml

Über dataform.json

Schemanamen konfigurieren

workflow_settings.yaml

dataform.json

Benutzerdefinierte Kompilierungsvariablen erstellen

workflow_settings.yaml

dataform.json

Tabelle eine Kompilierungsvariable hinzufügen

Workfloweinstellungen zu workflow_settings.yaml migrieren

Dataform-Kernpaket verwalten

Speicherort des Dataform-Kernpakets verwalten

Dataform-Kern zu workflow_settings.yaml verschieben

Dataform-Kern zu package.json verschieben

Dataform-Kern aktualisieren

package.json

workflow_settings.yaml

Codesteuerung

Änderungen abrufen

Commit für Änderungen durchführen

Änderungen pushen

Änderungen ohne durchgeführten Commit zurücksetzen

Zusammenführungskonflikte beheben

Nächste Schritte

Über `workflow_settings.yaml`

Über `dataform.json`

`workflow_settings.yaml`

`dataform.json`

`workflow_settings.yaml`

`dataform.json`

Workfloweinstellungen zu `workflow_settings.yaml` migrieren

Dataform-Kern zu `workflow_settings.yaml` verschieben

Dataform-Kern zu `package.json` verschieben

`package.json`

`workflow_settings.yaml`