Este documento mostra como acionar manualmente execuções de todo o fluxo de trabalho ou apenas de elementos selecionados.
É possível acionar uma execução para os seguintes elementos do fluxo de trabalho:
- Todas as ações no seu fluxo de trabalho
- Ações selecionadas
- Ações com tags selecionadas
Antes de começar
No Google Cloud console, acesse a página Dataform.
Selecione ou crie um repositório.
Selecione ou crie um espaço de trabalho de desenvolvimento.
Desenvolva seu fluxo de trabalho.
Funções exigidas
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:
-
Editor do Dataform (
roles/dataform.editor
) -
Usuário de jobs do BigQuery (
roles/bigquery.jobUser
)
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.
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 o seguinte:
- 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 o seguinte:
- 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, selecione 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 suas credenciais de usuário da 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:
- Acesse a página da sua Conta do Google.
- Clique em Pipelines do BigQuery.
- Clique em Remover acesso.
A seguir
- Para saber como o Dataform executa tabelas incrementais e como configurar uma tabela incremental, consulte Configurar uma tabela incremental.
- Para saber como visualizar registros de execução, consulte Monitorar registros de execução.
- Para saber como programar execuções com o Workflows e o Cloud Scheduler, consulte Programar execuções com o Workflows e o Cloud Scheduler.
- Para saber como programar execuções com o Cloud Composer, consulte Programar execuções com o Cloud Composer.