Releasekonfiguration erstellen

In diesem Dokument erfahren Sie, wie Sie eine Releasekonfiguration in Dataform zur Konfiguration von Vorlagen für Kompilierungseinstellungen, die Sie nach einem Zeitplan ausführen können. Mit Releasekonfigurationen können Sie Ausführungsumgebungen konfigurieren, z. B. Staging und Produktion.

Dataform-Releasekonfigurationen

Zum Ausführen von SQL-Workflows in BigQuery kompiliert Dataform SQL in ein Kompilierungsergebnis umwandeln. Dieser Vorgang erfolgt automatisch, wenn Sie einen SQL-Workflow entwickeln in einem Dataform-Arbeitsbereich.

Mit Releasekonfigurationen können Sie Kompilierungsergebnisse anpassen. Sie können sie verwenden, um Ausführungsumgebungen zu erstellen, z. B. Staging.

Konfigurationseinstellungen für Release

In einer Releasekonfiguration können Sie Kompilierungsüberschreibungen Workfloweinstellungen und die Häufigkeit der Kompilierung der Erstellung von Kompilierungsergebnissen.

Eine Dataform-Releasekonfiguration enthält Folgendes: Kompilierungseinstellungen:

Release-Einstellungen
Versions-ID, Git Commitish für Kompilierungsergebnisse und Häufigkeit der Erstellung von Kompilierungsergebnissen. Die Häufigkeit ist eine optionale Einstellung. Wenn festgelegt, beträgt die Mindesthäufigkeit 1 Stunde.
Kompilierungsüberschreibungen
Überschreibungen von Google Cloud Projekt, Tabellenpräfix, Schemasuffix und Kompilierungsvariablen Workfloweinstellungen.

So funktioniert eine Releasekonfiguration

Dataform erstellt Kompilierungsergebnisse aus einer Releasekonfiguration unter der angegebenen Frequenz entsprechen oder wenn Sie die Kompilierung auslösen. Die Häufigkeit ist eine optionale Einstellung, eine Releasekonfiguration zu erstellen. Wenn festgelegt, beträgt die Mindesthäufigkeit 1 Stunde. Sie können die Kompilierung manuell auf der Seite Release-Konfigurationsdetails auslösen, oder die Kompilierung mit der Dataform API releaseConfigs auslösen.

Während der Kompilierung ruft Dataform Code aus dem angegebenen Git-Commitish Ihres Repositorys. Dann kompiliert Dataform den Code mit den angewendeten Kompilierungsüberschreibungen (sofern vorhanden) und erstellt das Kompilierungsergebnis. Das neueste Kompilierungsergebnis, das für den Release erstellt wurde Konfiguration ist das Ergebnis der Live-Kompilierung.

Sie können Ausführungen von Kompilierungsergebnissen aus Releasekonfigurationen planen in Workflowkonfigurationen implementieren. Sie können auch eine ausgewählte Releasekonfiguration ausführen. außerhalb des Zeitplans liegen. Während einer Workflowkonfiguration führt Dataform den Live-Kompilierungsergebnis der ausgewählten Releasekonfiguration.

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: So überschreiben Sie das Google Cloud-Standardprojekt im Releasekonfiguration, Dataform-Dienstkonto Zugriff gewähren dem Google Cloud-Projekt hinzu, das Sie verwenden möchten.

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Erstellen einer Releasekonfiguration benötigen, bitten Sie Ihren Administrator, Ihnen IAM-Rolle Dataform Editor (roles/dataform.editor) 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.

Releasekonfiguration erstellen

So erstellen Sie eine Dataform-Releasekonfiguration:

  1. Gehen Sie in Ihrem Repository zu Releases und Planung.
  2. Klicken Sie im Abschnitt Release-Konfigurationen auf Erstellen.

  3. Konfigurieren Sie im Bereich Releasekonfiguration erstellen die Releaseeinstellungen.

    1. Geben Sie im Feld Release-ID eine eindeutige ID für die Releasekonfiguration ein.

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

    2. Geben Sie im Feld Git Commitish den Git-Branch oder das Git-Commit ein. SHA für die Veröffentlichung.

    In einem Dataform-Repository, das nicht mit einem Remote-Repository verbunden ist, ist der Wert immer main.

    1. Optional: Wählen Sie im Drop-down-Menü Häufigkeit die gewünschte Option aus. Häufigkeit der Erstellung von Kompilierungsergebnissen.

      Wenn festgelegt, beträgt die Mindesthäufigkeit 1 Stunde.

  4. Optional: Konfigurieren Sie im Abschnitt Kompilierungsüberschreibungen die Kompilierungseinstellungen.

    1. Geben Sie im Feld Google Cloud-Projekt-ID die ID der Google Cloud Projekt, in dem Sie das Kompilierungsergebnis speichern möchten.
    2. Geben Sie im Feld Schemasuffix ein Suffix ein, das an die das Schema, das in den Workfloweinstellungen konfiguriert wurde.
    3. Geben Sie im Feld Tabellenpräfix ein Präfix für alle Tabellennamen ein.

  5. Optional: Legen Sie im Bereich Kompilierungsvariablen die Kompilierungsvariablen fest.

    1. Klicken Sie auf Variable hinzufügen.
    2. Geben Sie im Feld Schlüssel die Kompilierungsvariable ein.
    3. Geben Sie im Feld Wert den Wert für die Kompilierungsvariable ein.
    4. Klicken Sie auf Variable hinzufügen, um eine weitere Kompilierungsvariable hinzuzufügen.

  6. Klicken Sie auf Erstellen.

Wenn Sie das Google Cloud-Standardprojekt überschreiben, Ihr Dataform-Dienstkonto Zugriff hat dem Google Cloud-Projekt hinzu, das in der Releasekonfiguration festgelegt wurde.



Die folgende Releasekonfiguration erstellt beispielsweise eine production stündlich Kompilierungsergebnis vom main-Zweig, ohne Kompilierungsüberschreibungen:

  • Release-ID: production
  • Git Commitish: main
  • Häufigkeit: stündlich
  • keine Kompilierungsüberschreibungen

Details einer Releasekonfiguration ansehen

Sie können die folgenden Details einer Releasekonfiguration ansehen:

  • Release-Einstellungen
    • Git Commitish
    • Zeitstempel des letzten Kompilierungsergebnisses
    • Cron-Zeitplan
    • Kompilierungsüberschreibungen
    • Kompilierungsvariablen
  • Ergebnis der Live-Kompilierung
    • Zeitstempel der Erstellung
    • Git Commitish
    • Commit für SHA
  • Frühere Kompilierungsergebnisse

So rufen Sie die Details einer Releasekonfiguration auf:

  1. Gehen Sie in Ihrem Repository zu Releases und Planung.
  2. Wählen Sie eine Releasekonfiguration aus.
  3. Prüfen Sie auf der Seite Release-Konfigurationsdetails die Details. der Releasekonfiguration.

Die Tabelle Ergebnisse der geplanten Kompilierung enthält frühere Kompilierungsergebnisse. durch die Releasekonfiguration automatisch erstellt wird.

Die Tabelle Ergebnisse der manuellen/API-Kompilierung enthält Kompilierungsergebnisse manuell oder durch Aufrufe der Dataform API mit den neuesten 1.000 Komplizierungsergebnisse im Repository.

Kompilierung manuell auslösen

So erstellen Sie manuell ein Kompilierungsergebnis aus einer ausgewählten Releasekonfiguration: führen Sie folgende Schritte aus:

  1. Gehen Sie in Ihrem Repository zu Releases und Planung.
  2. Wählen Sie eine Releasekonfiguration aus.
  3. Klicken Sie auf der Seite Release-Konfigurationsdetails auf Neue Kompilierung.

Das neu erstellte Kompilierungsergebnis wird zum Live-Ergebnis. für diese Releasekonfiguration.

Die Ergebnisse der manuellen Kompilierung werden in der Tabelle mit Ergebnissen der manuellen/API-Kompilierung auf der Seite Release-Konfigurationsdetails:

Ausführung einer Releasekonfiguration auslösen

Zum Auslösen der Live-Kompilierung führt das zu einem ausgewählten in BigQuery veröffentlichen möchten, führen Sie die folgenden Schritte aus:

  1. Gehen Sie in Ihrem Repository zu Releases und Planung.
  2. Klicken Sie im Abschnitt Release-Konfigurationen auf Ausführung starten.
  3. im Bereich Manuellen Workflow ausführen unter Release-Konfiguration und wählen Sie eine Releasekonfiguration aus.
  4. Wählen Sie die auszuführenden SQL-Workflowaktionen aus:
    1. Klicken Sie auf Alle Aktionen, um den gesamten SQL-Workflow auszuführen.
    2. So führen Sie ausgewählte Aktionen im SQL-Workflow aus: Klicken Sie auf Auswahl von Aktionen und wählen Sie dann Aktionen aus.
    3. Um Aktionen mit ausgewählten Tags auszuführen, klicken Sie auf Auswahl von Tags und wählen Sie dann Tags aus.
  5. Optional: So führen Sie ausgewählte Aktionen oder Tags und ihre Abhängigkeiten aus: Wählen Sie die Option Abhängigkeiten einbeziehen aus.
  6. Optional: Um ausgewählte Aktionen oder Tags und ihre abhängigen Aktionen oder Tags auszuführen, wählen Sie die Option Abhängige Elemente einbeziehen aus.

  7. Optional: Wenn Sie alle Tabellen von Grund auf neu erstellen möchten, wählen Sie das Symbol Option Mit vollständiger Aktualisierung ausführen:

    Ohne diese Option aktualisiert Dataform inkrementelle Tabellen ohne von Grund auf neu erstellen.

  8. Klicken Sie auf Ausführung starten.

Releasekonfiguration bearbeiten

So bearbeiten Sie eine Releasekonfiguration:

  1. Gehen Sie in Ihrem Repository zu Releases und Planung.
  2. Klicken Sie neben der Releasekonfiguration, die Sie bearbeiten möchten, auf das Mehr und dann auf Bearbeiten.
  3. Bearbeiten Sie im Bereich Releasekonfiguration bearbeiten die Releasekonfiguration. und dann auf Speichern.

Releasekonfiguration löschen

So löschen Sie eine Releasekonfiguration:

  1. Gehen Sie in Ihrem Repository zu Releases und Planung.
  2. Klicken Sie neben der Releasekonfiguration, die Sie löschen möchten, auf das Mehr und dann auf Löschen.
  3. Klicken Sie im Dialogfeld Releasekonfiguration löschen auf Löschen.

Nächste Schritte