Para obtener los permisos que
necesitas para activar manualmente una ejecución,
pídele a tu administrador que te otorgue los
siguientes roles de IAM en workflowInvocations:
Ejecuta manualmente todas las acciones de tu flujo de trabajo
Para activar manualmente una ejecución de todas las acciones de tu flujo de trabajo, sigue estos pasos:
Ve a un espacio de trabajo de desarrollo.
Haz clic en Iniciar ejecución.
Haz clic en Acciones > Acciones múltiples.
En la sección Autenticación, autoriza la ejecución con las credenciales de usuario de tu Cuenta de Google o una cuenta de servicio.
Para usar las credenciales de usuario de tu Cuenta de Google (versión preliminar), selecciona Ejecutar con credenciales de usuario.
Para usar una cuenta de servicio, selecciona Ejecutar con la cuenta de servicio seleccionada y, luego, elige una cuenta de servicio.
Selecciona Todas las acciones.
Opcional: Para volver a compilar todas las tablas desde cero, selecciona la opción Ejecutar con actualización completa. Sin esta opción, Dataform actualiza las tablas incrementales sin volver a compilarlas desde cero.
Cómo ejecutar acciones de forma manual con etiquetas seleccionadas
Para activar manualmente una ejecución de acciones con etiquetas seleccionadas, sigue estos pasos:
Ve a tu espacio de trabajo de desarrollo.
Haz clic en Iniciar ejecución y, luego, realiza una de las siguientes acciones:
Haz clic en Etiquetas y, luego, selecciona la etiqueta que deseas ejecutar.
Haz clic en Etiquetas > Varias etiquetas.
En la sección Autenticación, autoriza la ejecución con las credenciales de usuario de tu Cuenta de Google o una cuenta de servicio.
Para usar las credenciales de usuario de tu Cuenta de Google (versión preliminar), selecciona Ejecutar con credenciales de usuario.
Para usar una cuenta de servicio, selecciona Ejecutar con la cuenta de servicio seleccionada y, luego, elige una cuenta de servicio.
Verifica que esté seleccionada la opción Selección de etiquetas.
En el menú Seleccionar etiquetas para ejecutar, selecciona las etiquetas que deseas ejecutar.
Opcional: Para ejecutar las acciones con las etiquetas seleccionadas y sus dependencias, selecciona la opción Incluir dependencias.
Opcional: Para ejecutar las acciones con las etiquetas seleccionadas y las acciones que dependen de ellas, selecciona la opción Incluir dependientes.
Opcional: Para volver a compilar todas las tablas desde cero, selecciona la opción Ejecutar con actualización completa. Sin esta opción, Dataform actualiza las tablas incrementales sin volver a compilarlas desde cero.
Para autenticar el recurso con las credenciales de usuario de tu Cuenta de Google, debes otorgar permiso de forma manual a las canalizaciones de BigQuery para obtener el token de acceso de tu Cuenta de Google y acceder a los datos de origen en tu nombre. Puedes otorgar la aprobación manual con la interfaz del diálogo de OAuth.
Solo debes otorgar permiso a las canalizaciones de BigQuery una vez.
Para revocar el permiso que otorgaste, sigue estos pasos:
Para obtener información sobre cómo Dataform ejecuta tablas incrementales y cómo configurar una tabla incremental, consulta Configura una tabla incremental.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)."]]
