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. As tarefas com tempo limite esgotado sempre têm um estado `FAILED` no histórico de tarefas.
RETURN_VALUE	TEXT	Valor definido para a tarefa predecessora em um gráfico 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 gráfico de tarefas que foi executado ou que está programado para ser executado. Cada aumento incremental no valor representa uma ou mais modificações nas tarefas no gráfico de tarefas. 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 gráfico de tarefas está/estava originalmente programada para começar a execução. O formato é a hora da época (em milissegundos). . . 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 original programado e SCHEDULED_TIME mostra o tempo de execução reprogramado. . . Observe que RUN_ID pode não ser um identificador exclusivo para a tarefa/gráfico atual executado antes da nova tentativa. Você pode usar a coluna GRAPH_RUN_GROUP_ID como substituto de RUN_ID.
ROOT_TASK_ID	TEXT	Identificador exclusivo para a tarefa raiz em um gráfico de tarefas. Esta ID corresponde ao valor da coluna ID na saída SHOW TASKS para a mesma tarefa.
SCHEDULED_FROM	TEXT	Uma das opções: `SCHEDULE`: a tarefa foi agendada para execução normalmente, conforme descrito nas cláusulas SCHEDULE ou AFTER de CREATE TASK. `EXECUTE TASK`: a tarefa foi agendada para execução usando EXECUTE TASK. `MANUAL RETRY`: a tarefa foi agendada para execução usando EXECUTE TASK … RETRY LAST. `TRIGGER`: a tarefa foi executada porque o fluxo, na cláusula `WHEN` da tarefa continha novos dados. Para execuções de tarefas filho em um gráfico de tarefas, a coluna retorna o mesmo valor que a execução da tarefa raiz.
ATTEMPT_NUMBER	NUMBER	Número inteiro que representa o número de tentativas de execução desta tarefa. Inicialmente um.
INSTANCE_ID	NUMBER	Identificador interno/gerado pelo sistema para a instância à qual o objeto pertence.
CONFIG	TEXT	Exibe a configuração do nível do gráfico se definido para a tarefa raiz, caso contrário, exibe NULL.
QUERY_HASH	TEXT	O valor de hash calculado com base no texto canônico SQL.
QUERY_HASH_VERSION	NUMBER	A versão da lógica usada para calcular `QUERY_HASH`.
QUERY_PARAMETERIZED_HASH	TEXT	O valor de hash calculado com base na consulta parametrizada.
QUERY_PARAMETERIZED_HASH_VERSION	NUMBER	A versão da lógica usada para calcular `QUERY_PARAMETERIZED_HASH`.
GRAPH_RUN_GROUP_ID	NUMBER	Identificador para a execução do gráfico. Quando uma execução de gráfico tem várias execuções de tarefas, cada execução de tarefa mostrará o mesmo GRAPH_RUN_GROUP_ID. A combinação de GRAPH_RUN_GROUP_ID e ATTEMPT_NUMBER pode ser usada para identificar exclusivamente uma execução de gráfico.
BACKFILL_INFO	OBJECT	Reservado para uso futuro. O valor retornado para todas as linhas é 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.

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
ORDER BY completed_time DESC
LIMIT 10;

Copy

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());

Copy