Ce document explique comment déclencher manuellement des exécutions de l'ensemble de votre workflow ou uniquement de certains éléments de celui-ci.
Vous pouvez déclencher une exécution pour les éléments suivants de votre workflow :
- Toutes les actions de votre workflow
- Actions sélectionnées
- Actions avec des tags sélectionnés
Avant de commencer
Dans la Google Cloud console, accédez à la page Dataform.
Sélectionnez ou créez un dépôt.
Sélectionnez ou créez un espace de travail de développement.
Développez votre workflow.
Rôles requis
Pour obtenir les autorisations nécessaires pour déclencher manuellement une exécution, demandez à votre administrateur de vous accorder les rôles IAM suivants :
-
Éditeur Dataform (
roles/dataform.editor) sur le dépôt Dataform -
Utilisateur de job BigQuery (
roles/bigquery.jobUser) sur le projet -
Pour utiliser un compte de service personnalisé pour l'exécution :
Utilisateur du compte de service (
roles/iam.serviceAccountUser) sur le compte de service personnalisé
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
Exécuter manuellement toutes les actions de votre workflow
Pour déclencher manuellement une exécution de toutes les actions de votre workflow, procédez comme suit :
- Accédez à un espace de travail de développement.
- Cliquez sur Démarrer l'exécution.
- Cliquez sur Actions > Plusieurs actions.
Dans la section Authentification, autorisez l'exécution avec les identifiants utilisateur de votre compte Google ou un compte de service.
- Pour utiliser les identifiants utilisateur de votre compte Google (preview), sélectionnez Exécuter avec les identifiants utilisateur.
Pour utiliser un compte de service personnalisé, sélectionnez Exécuter avec le compte de service sélectionné, puis sélectionnez un compte de service personnalisé.
Sélectionnez Toutes les actions.
Facultatif : Pour recréer toutes les tables à partir de zéro, sélectionnez l'option Exécuter avec une actualisation complète. Sans cette option, Dataform met à jour les tables incrémentielles sans les recréer à partir de zéro.
Facultatif : Définissez la priorité du job de requête BigQuery avec l'option Exécuter en tant que job interactif avec une priorité élevée (par défaut). Par défaut, BigQuery exécute les requêtes en tant que jobs de requête interactifs, qui sont conçus pour démarrer le plus rapidement possible. Si vous décochez cette option, les requêtes sont exécutées en tant que jobs de requête par lot, qui ont une priorité inférieure.
Cliquez sur Démarrer l'exécution. Si vous avez sélectionné Exécuter avec les identifiants utilisateur comme méthode d'authentification, vous devez autoriser votre compte Google (preview).
Exécuter manuellement les actions sélectionnées
Pour déclencher manuellement une exécution des actions sélectionnées, procédez comme suit :
- Accédez à votre espace de travail de développement.
Cliquez sur Démarrer l'exécution, puis effectuez l'une des opérations suivantes :
- Cliquez sur Actions, puis sélectionnez une action que vous souhaitez exécuter.
- Cliquez sur Actions > Plusieurs actions.
Dans la section Authentification, autorisez l'exécution avec les identifiants utilisateur de votre compte Google ou un compte de service.
- Pour utiliser les identifiants utilisateur de votre compte Google (preview), sélectionnez Exécuter avec les identifiants utilisateur.
Pour utiliser un compte de service personnalisé, sélectionnez Exécuter avec le compte de service sélectionné, puis sélectionnez un compte de service personnalisé.
Vérifiez que l'option Sélection d'actions est sélectionnée.
Dans le menu Sélectionner les actions à exécuter, sélectionnez les actions que vous souhaitez exécuter.
Facultatif : Pour exécuter les actions sélectionnées et leurs dépendances, sélectionnez l'option Inclure les dépendances.
Facultatif : Pour exécuter les actions sélectionnées et les actions qui en dépendent, sélectionnez l'option Inclure les dépendants.
Facultatif : Pour recréer toutes les tables à partir de zéro, sélectionnez l'option Exécuter avec une actualisation complète.
Facultatif : Définissez la priorité du job de requête BigQuery avec l'option Exécuter en tant que job interactif avec une priorité élevée (par défaut). Par défaut, BigQuery exécute les requêtes en tant que jobs de requête interactifs, qui sont conçus pour démarrer le plus rapidement possible. Si vous décochez cette option, les requêtes sont exécutées en tant que jobs de requête par lot, qui ont une priorité inférieure.
Cliquez sur Démarrer l'exécution. Si vous avez sélectionné Exécuter avec mes identifiants utilisateur comme méthode d'authentification, vous devez autoriser votre compte Google (preview).
Exécuter manuellement les actions avec des tags sélectionnés
Pour déclencher manuellement une exécution des actions avec des tags sélectionnés, procédez comme suit :
- Accédez à votre espace de travail de développement.
Cliquez sur Démarrer l'exécution, puis effectuez l'une des opérations suivantes :
- Cliquez sur Tags, puis sélectionnez un tag que vous souhaitez exécuter.
- Cliquez sur Tags > Plusieurs tags.
Dans la section Authentification, autorisez l'exécution avec les identifiants utilisateur de votre compte Google ou un compte de service.
- Pour utiliser les identifiants utilisateur de votre compte Google (preview), sélectionnez Exécuter avec les identifiants utilisateur.
Pour utiliser un compte de service personnalisé, sélectionnez Exécuter avec le compte de service sélectionné, puis sélectionnez un compte de service personnalisé.
Vérifiez que l'option Sélection de tags est sélectionnée.
Dans le menu Sélectionner les tags à exécuter, sélectionnez les tags que vous souhaitez exécuter.
Facultatif : Pour exécuter les actions avec les tags sélectionnés et leurs dépendances, sélectionnez l'option Inclure les dépendances.
Facultatif : Pour exécuter les actions avec les tags sélectionnés et les actions qui en dépendent, sélectionnez l'option Inclure les dépendants.
Facultatif : Pour recréer toutes les tables à partir de zéro, sélectionnez l'option Exécuter avec une actualisation complète. Sans cette option, Dataform met à jour les tables incrémentielles sans les recréer à partir de zéro.
Facultatif : Définissez la priorité du job de requête BigQuery avec l'option Exécuter en tant que job interactif avec une priorité élevée (par défaut). Par défaut, BigQuery exécute les requêtes en tant que jobs de requête interactifs, qui sont conçus pour démarrer le plus rapidement possible. Si vous décochez cette option, les requêtes sont exécutées en tant que jobs de requête par lot, qui ont une priorité inférieure.
Cliquez sur Démarrer l'exécution. Si vous avez sélectionné Exécuter avec mes identifiants utilisateur comme méthode d'authentification, vous devez autoriser votre compte Google (preview).
Autoriser votre compte Google
Pour authentifier la ressource avec les identifiants utilisateur de votre compte Google, vous devez accorder manuellement l'autorisation aux pipelines BigQuery d'obtenir le jeton d'accès pour votre compte Google et d'accéder aux données sources en votre nom. Vous pouvez accorder une approbation manuelle à l'aide de l'interface de la boîte de dialogue OAuth.
Vous n'avez besoin d'autoriser les pipelines BigQuery qu'une seule fois.
Pour révoquer l'autorisation que vous avez accordée, procédez comme suit :
- Accédez à la page de votre compte Google.
- Cliquez sur Pipelines BigQuery.
- Cliquez sur Supprimer l'accès.
Étape suivante
- Pour découvrir comment Dataform exécute les tables incrémentielles et comment configurer une table incrémentielle, consultez Configurer une table incrémentielle.
- Pour découvrir comment afficher les journaux d'exécution, consultez Surveiller les journaux d'exécution.
- Pour découvrir comment planifier des exécutions avec Workflows et Cloud Scheduler, consultez Planifier des exécutions avec Workflows et Cloud Scheduler.
- Pour découvrir comment planifier des exécutions avec Managed Service pour Apache Airflow, consultez Planifier des exécutions avec Managed Service pour Apache Airflow.