BigQuery-Labels hinzufügen

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

BigQuery unterstützt das Hinzufügen von Labels zu Ressourcen. Weitere Informationen zu Labels in BigQuery finden Sie unter Einführung in Labels.

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. Erstellen Sie eine Tabelle.

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 BigQuery-Labels zu einer Dataform-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.

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 für die Tabellendefinition hinzu.

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

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

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

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

    Ersetzen Sie Folgendes:

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

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

  6. Optional: Klicken Sie auf Format.

Das folgende Codebeispiel zeigt die Labels department:shipping und cost-center:logistics, die dem Block bigquery in einer SQLX-Definitionsdatei 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