Ausführungs-Tags hinzufügen

In diesem Dokument wird erläutert, wie Sie SQLX-Dateien in Dataform Core-Tags Tags hinzufügen, um den SQL-Workflow zu kategorisieren.

Wenn Sie Komponenten Ihres SQL-Workflows in Sammlungen organisieren möchten, können Sie den SQLX-Dateien der folgenden Typen benutzerdefinierte Tags hinzufügen:

  • table
  • view
  • incremental
  • assertion
  • operations

Während der Workflowausführung können Sie nur Dateien mit einem ausgewählten Tag ausführen.

Mit Cloud Composer oder Workflows zusammen mit Cloud Scheduler können Sie einen Zeitplan erstellen, der einen Dataform-Workflow mit einem ausgewählten Tag in einem bestimmten Intervall ausführt.

Hinweis

  1. Rufen Sie in der Google Cloud Console die Seite Dataform auf.

    Zur Dataform-Seite

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

  3. Wählen Sie einen Entwicklungsarbeitsbereich aus oder erstellen Sie einen.

  4. Definieren Sie eine SQLX-Datei mit einem der folgenden Typen:

Erforderliche Rollen

Wenn Sie die Berechtigungen zum Hinzufügen eines Tags zu einer Tabelle benötigen, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Dataform-Bearbeiter (roles/dataform.editor) für Arbeitsbereiche zu gewähren. 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.

Tag hinzufügen

Sie können einer SQLX-Datei mehrere Tags hinzufügen.

So fügen Sie einer SQLX-Datei ein Tag hinzu:

  1. Rufen Sie den Entwicklungsarbeitsbereich auf.
  2. Maximieren Sie im Bereich Dateien den Bereich definitions/.
  3. Wählen Sie eine SQLX-Datei aus.

  4. Fügen Sie im config-Block ein Tag im folgenden Format ein:

    tags: ["CUSTOM_TAG"]

    Ersetzen Sie CUSTOM_TAG durch das Tag.

  5. Optional: Wenn Sie mehrere Tags hinzufügen möchten, trennen Sie sie durch ein Komma ,.

Im folgenden Codebeispiel sehen Sie die Ansicht user_counts mit den Tags daily und hourly:

config {
  type: "view",
  name: "user_counts",
  tags: ["daily", "hourly"]
}

Nächste Schritte