Entwicklungsumgebungen erstellen
In dieser Kurzanleitung erfahren Sie, wie Sie in Dataform individuelle Entwicklungsumgebungen erstellen, damit jeder Entwickler in seiner eigenen Entwicklungsumgebung arbeiten kann:
- Erstellen Sie ein Dataform-Repository.
Weisen Sie Dataform Zugriff auf BigQuery zu.
Konfigurieren Sie Kompilierungsüberschreibungen, die Dataform auf alle Arbeitsbereiche in Ihrem Repository anwendet und Arbeitsbereiche in isolierte Entwicklungsumgebungen umwandelt.
Hinweis
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the BigQuery and Dataform APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the BigQuery and Dataform APIs.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen aller Aufgaben in dieser Anleitung benötigen:
-
Dataform Admin (
roles/dataform.admin
) – Repositories -
Dataform-Bearbeiter (
roles/dataform.editor
) – Arbeitsbereiche und Workflowaufrufe
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-Repository erstellen
Öffnen Sie in der Google Cloud Console die Seite Dataform.
Klicken Sie auf
Repository erstellen.Führen Sie auf der Seite Repository erstellen die folgenden Schritte aus:
Geben Sie im Feld Repository-ID den Wert
quickstart-dev
ein.Wählen Sie in der Liste Region
europe-west4
aus.Klicken Sie auf Erstellen.
Klicken Sie auf Fertig.
Dataform Zugriff auf BigQuery gewähren
Damit Workflows in BigQuery ausgeführt werden können, muss das Dataform-Dienstkonto die folgenden Rollen haben:
- BigQuery-Dateneditor für Projekte, für die Dataform sowohl Lese- als auch Schreibzugriff benötigt. Sie enthalten in der Regel das Projekt, in dem Ihr Dataform-Repository gehostet wird.
- BigQuery Data Viewer für Projekte, auf die Dataform Lesezugriff benötigt.
- BigQuery-Jobnutzer für das Projekt, in dem Ihr Dataform-Repository gehostet wird.
So weisen Sie diese Rollen zu:
Öffnen Sie in der Google Cloud Console die Seite IAM.
Klicken Sie auf Hinzufügen.
Geben Sie im Feld Neue Hauptkonten die ID Ihres Dataform-Dienstkontos ein.
Wählen Sie im Drop-down-Menü Rolle auswählen die Rolle BigQuery-Jobnutzer aus.
Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie dann im Drop-down-Menü Rolle auswählen die Rolle BigQuery-Datenbearbeiter aus.
Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie dann im Drop-down-Menü Rolle auswählen die Rolle BigQuery-Datenbetrachter aus.
Klicken Sie auf Speichern.
Kompilierungsüberschreibungen für Arbeitsbereiche konfigurieren
So erstellen Sie isolierte Entwicklungsumgebungen mit Überschreibungen von Dataform-Arbeitsbereichskompilierungen:
Öffnen Sie in der Google Cloud Console die Seite Dataform.
Klicken Sie auf
quickstart-dev
.Klicken Sie auf Einstellungen und dann auf Bearbeiten
Geben Sie im Bereich Überschreibungen von Arbeitsbereichskompilierungen im Feld Schema-Suffix den Wert
${workspaceName}
ein.Wenn Sie die Ausführung in einem Arbeitsbereich auslösen, hängt Dataform den Namen des Arbeitsbereichs als Suffix an das in den Workflow-Einstellungen festgelegte Standardschema an. In dieser Kurzanleitung werden die Dataform-Standardeinstellungen mit dem Standardschema
dataform
verwendet.Klicken Sie auf Speichern.
Dataform wendet Überschreibungen von Arbeitsbereichskompilierungen auf alle Arbeitsbereiche in Ihrem Repository an.
Bei dieser Konfiguration führt Dataform einen SQL-Workflow, der manuell in einem Arbeitsbereich ausgeführt wird, mit Überschreibungen der Arbeitsbereichskompilierung aus.
Dataform führt also den SQL-Workflow im dataform_workspaceName
-Schema in BigQuery aus und wandelt den Arbeitsbereich in eine isolierte Entwicklungsumgebung um.
Wenn Sie beispielsweise die Ausführung in einem sasha
-Arbeitsbereich manuell auslösen, führt Dataform Ihren SQL-Workflow im Schema dataform_sasha
in BigQuery aus.
Wenn Sie SQL-Workflows ohne Überschreibungen von Arbeitsbereichskompilierungen ausführen, aber die Überschreibungen von Arbeitsbereichskompilierungen für Entwicklungsumgebungen beibehalten möchten, können Sie Releasekonfigurationen erstellen, um andere Ausführungsumgebungen zu konfigurieren, z. B. staging
und production
.
Bereinigen
Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud -Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:
In BigQuery erstellte Datasets löschen
Löschen Sie Datasets mit Namen, die mit dataform
beginnen, z. B. dataform-sasha
, damit keine Gebühren für BigQuery-Assets anfallen.
Öffnen Sie in der Google Cloud Console die Seite BigQuery.
Maximieren Sie im Bereich Explorer Ihr Projekt und wählen Sie ein Dataset aus.
Klicken Sie auf das Menü
Aktionen und wählen Sie Löschen aus.Geben Sie im Dialogfeld Dataset löschen den Wert
delete
in das Feld ein und klicken Sie auf Löschen.
Dataform-Repository löschen
Für das Erstellen von Dataform-Repositories fallen keine Kosten an. Möchten Sie jedoch ein Repository und seinen Inhalt löschen, gehen Sie so vor:
Öffnen Sie in der Google Cloud Console die Seite Dataform.
Klicken Sie neben
quickstart-dev
auf das Dreipunkt-Menü Mehr und wählen Sie Löschen aus.- Geben Sie im Fenster Repository löschen den Namen des Repositorys ein, um das Löschen zu bestätigen.
Klicken Sie zur Bestätigung auf Löschen.
Nächste Schritte
Weitere Informationen zum Codelebenszyklus in Dataform finden Sie unter Einführung in den Codelebenszyklus in Dataform.
Weitere Informationen zu Best Practices für den Codelebenszyklus in Dataform finden Sie unter Codelebenszyklus verwalten.
Weitere Informationen zu Überschreibungen von Arbeitsbereichskompilierungen in Dataform finden Sie unter Überschreibungen von Arbeitsbereichskompilierungen erstellen.
Informationen zum Planen von Produktionsausführungen in Dataform finden Sie unter Produktionsausführungen planen.