Entwicklungsarbeitsbereich für Dataform erstellen

Dieses Dokument enthält Anleitungen für folgende Aufgaben:

Wenn Sie zum ersten Mal einen Entwicklungsarbeitsbereich in einem neuen Repository erstellen, werden Sie von Dataform aufgefordert, den Entwicklungsarbeitsbereich mit einer Reihe von Konfigurationsdateien zu initialisieren, die für die Funktion von Dataform erforderlich sind.

Ein initialisierter Entwicklungsbereich enthält die folgenden Verzeichnisse und Dateien:

  • definitions/: ein Verzeichnis für Asset-Definitionen in Dataform Core oder JavaScript.

  • includes/: ein leeres Verzeichnis für Scripts und Variablen, die Sie im gesamten Repository wiederverwenden können.

  • workflow_settings.yaml: die Standardkonfigurationsdatei von Dataform, die die Google Cloud-Projekt-ID und das BigQuery-Schema enthält, in dem Assets veröffentlicht werden sollen. Sie können die Standardeinstellungen überschreiben, um sie an Ihre Anforderungen anzupassen. Das ist aber keine Voraussetzung für die Verwendung von Dataform.

  • package.json: die Standardkonfigurationsdatei für Dataform-Abhängigkeiten mit der neuesten Version von @dataform/core. Sie können diese Datei verwenden, um Pakete zu importieren.

  • definitions/sample.sqlx: eine Beispiel-SQLX-Datei, die Ihnen den Einstieg erleichtert.

Hinweis

Erstellen Sie ein Dataform-Repository, falls noch nicht geschehen.

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 zum Erstellen, Initialisieren und Löschen eines Entwicklungsbereichs 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.

Entwicklungsarbeitsbereich für Dataform erstellen

So erstellen Sie einen neuen Dataform-Entwicklungsbereich:

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

    Zu Dataform

  2. Wählen Sie das Repository aus, in dem Sie den neuen Entwicklungsarbeitsbereich erstellen möchten.

  3. Klicken Sie auf der Repository-Seite auf Entwicklungsarbeitsbereich erstellen.

  4. Führen Sie im Fenster Entwicklungsarbeitsbereich erstellen die folgenden Schritte aus:

    1. Geben Sie im Feld Workspace-ID eine eindeutige ID für den Entwicklungs-Workspace ein.

      IDs dürfen nur Ziffern, Buchstaben, Bindestriche und Unterstriche enthalten.

    2. Klicken Sie auf Erstellen.

Ersten Entwicklungsarbeitsbereich in einem Dataform-Repository initialisieren

So initialisieren Sie einen Dataform-Entwicklungsarbeitsbereich:

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

    Zu Dataform

  2. Wählen Sie das Repository aus, in dem Sie den leeren Arbeitsbereich initialisieren möchten.

  3. Klicken Sie auf dem Tab Entwicklungsarbeitsbereiche auf den Namen des leeren Arbeitsbereichs, den Sie initialisieren möchten.

  4. Klicken Sie auf der Seite „Entwicklungsarbeitsbereich“ auf Arbeitsbereich initialisieren.

Dataform-Entwicklungsarbeitsbereich löschen

Für das Erstellen von Entwicklungsarbeitsbereichen für Dataform fallen keine Kosten an. Wenn Sie aber dennoch einen Entwicklungsarbeitsbereich löschen möchten, gehen Sie so vor:

  1. Klicken Sie auf der Seite Dataform auf das Repository, das den Arbeitsbereich enthält, den Sie löschen möchten.

  2. Um zu verhindern, dass nicht committete Änderungen gelöscht werden, committen und pushen Sie die Änderungen in Ihr Git-Repository.

  3. Wählen Sie auf dem Tab Entwicklungsarbeitsbereiche den Entwicklungsarbeitsbereich aus, den Sie löschen möchten, und klicken Sie dann auf Ausgewählte Arbeitsbereiche löschen.

    Sie können mehrere Arbeitsbereiche gleichzeitig löschen.

  4. Klicken Sie zur Bestätigung auf Löschen.

Nächste Schritte