DROP TASK

Remove uma tarefa do esquema atual/especificado.

Consulte também:

CREATE TASK , ALTER TASK , SHOW TASKS , DESCRIBE TASK

Sintaxe

DROP TASK [ IF EXISTS ] <name>
Copy

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 ou schema_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 gráfico de tarefas deve ser suspensa antes que qualquer tarefa no gráfico de tarefas 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 gráfico de tarefas 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%';
Copy

Descartar a tarefa novamente, mas não gerar um erro se a tarefa não existir:

DROP TASK IF EXISTS t2;
Copy