Kompilierungsüberschreibungen für Arbeitsbereiche erstellen

In diesem Dokument erfahren Sie, wie Sie Überschreibungen von Arbeitsbereichskompilierungen zum Isolieren erstellen Tabellen und Ansichten, die aus Ihren Dataform-Arbeitsbereichen erstellt wurden, BigQuery Mit Überschreibungen von Arbeitsbereichskompilierungen Dataform-Entwicklungsumgebungen.

Kompilierungsüberschreibungen für Arbeitsbereiche

Wenn Sie SQL-Workflowcode in einem Dataform-Arbeitsbereich entwickeln, Dataform kompiliert den Code in Ihrem Arbeitsbereich in Echtzeit, um eine Kompilierungsergebnis des Arbeitsbereichs. Dataform verwendet Einstellungen, die in den Datei mit den Workfloweinstellungen, um die Ergebnis der Arbeitsbereichskompilierung. Gehen Sie dann so vor: wenn Sie die Ausführung in einem Arbeitsbereich auslösen, Dataform führt das Ergebnis der Arbeitsbereichskompilierung aus BigQuery

Zum Überschreiben der Standardeinstellungen in Workfloweinstellungen für alle Arbeitsbereiche in Ihrem Repository können Sie Überschreibungen von Arbeitsbereichskompilierungen erstellen.

Mit Überschreibungen von Arbeitsbereichskompilierungen können Sie die folgenden Einstellungen überschreiben für alle Arbeitsbereiche in Ihrem Repository:

Projekt
Google Cloud-Projekt, in dem Dataform den Arbeitsbereich ausführt Kompilierungsergebnis, festgelegt in workflow_settings.yaml als defaultProject oder in dataform.json als defaultDatabase.
Tabellenpräfix
Benutzerdefiniertes Präfix, das allen Tabellennamen in allen Arbeitsbereichen im zu erstellen.
Schemasuffix

Benutzerdefiniertes Suffix, das an das Schema der Tabellen angehängt wird, die in

Als defaultDataset in workflow_settings.yaml, defaultSchema festgelegt in dataform.json oder im Parameter schema in config-Block einer Tabelle.

Zum Erstellen isolierter Entwicklungsumgebungen können Sie Arbeitsbereiche mit eindeutige Kompilierungsüberschreibungen. Sie können das Tabellenpräfix und Schemasuffixkompilierungen werden mit der Variablen ${workspaceName} überschrieben.

Wenn Sie die Ausführung in einem Arbeitsbereich manuell auslösen, gibt der ${workspaceName} Variable fügt den Namen des Arbeitsbereichs in die Kompilierung des Arbeitsbereichs ein Überschreibungen.

Wenn Sie ${workspaceName} als Tabellenpräfix festlegen, fügt Dataform die Namen des Arbeitsbereichs in die Namen aller Tabellen im Arbeitsbereich. Nach der Ausführung in BigQuery können Sie feststellen, aus welchem Arbeitsbereich eine Tabelle stammt.

Wenn Sie ${workspaceName} als Schemasuffix festlegen, hängt Dataform den Namen des Arbeitsbereichs an defaultSchema, wodurch ein benutzerdefiniertes Schema erstellt wird, zum Arbeitsbereich hinzu. Nach der Ausführung können Sie in BigQuery alle Tabellen, die von einem bestimmten Arbeitsbereich im dedizierten Schema ausgeführt werden.

Beispiel für dynamische Überschreibungen von Arbeitsbereichskompilierungen

Das folgende Beispiel zeigt Überschreibungen von dynamischen Arbeitsbereichskompilierungen, die auf einen mit Arbeitsbereichen, die nach Entwicklern benannt sind, die an der Repository: Sasha und Kai.

In diesem Beispiel sollen Kompilierungen von Arbeitsbereichen für Sasha und Kai entwickelt.

In workflow_settings.yaml sind die folgenden Standardeinstellungen festgelegt:

  • defaultProject: analytics
  • defaultDataset: dataform

Die folgenden Kompilierungsüberschreibungen für Arbeitsbereiche erstellen ein dynamisches Tabellenpräfix Schemasuffix für jeden Arbeitsbereich im Repository:

  • Google Cloud-Projekt-ID : analytics_dev
  • Tabellenpräfix: ${workspaceName}
  • Schema suffix: ${workspaceName}

Wenn Sasha die Ausführung im Arbeitsbereich Sasha manuell auslöst, Dataform führt den Inhalt mit den folgenden Einstellungen aus:

  • Google Cloud-Projekt: analytics_dev
  • Schema: dataform_sasha
  • Tabellennamen: sasha_name, z. B.: sasha_orders.

Wenn Kai die Ausführung im Arbeitsbereich Kai manuell auslöst, gibt Dataform führt den Inhalt mit den folgenden Einstellungen aus:

  • Google Cloud-Projekt: analytics_dev
  • Schema: dataform_kai
  • Tabellennamen: kai_name, z. B.: kai_orders

Hinweise

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

    Zur Seite „Dataform“

  2. Wählen Sie ein Repository aus oder erstellen Sie ein Repository.

  3. Optional: Um das Google Cloud-Standardprojekt zu überschreiben, gewähren Sie Ihrem Zugriff über Dataform-Dienstkonto auf Google Cloud-Projekt, das Sie verwenden möchten.

Erforderliche Rollen

So erhalten Sie die Berechtigungen, die Sie zum Erstellen von Kompilierungsüberschreibungen für Arbeitsbereiche benötigen: bitten Sie Ihren Administrator, Ihnen IAM-Rolle Dataform Admin (roles/dataform.admin) für Repositories. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

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

Kompilierungsüberschreibungen für Arbeitsbereiche erstellen

So erstellen Sie Überschreibungen von Dataform-Arbeitsbereichskompilierungen:

  1. Rufen Sie in Ihrem Repository die Einstellungen auf.
  2. Klicken Sie auf Bearbeiten.
  3. Gehen Sie im Bereich Überschreibungen von Arbeitsbereichskompilierungen im Menü Google Cloud Project ID (Google Cloud-Projekt-ID) die ID des Google Cloud-Projekts ein.
  4. Geben Sie im Feld Tabellenpräfix ein Präfix für alle Tabellennamen ein.
    1. Optional: Um ein dynamisches Tabellenpräfix zu erstellen, das für jedes Arbeitsbereich enthalten, geben Sie ${workspaceName} als Tabellenpräfix ein.
  5. Geben Sie im Feld Schemasuffix das Suffix ein, das an das Schema von die erstellte Tabelle oder Ansicht.
    1. Optional: Um ein dynamisches Schemasuffix zu erstellen, das für jedes einzelne Arbeitsbereich enthalten, geben Sie ${workspaceName} als Tabellensuffix ein.
  6. Klicken Sie auf Speichern.

Dataform wendet Überschreibungen von Arbeitsbereichskompilierungen auf alle Arbeitsbereiche in Ihr Repository.

Kompilierungsüberschreibungen für Arbeitsbereiche bearbeiten

So bearbeiten Sie Überschreibungen von Dataform-Arbeitsbereichskompilierungen:

  1. Rufen Sie in Ihrem Repository die Einstellungen auf.
  2. Klicken Sie auf Bearbeiten.
  3. Bearbeiten Sie die Kompilierungsüberschreibungen des Arbeitsbereichs und klicken Sie dann auf Speichern.

Kompilierungsüberschreibungen für Arbeitsbereiche löschen

So löschen Sie Überschreibungen von Dataform-Arbeitsbereichskompilierungen:

  1. Rufen Sie in Ihrem Repository die Einstellungen auf.
  2. Klicken Sie auf Bearbeiten.
  3. Klicken Sie im Bereich Kompilierungsüberschreibungen für Arbeitsbereiche auf Alle löschen. Klicken Sie dann auf Speichern.

Nächste Schritte