Ausführungs-Tags hinzufügen

In diesem Dokument erfahren Sie, wie Sie Tags zu Dataform Core SQLX-Dateien hinzufügen, um Ihren SQL-Workflow zu kategorisieren.

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

  • 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 mit Cloud Scheduler können Sie einen Zeitplan erstellen, der einen Dataform-Workflow mit einem ausgewählten Tag in einem bestimmten Intervall ausführt.

Hinweise

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

    Zur Seite „Dataform“

  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

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Dataform Editor (roles/dataform.editor) für Arbeitsbereiche zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Hinzufügen eines Tags in eine Tabelle benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie 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 Ihren Entwicklungsarbeitsbereich auf.
  2. Maximieren Sie im Bereich Dateien die Option definitions/.
  3. Wählen Sie eine SQLX-Datei aus.

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

    tags: ["CUSTOM_TAG"]

    Ersetzen Sie CUSTOM_TAG durch Ihr Tag.

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

  6. Optional: Klicken Sie auf Format.

Das folgende Codebeispiel zeigt die Ansicht user_counts mit den Tags daily und hourly:

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

Nächste Schritte