- Esquema:
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. |
CONFIG |
TEXT |
Exibe a configuração do nível do gráfico se definido para a tarefa raiz, caso contrário, exibe NULL. |
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());