DROP TASK¶
Remove uma tarefa do esquema atual/especificado.
- Consulte também:
Sintaxe¶
DROP TASK [ IF EXISTS ] <name>
Parâmetros¶
name
Especifica o identificador da tarefa a ser descartada. Se o identificador contiver espaços, caracteres especiais ou caracteres com letras maiúsculas e minúsculas, toda a cadeia de caracteres deve ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas (por exemplo,
"My Object"
).Se o identificador da tarefa não estiver totalmente qualificado (na forma de
db_name.schema_name.task_name
ouschema_name.task_name
), o comando procurará a tarefa no esquema atual para a sessão.
Notas de uso¶
Quando uma tarefa é descartada, qualquer execução atual da tarefa (ou seja, uma execução com um estado EXECUTING na saída TASK_HISTORY) é concluída. Para interromper a execução da tarefa especificada, execute a função SYSTEM$USER_TASK_CANCEL_ONGOING_EXECUTIONS.
A tarefa raiz em um DAG de tarefas deve ser suspensa antes que qualquer tarefa no DAG seja descartada.
Uma tarefa autônoma pode ser descartada pelo proprietário da tarefa (ou seja, a função que tem o privilégio OWNERSHIP na tarefa) ou uma função superior sem primeiro suspender a tarefa.
Se uma tarefa anterior em um DAG for descartada, então todas as antigas tarefas filho que identificavam esta tarefa como a anterior tornarão-se tarefas isoladas ou tarefas raiz, dependendo se outras tarefas identificam estas antigas tarefas filho como sua predecessora. Estas antigas tarefas filho são suspensas por padrão e devem ser retomadas manualmente.
Exemplos¶
Descartar uma tarefa:
SHOW TASKS LIKE 't2%'; DROP TASK t2; SHOW TASKS LIKE 't2%';
Descartar a tarefa novamente, mas não gerar um erro se a tarefa não existir:
DROP TASK IF EXISTS t2;