DESCRIBE TASK¶

Descreve as colunas em uma tarefa.

DESCRIBE pode ser abreviado como DESC.

Consulte também:: DROP TASK , ALTER TASK , CREATE TASK , SHOW TASKS

Sintaxe¶

DESC[RIBE] TASK <name>

Copy

Parâmetros¶

name: Especifica o identificador da tarefa a ser descrita. 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.

Saída¶

A saída do comando fornece propriedades de tarefa e metadados nas seguintes colunas:

Nome da coluna	Descrição
created_on	Data e hora em que a tarefa foi criada.
nome	O nome da tarefa.
id	O identificador globalmente exclusivo (GUID) da tarefa.
database_name	Nome do banco de dados que contém a tarefa.
schema_name	O nome do esquema com a tarefa.
proprietário	O nome da função que possui a tarefa.
comentário	Comentário sobre a tarefa, se houver.
warehouse	O nome do warehouse virtual que fornece recursos de computação para a execução da tarefa.
schedule	O cronograma, se houver, para executar periodicamente a tarefa, como uma expressão cron. Por exemplo, `USING CRON 0 9-17 * * SUN America/Los_Angeles`.
predecessors	O nome ou nomes de quaisquer tarefas predecessoras, se houver, para a tarefa atual.
state	Qualquer um dos seguintes: SCHEDULED – agendado para execução. EXECUTING – atualmente em execução. SUCCEEDED – execução bem-sucedida. FAILED – a execução falhou e a tarefa atingiu o tempo limite. FAILED_AND_AUTO_SUSPENDED – a execução falhou e a tarefa foi automaticamente suspensa. CANCELLED – execução cancelada. SKIPPED – indica que uma execução de tarefa começou, mas a condicional opcional `WHEN` foi avaliada como falsa, portanto, a execução não foi realizada.
definition	A instrução SQL que a tarefa executa quando agendada ou acionada.
condition	Texto das condições `WHEN` que devem ser avaliadas como verdadeiras para que a tarefa seja executada.
allow_overlapping_execution	TRUE ou FALSE. Aplica-se somente a tarefas raiz. TRUE indica que várias instâncias da tarefa raiz podem ser executadas ao mesmo tempo. FALSE é o padrão.
error_integration	O nome da integração da notificação utilizada para se comunicar com o Amazon SNS, MS Azure Event Grid ou Google Pub/Sub. Retorna `null` se não for especificado.
last_committed_on	Carimbo de data/hora em que uma versão da tarefa foi definida pela última vez, se aplicável. Para obter mais informações, consulte Controle de versão de execuções de tarefas.
last_suspended_on	Carimbo de data/hora em que a tarefa foi suspensa pela última vez, se aplicável.
owner_role_type	O tipo de função que possui o objeto, por exemplo, `ROLE`. Se um Snowflake Native App for o proprietário do objeto, o valor será `APPLICATION`.
config	Aplica-se somente a tarefas raiz em um gráfico de tarefas. Exibe a configuração, se houver.
budget	Nome do orçamento se o objeto for monitorado por um orçamento. Caso contrário, NULL.
task_relations	Exibe o relacionamento entre a tarefa raiz e suas tarefas finalizadoras correspondentes.
last_suspended_on	Exibe o motivo pelo qual a tarefa foi suspensa. Os possíveis motivos incluem o seguinte: USER_SUSPENDED – o usuário suspendeu a tarefa executando o comando `alter task <nome> suspend`. SCHEMA_OR_DATABASE_DELETED – o esquema ou banco de dados da tarefa foi descartado. GRANT_OWNERSHIP – o usuário transferiu a propriedade da tarefa para outra função executando o comando `grant ownership`. SUSPENDED_DUE_TO_ERRORS – a tarefa falhou um certo número de vezes consecutivas e foi suspensa. Você pode definir o parâmetro SUSPEND_TASK_AFTER_NUM_FAILURES para o número de falhas necessárias para suspender esta tarefa. CHILD_BECAME_ROOT – a tarefa era anteriormente uma tarefa filho em um gráfico de tarefas, mas todos os predecessores da tarefa filho foram removidos e a tarefa filho tornou-se uma tarefa raiz. FINALIZER_BECAME_ROOT – a tarefa era anteriormente uma tarefa finalizadora em um gráfico de tarefas, mas a finalização foi removida e a tarefa tornou-se uma tarefa raiz. MATCHING_OWNER_NOT_FOUND – durante a replicação de tarefa, a função proprietária da tarefa não foi encontrada no banco de dados secundário.

Notas de uso¶

Somente retorna linhas para o proprietário de uma tarefa (isto é, a função com o privilégio OWNERSHIP em uma tarefa) ou uma função com o privilégio MONITOR ou OPERATE em uma tarefa.

Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.

Exemplos¶

Criar uma tarefa de exemplo:

CREATE TASK mytask ( ... );

Copy

Descrever as colunas na tarefa:

DESC TASK mytask;

Copy