BigQuery-Labels hinzufügen

In diesem Dokument erfahren Sie, wie Sie Tabellen in Dataform Labels hinzufügen.

In BigQuery können Ressourcen Labels hinzugefügt werden. Weitere Informationen zu Labels in BigQuery finden Sie unter Einführung in Labels.

Hinweis

  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 neues.

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

  4. Tabelle erstellen

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Dataform Editor (roles/dataform.editor) für Arbeitsbereiche zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Hinzufügen eines BigQuery-Labels zu einer Dataform-Tabelle benötigen. 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.

BigQuery-Label hinzufügen

Wenn Sie einer Tabelle in Dataform ein BigQuery-Label hinzufügen möchten, fügen Sie das Label dem Block bigquery im Block config der SQLX-Datei der Tabellendefinition hinzu.

So fügen Sie einer Tabellendefinitionsdatei ein BigQuery-Label hinzu:

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

  4. Fügen Sie im Block config ein Label im folgenden Format hinzu:

    bigquery: {
    labels: {
      LABEL1: "VALUE_OF_LABEL1"
    }
  }

    Ersetzen Sie Folgendes:

    • LABEL1: der Name Ihres Labels
    • VALUE_OF_LABEL1: der Wert Ihres Labels

  5. Optional: Wenn Sie ein Label mit einem Namen hinzufügen möchten, der Sonderzeichen enthält, setzen Sie den Labelnamen in Anführungszeichen "".

  6. Optional: Klicken Sie auf Formatieren.

Im folgenden Codebeispiel sind die Labels department:shipping und cost-center:logistics zu sehen, die dem Block bigquery in einer SQLX-Datei mit einer Definition für partitionierte Tabellen hinzugefügt wurden:

config {
  type: "table",
  bigquery: {
    partitionBy: "DATE(ts)",
    labels: {
      department: "shipping",
      "cost-center": "logistics"
    }
  }
}

SELECT CURRENT_TIMESTAMP() AS ts

Nächste Schritte