Esquema:: ACCOUNT_USAGE

Exibição TASK_HISTORY¶

Essa exibição do Account Usage permite que você obtenha o histórico de utilização da tarefa nos últimos 365 dias (1 ano). A exibição apresenta uma linha para cada execução de uma tarefa no histórico.

Colunas¶

Nome da coluna	Tipo de dados	Descrição
NAME	TEXT	Nome da tarefa.
QUERY_TEXT	TEXT	Texto da instrução SQL.
CONDITION_TEXT	TEXT	O texto da condição de WHEN que a tarefa avalia ao determinar se ela deve ser executada.
SCHEMA_NAME	TEXT	Nome do esquema que contém a tarefa.
TASK_SCHEMA_ID	NUMBER	Identificador interno/gerado pelo sistema para o esquema que contém a tarefa.
DATABASE_NAME	TEXT	Nome do banco de dados que contém a tarefa.
TASK_DATABASE_ID	NUMBER	Identificador interno/gerado pelo sistema para o banco de dados que contém a tarefa.
SCHEDULED_TIME	TIMESTAMP_LTZ	Hora em que a tarefa está/estava programada para começar a execução. Note que fazemos o melhor para assegurar uma precisão absoluta, mas só garantimos que as tarefas não sejam executadas antes do horário programado.
COMPLETED_TIME	TIMESTAMP_LTZ	Hora em que a tarefa foi concluída.
STATE	TEXT	Status da tarefa concluída: SUCCEEDED, FAILED, CANCELLED ou SKIPPED. Observe que a exibição não retorna execuções de tarefa SCHEDULED ou EXECUTING. Para recuperar os detalhes do histórico de tarefas para execuções em um estado programado ou em execução, consulte a função de tabela TASK_HISTORY do Information Schema.
RETURN_VALUE	TEXT	Valor definido para a tarefa anterior em um DAG de tarefas. O valor de retorno é definido explicitamente chamando a função SYSTEM$SET_RETURN_VALUE pela tarefa predecessora.
QUERY_ID	TEXT	ID da instrução SQL executada pela tarefa. Pode ser unido com a exibição QUERY_HISTORY para detalhes adicionais sobre a execução da instrução ou procedimento armazenado.
QUERY_START_TIME	TIMESTAMP_LTZ	Hora em que a consulta na definição da tarefa começou a ser executada. Este carimbo de data/hora se alinha à hora de início da consulta retornada por QUERY_HISTORY.
ERROR_CODE	NUMBER	Código de erro, se a instrução tiver retornado um erro.
ERROR_MESSAGE	TEXT	Mensagem de erro, se a instrução tiver retornado um erro.
GRAPH_VERSION	NUMBER	Número inteiro que identifica a versão do DAG que foi executado, ou que está programado para ser executado. Cada aumento incremental no valor representa uma ou mais modificações nas tarefas no DAG. Se a tarefa raiz for recriada (usando CREATE OR REPLACE TASK), então o número da versão é reiniciado a partir de 1.
RUN_ID	NUMBER	Hora em que a tarefa autônoma ou raiz em um DAG está/estava originalmente programada para começar a execução. O formato é hora de época (em milissegundos). A combinação dos valores ROOT_TASK_ID e RUN_ID identifica uma execução específica de um DAG. . Horário programado original refere-se a raros casos em que o sistema pode reprogramar a mesma tarefa para ser executada em um horário diferente a fim de tentar novamente ou reequilibrar a carga. Se isso acontecer, RUN_ID mostra o tempo de execução programado original e SCHEDULED_TIME mostra o tempo de execução reprogramado.
ROOT_TASK_ID	TEXT	Identificador exclusivo para a tarefa raiz em um DAG. Esta ID corresponde ao valor da coluna ID na saída SHOW TASKS para a mesma tarefa.
SCHEDULED_FROM	TEXT	Mecanismo que motivou a execução da tarefa: SCHEDULE indica que a execução da tarefa foi iniciada pelo cronograma na definição da tarefa. EXECUTE TASK indica que a execução da tarefa foi iniciada por uma execução de da instrução EXECUTE TASK. Para execuções de tarefas filho em um DAG, a coluna retorna o mesmo valor que a execução da tarefa raiz.

Notas de uso¶

A latência da visualização pode ser de até 45 minutos.
Para melhorar o desempenho, filtre as consultas na coluna COMPLETED_TIME ou SCHEDULED_TIME. Consulte a seção Exemplos (neste tópico).

Exemplos¶

Recuperar registros para as 10 execuções de tarefa mais recentes concluídas:

SELECT query_text, completed_time
FROM snowflake.account_usage.task_history
LIMIT 10;

Recuperar registros de execuções de tarefas concluídas na última hora:

SELECT query_text, completed_time
FROM snowflake.account_usage.task_history
WHERE COMPLETED_TIME > DATEADD(hours, -1, CURRENT_TIMESTAMP());