Ajouter des étiquettes BigQuery

Ce document explique comment ajouter des étiquettes aux tableaux dans Dataform.

BigQuery accepte l'ajout de libellés aux ressources. Pour en savoir plus sur les étiquettes dans BigQuery, consultez la page Présentation des étiquettes.

Avant de commencer

  1. Dans la console Google Cloud, accédez à la page Dataform.

    Accéder à la page Dataform

  2. Sélectionnez ou créez un dépôt.

  3. Sélectionnez ou créez un espace de travail de développement.

  4. Créez une table.

Rôles requis

Pour obtenir les autorisations nécessaires pour ajouter un libellé BigQuery à une table Dataform, demandez à votre administrateur de vous attribuer le rôle IAM Éditeur de données (roles/dataform.editor) sur les espaces de travail. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Ajouter une étiquette BigQuery

Pour ajouter un libellé BigQuery à une table dans Dataform, ajoutez-le au bloc bigquery dans le bloc config du fichier SQLX de définition de table.

Pour ajouter une étiquette BigQuery à un fichier de définition de table, procédez comme suit:

  1. Accédez à votre espace de travail de développement.
  2. Dans le volet Fichiers, développez definitions/.
  3. Sélectionnez un fichier de définition de table SQLX.

  4. Dans le bloc config, ajoutez une étiquette au format suivant:

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

    Remplacez les éléments suivants :

    • LABEL1: nom de votre libellé.
    • VALUE_OF_LABEL1: valeur de votre libellé.

  5. Facultatif: Pour ajouter un libellé dont le nom contient des caractères spéciaux, saisissez le nom du libellé entre guillemets "".

  6. (Facultatif) Cliquez sur Format.

L'exemple de code suivant montre les étiquettes department:shipping et cost-center:logistics ajoutées au bloc bigquery dans un fichier SQLX de définition de table partitionnée:

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

SELECT CURRENT_TIMESTAMP() AS ts

Étapes suivantes