Ajouter des étiquettes BigQuery

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

BigQuery permet d'ajouter des étiquettes aux ressources. Pour en savoir plus sur les étiquettes dans BigQuery, consultez 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 formulaires Data (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 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"
    }
  }

  5. Remplacez LABEL1 par le nom de votre libellé.

  6. Remplacez VALUE_OF_LABEL1 par la valeur de votre libellé.

  7. Facultatif: pour ajouter un libellé portant un nom contenant des caractères spéciaux, saisissez le nom du libellé entre guillemets "".

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