Para receber as permissões necessárias para acionar manualmente uma execução,
peça ao administrador para conceder a você os
seguintes papéis do IAM em workflowInvocations:
Executar manualmente todas as ações no fluxo de trabalho
Para acionar manualmente uma execução de todas as ações no fluxo de trabalho, siga estas etapas:
Acesse um espaço de trabalho de desenvolvimento.
Clique em Iniciar execução.
Clique em Ações > Várias ações.
Na seção Autenticação, autorize a
execução com as credenciais de usuário da sua Conta do Google ou uma conta
de serviço.
Para usar as credenciais de usuário da sua Conta do Google
(Prévia), selecione
Executar com credenciais de usuário.
Para usar uma conta de serviço, selecione
Executar com a conta de serviço selecionada e escolha uma conta.
Selecione Todas as ações.
Opcional: para recriar todas as tabelas do zero, selecione a opção Executar com atualização completa. Sem essa opção, o Dataform
atualiza as tabelas incrementais sem recriá-las do zero.
Clique em Iniciar execução. Se você selecionou Executar com credenciais do usuário como método de autenticação, autorize sua Conta do Google (Prévia).
Executar manualmente as ações selecionadas
Para acionar manualmente uma execução das ações selecionadas, siga estas etapas:
Acesse o espaço de trabalho de desenvolvimento.
Clique em Iniciar execução e faça uma destas ações:
Clique em Ações e selecione uma ação que você quer executar.
Clique em Ações > Várias ações.
Na seção Autenticação, autorize a
execução com as credenciais de usuário da sua Conta do Google ou uma conta
de serviço.
Para usar as credenciais de usuário da sua Conta do Google
(Prévia), selecione
Executar com credenciais de usuário.
Para usar uma conta de serviço, selecione
Executar com a conta de serviço selecionada e escolha uma conta.
Verifique se a opção Seleção de ações está marcada.
No menu Selecionar ações a serem executadas, escolha as ações que você quer executar.
Opcional: para executar as ações selecionadas e as dependências delas,
selecione a opção Incluir dependências.
Opcional: para executar as ações selecionadas e as que dependem delas, selecione a opção Incluir dependentes.
Opcional: para recriar todas as tabelas do zero, selecione a opção Executar com atualização completa.
Clique em Iniciar execução. Se você selecionou Executar com minhas credenciais de usuário como método de autenticação, autorize sua Conta do Google (Prévia).
Executar ações manualmente com tags selecionadas
Para acionar manualmente uma execução de ações com tags selecionadas, siga estas etapas:
Acesse o espaço de trabalho de desenvolvimento.
Clique em Iniciar execução e faça uma destas ações:
Clique em Tags e selecione uma tag que você quer executar.
Clique em Tags > Várias tags.
Na seção Autenticação, autorize a
execução com as credenciais de usuário da sua Conta do Google ou uma conta
de serviço.
Para usar as credenciais de usuário da sua Conta do Google
(Prévia), selecione
Executar com credenciais de usuário.
Para usar uma conta de serviço, selecione
Executar com a conta de serviço selecionada e escolha uma conta.
Verifique se a opção Seleção de tags está marcada.
No menu Selecionar tags a serem executadas, escolha as tags que você quer executar.
Opcional: para executar as ações com as tags selecionadas e as dependências delas, marque a opção Incluir dependências.
Opcional: para executar as ações com as tags selecionadas e as ações
que dependem delas, selecione a opção Incluir dependentes.
Opcional: para recriar todas as tabelas do zero, selecione a opção Executar com atualização completa. Sem essa opção, o Dataform
atualiza as tabelas incrementais sem recriá-las do zero.
Clique em Iniciar execução. Se você selecionou Executar com minhas credenciais de usuário como método de autenticação, autorize sua Conta do Google (Prévia).
Autorizar sua Conta do Google
Para autenticar o recurso com as credenciais de usuário da sua Conta do Google, conceda permissão manualmente para que os pipelines do BigQuery recebam o token de acesso da sua Conta do Google e acessem os dados de origem em seu nome. É possível conceder aprovação manual com a interface da caixa de diálogo do OAuth.
Você só precisa conceder permissão aos pipelines do BigQuery uma vez.
Para revogar a permissão concedida, siga estas etapas:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThis document details how to manually trigger the execution of your SQL workflow in Dataform, including the ability to execute all actions, selected actions, or actions with selected tags.\u003c/p\u003e\n"],["\u003cp\u003eYou can choose to execute all actions within your workflow by navigating to your development workspace and selecting the "All actions" option under "Start execution".\u003c/p\u003e\n"],["\u003cp\u003eTo execute specific actions, you can manually select individual or multiple actions from the "Actions" menu, and optionally include their dependencies or dependents in the execution.\u003c/p\u003e\n"],["\u003cp\u003eExecuting actions based on tags is possible by selecting one or multiple tags from the "Tags" menu, with the option to include dependent or dependencies in the execution.\u003c/p\u003e\n"],["\u003cp\u003eYou can opt to rebuild all tables from scratch using the "Run with full refresh" option when executing actions, or skip the full rebuild to update only incremental tables.\u003c/p\u003e\n"]]],[],null,["# Manually trigger runs\n\nThis document shows you how to manually trigger runs of your entire\nworkflow or only selected elements in your workflow.\n\nYou can trigger a run for the following elements of your workflow:\n\n- All actions in your workflow\n- Selected actions\n- Actions with selected tags\n\nBefore you begin\n----------------\n\n1. In the Google Cloud console, go to the **Dataform** page.\n\n [Go to the Dataform page](https://console.cloud.google.com/bigquery/dataform)\n2. Select or [create a repository](/dataform/docs/create-repository).\n\n3. Select or [create a development workspace](/dataform/docs/create-workspace).\n\n4. Develop your workflow.\n\n### Required roles\n\n\nTo get the permissions that\nyou need to manually trigger a run ,\n\nask your administrator to grant you the\nfollowing IAM roles on workflowInvocations:\n\n- [Dataform Editor](/iam/docs/roles-permissions/dataform#dataform.editor) (`roles/dataform.editor`)\n- [BigQuery Job User](/iam/docs/roles-permissions/bigquery#bigquery.jobUser) (`roles/bigquery.jobUser`)\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nYou might also be able to get\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\nManually run all the actions in your workflow\n---------------------------------------------\n\nTo manually trigger a run of all the actions in your workflow,\nfollow these steps:\n\n1. Go to a development workspace.\n2. Click **Start execution**.\n3. Click **Actions \\\u003e Multiple actions**.\n4. In the **Authentication** section, authorize the\n execution with your Google Account user credentials or a service\n account.\n\n - To use your Google Account user credentials ([Preview](/products#product-launch-stages)), select **Execute with user credentials**.\n - To use a service account, select **Execute with selected service account**, and then select a service account.\n5. Select **All actions**.\n\n6. Optional: To rebuild all tables from scratch, select the\n **Run with full refresh** option. Without this option, Dataform\n updates incremental tables without rebuilding them from scratch.\n\n7. Click **Start execution** . If you selected **Execute with user credentials**\n for your authentication method, you must\n [authorize your Google Account](#authorize-google-account)\n ([Preview](/products#product-launch-stages)).\n\nManually run selected actions\n-----------------------------\n\nTo manually trigger a run of selected actions, follow these steps:\n\n1. Go to your development workspace.\n2. Click **Start execution**, then do either of the following:\n\n - Click **Actions**, then select an action that you want to run.\n - Click **Actions \\\u003e Multiple actions**.\n3. In the **Authentication** section, authorize the\n execution with your Google Account user credentials or a service\n account.\n\n - To use your Google Account user credentials ([Preview](/products#product-launch-stages)), select **Execute with user credentials**.\n - To use a service account, select **Execute with selected service account**, and then select a service account.\n4. Verify that **Selection of actions** is selected.\n\n5. In the **Select actions to execute** menu, select the actions\n that you want to run.\n\n6. Optional: To run the selected actions and their dependencies,\n select the **Include dependencies** option.\n\n7. Optional: To run the selected actions and the actions that\n depend on them, select the **Include dependents** option.\n\n8. Optional: To rebuild all tables from scratch, select\n the **Run with full refresh** option.\n\n9. Click **Start execution** . If you selected **Execute with my user\n credentials** for your authentication method, you must\n [authorize your Google Account](#authorize-google-account)\n ([Preview](/products#product-launch-stages)).\n\nManually run actions with selected tags\n---------------------------------------\n\nTo manually trigger a run of actions with selected tags, follow these\nsteps:\n\n1. Go to your development workspace.\n2. Click **Start execution**, then do either of the following:\n\n - Click **Tags**, then select a tag that you want to run.\n - Click **Tags \\\u003e Multiple tags**.\n3. In the **Authentication** section, authorize the\n execution with your Google Account user credentials or a service\n account.\n\n - To use your Google Account user credentials ([Preview](/products#product-launch-stages)), select **Execute with user credentials**.\n - To use a service account, select **Execute with selected service account**, and then select a service account.\n4. Verify that **Selection of tags** is selected.\n\n5. In the **Select tags to execute** menu, select the tags\n that you want to run.\n\n6. Optional: To run the actions with the selected tags and\n their dependencies, select the **Include dependencies** option.\n\n7. Optional: To run the actions with the selected tags and the actions\n that depend on them, select the **Include dependents** option.\n\n8. Optional: To rebuild all tables from scratch, select\n the **Run with full refresh** option. Without this option, Dataform\n updates incremental tables without rebuilding them from scratch.\n\n9. Click **Start execution** . If you selected **Execute with my user\n credentials** for your authentication method, you must\n [authorize your Google Account](#authorize-google-account)\n ([Preview](/products#product-launch-stages)).\n\nAuthorize your Google Account\n-----------------------------\n\n|\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n| **Note:** To request support or provide feedback for this feature, contact [dataform-preview-support@google.com](mailto:dataform-preview-support@google.com).\n\nTo authenticate the resource with your\n[Google Account](/iam/docs/principals-overview#google-account)\nuser credentials, you must manually grant permission for BigQuery\npipelines to get the access token for your Google Account and access the source\ndata on your behalf. You can grant manual approval with the OAuth dialog\ninterface.\n\nYou only need to give permission to BigQuery pipelines once.\n\nTo revoke the permission that you granted, follow these steps:\n\n1. Go to your [Google Account page](https://myaccount.google.com/).\n2. Click **BigQuery Pipelines**.\n3. Click **Remove access**.\n\n| **Warning:** Revoking access permissions prevents any future pipeline runs that this Google Account owns across all regions.\n\nWhat's next\n-----------\n\n- To learn how Dataform runs incremental tables and how to configure an incremental table, see [Configure an incremental table](/dataform/docs/create-tables#configure-incremental-table).\n- To learn how to view execution logs, see [Monitor execution logs](/dataform/docs/monitor-runs#monitor-execution-logs).\n- To learn how to schedule runs with Workflows and Cloud Scheduler, see [Schedule runs with Workflows and Cloud Scheduler](/dataform/docs/schedule-runs#workflows-cloud-scheduler).\n- To learn how to schedule runs with Cloud Composer, see [Schedule runs with Cloud Composer](/dataform/docs/schedule-runs#composer)."]]
