Aggiungere etichette BigQuery

Questo documento mostra come aggiungere etichette alle tabelle in Dataform.

BigQuery supporta l'aggiunta di etichette alle risorse. Per ulteriori informazioni sulle etichette in BigQuery, consulta Introduzione alle etichette.

Prima di iniziare

  1. Nella console Google Cloud, vai alla pagina Dataform.

    Vai alla pagina Dataform

  2. Seleziona o crea un repository.

  3. Seleziona o crea un'area di lavoro di sviluppo.

  4. Crea una tabella.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per aggiungere un'etichetta BigQuery a una tabella Dataform, chiedi all'amministratore di concederti il ruolo IAM Editor Dataform (roles/dataform.editor) negli spazi di lavoro. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Aggiungere un'etichetta BigQuery

Per aggiungere un'etichetta BigQuery a una tabella in Dataform, aggiungi l'etichetta al blocco bigquery nel blocco config del file SQLX di definizione della tabella.

Per aggiungere un'etichetta BigQuery a un file di definizione della tabella:

  1. Vai allo spazio di lavoro di sviluppo.
  2. Nel riquadro File, espandi definitions/.
  3. Seleziona un file di definizione della tabella SQLX.

  4. Nel blocco config, aggiungi un'etichetta nel seguente formato:

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

    Sostituisci quanto segue:

    • LABEL1: il nome dell'etichetta
    • VALUE_OF_LABEL1: il valore dell'etichetta

  5. (Facoltativo) Per aggiungere un'etichetta con un nome contenente caratteri speciali, inserisci il nome tra virgolette "".

  6. (Facoltativo) Fai clic su Formato.

Il seguente esempio di codice mostra le etichette department:shipping e cost-center:logistics aggiunte al blocco bigquery in un file SQLX di definizione della tabella partizionata:

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

SELECT CURRENT_TIMESTAMP() AS ts

Passaggi successivi