EXECUTE TASK¶
Aciona manualmente uma única execução assíncrona de uma tarefa (seja uma tarefa isolada ou a tarefa raiz em um gráfico de tarefas) independente do agendamento definido para a tarefa.
Uma execução bem-sucedida de uma tarefa raiz aciona uma execução em cascata de tarefas filhas no gráfico de tarefas quando a tarefa anterior é concluída, como se a tarefa raiz tivesse sido executada em seu cronograma definido.
Além disso, você pode acionar manualmente a reexecução de uma tarefa que falhou anteriormente.
- Consulte também:
Sintaxe¶
EXECUTE TASK <name>
EXECUTE TASK <name> RETRY LAST
Parâmetros¶
name
Identificador da tarefa autônoma ou da tarefa raiz a ser executada. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.
RETRY LAST
Execute novamente a última tarefa com falha do gráfico de tarefa com
name
reiniciando de onde as tarefas falharam.Para reexecutar uma tarefa, as seguintes condições devem ser atendidas:
A última execução do gráfico de tarefas deve estar no estado FAILED ou CANCELED.
O gráfico de tarefas não deve ter sido modificado desde a última execução.
O gráfico de tarefas deve ter sido executado ou tentado novamente nos últimos 14 dias.
Para visualizar o histórico de tarefas, consulte a função de tabela TASK_HISTORY ou o histórico de tarefas do Snowsight.
Nota
RETRY LAST cria uma nova execução de gráfico que inicia a execução nas últimas tarefas com falha.
Especificamente, todas as execuções de tarefas FAILED ou CANCELED serão imediatamente reexecutadas e as tarefas filhas associadas serão agendadas se todas as suas predecessoras forem executadas com êxito.
Além disso, a nova execução do gráfico de tarefas produzida pela nova tentativa terá um ATTEMPT NUMBER maior que a execução do gráfico com falha anterior e compartilhará o mesmo GRAPH_RUN_GROUP_ID que a tentativa repetida ou a execução do gráfico de tarefas original.
Notas de uso¶
A execução de uma tarefa exige o privilégio OWNERSHIP ou OPERATE sobre a tarefa.
Quando o comando EXECUTE TASK aciona uma tarefa, o Snowflake verifica se a função com o privilégio OWNERSHIP na tarefa também tem o privilégio USAGE no warehouse atribuído à tarefa, bem como o privilégio global EXECUTE TASK; caso contrário, um erro será produzido.
As tarefas sempre são executadas com os privilégios da função original do proprietário, mesmo que uma função diferente com o privilégio OPERATE use EXECUTE TASK para executar a tarefa.
O comando SQL só pode executar uma tarefa isolada ou a tarefa raiz em um gráfico de tarefas. Se uma tarefa filho for inserida, o comando retornará um erro do usuário.
A execução manual de uma tarefa autônoma ou raiz estabelece uma versão da tarefa. A tarefa autônoma ou todo o gráfico de tarefas conclui sua execução com essa versão. Para obter mais informações sobre as versões de tarefas, consulte Controle de versão de execuções de tarefas.
Uma tarefa raiz suspensa é executada sem retomar a tarefa; não há necessidade de retomar explicitamente a tarefa raiz antes de executar este comando SQL. Entretanto, EXECUTE TASK não retoma automaticamente as tarefas secundárias no gráfico de tarefas. O comando ignora qualquer tarefa secundária que seja suspensa.
Para retomar recursivamente todas as tarefas dependentes vinculadas a uma tarefa raiz em um gráfico de tarefas, consulte a função SYSTEM$TASK_DEPENDENTS_ENABLE em vez de habilitar cada tarefa individualmente (usando ALTER TASK … RESUME).
Como prática recomendada ao testar gráficos de tarefas novos ou modificados, defina a tarefa raiz a ser executada em seu cronograma de produção pretendido, mas deixe-a em um estado suspenso. Quando você tiver testado o gráfico de tarefas com sucesso, retome a tarefa raiz. Observe que você deve retomar qualquer tarefa filho suspensa no gráfico de tarefas para testes; caso contrário, elas serão puladas durante a execução do gráfico de tarefas.
Se nenhuma instância da tarefa estiver em execução, uma nova execução será iniciada imediatamente.
Se outra instância estiver agendada (ou seja, se a tarefa mostrar um estado SCHEDULED na saída TASK_HISTORY), a execução solicitada substituirá a execução agendada. A execução solicitada começa imediatamente, usando o carimbo de data/hora atual como a hora programada.
Se a tarefa ou o gráfico de tarefas estiver em fila de espera ou em execução no momento (ou seja, se a tarefa mostrar um estado EXECUTING na saída TASK_HISTORY), a execução atual continuará usando a versão da tarefa que estava atual quando o comando foi executado. Uma nova execução é então programada para iniciar, em um horário que depende do tipo de tarefa:
Para tarefas autônomas, uma nova execução é programada para iniciar após a conclusão da execução atual.
Para gráficos de tarefas:
Se ALLOW_OVERLAPPING_EXECUTION = FALSE (padrão), uma nova execução será programada para iniciar após a conclusão do gráfico da tarefa atual.
Se ALLOW_OVERLAPPING_EXECUTION = TRUE e a tarefa em execução no momento for uma tarefa raiz, uma nova execução será programada para iniciar após a conclusão da tarefa raiz.
Se ALLOW_OVERLAPPING_EXECUTION = TRUE, e a tarefa em execução no momento for uma tarefa filho, uma nova execução será iniciada imediatamente.
Se o comando EXECUTE TASK for executado novamente antes do início da próxima execução programada, a execução solicitada substituirá a execução programada.
Se uma tarefa falhar com um erro inesperado, você poderá receber uma notificação sobre o erro. Para obter mais informações sobre a configuração de notificações de erro de tarefa, consulte Ativação de notificações para tarefas.
Para visualizar as informações da tarefa, você pode:
Abrir Snowsight e selecionar Monitoring » Task History.
Chamar a função de tabela COMPLETE_TASK_GRAPHS e examinar os resultados.
Exemplos¶
Acionar manualmente uma execução de uma tarefa chamada mytask
:
EXECUTE TASK mytask;