Ajouter des libellés BigQuery

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

BigQuery permet d'ajouter des libellés aux ressources. Pour en savoir plus sur les libellés dans BigQuery, consultez la page Présentation des libellés.

Avant de commencer

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

    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 accorder le rôle IAM Éditeur Dataform (roles/dataform.editor) sur les espaces de travail. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

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

Ajouter un libellé 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 la table.

Pour ajouter un libellé 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 un libellé 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 étiquette

  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

Étape suivante