Ajouter des tags d'exécution

Ce document explique comment ajouter des balises aux fichiers SQLX du noyau Dataform pour catégoriser votre workflow SQL.

Pour organiser les composants de votre workflow SQL en collections, vous pouvez ajouter des balises personnalisées aux fichiers SQLX des types suivants:

  • table
  • view
  • incremental
  • assertion
  • operations

Lors de l'exécution du workflow, vous ne pouvez exécuter que les fichiers associés à une balise sélectionnée.

Avec Cloud Composer ou Workflows avec Cloud Scheduler, vous pouvez créer une planification qui exécute un workflow Dataform avec une balise sélectionnée à un intervalle spécifique.

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. Définissez un fichier SQLX de l'un des types suivants:

Rôles requis

Pour obtenir les autorisations nécessaires pour ajouter une balise à une table, 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.

Taguer

Vous pouvez ajouter plusieurs balises à un fichier SQLX.

Pour ajouter une balise à un fichier SQLX, 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 SQLX.

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

    tags: ["CUSTOM_TAG"]

    Remplacez CUSTOM_TAG par votre balise.

  5. Facultatif: Pour ajouter plusieurs balises, séparez-les par une virgule ,.

  6. Facultatif: cliquez sur Format.

L'exemple de code suivant montre la vue user_counts avec les balises daily et hourly:

config {
  type: "view",
  name: "user_counts",
  tags: ["daily", "hourly"]
}

Étape suivante