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 é 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 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.

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. 1

QUERY_HASH_VERSION

NUMBER

A versão da lógica usada para calcular QUERY_HASH. 1

QUERY_PARAMETERIZED_HASH

TEXT

O valor de hash calculado com base na consulta parametrizada. 1

QUERY_PARAMETERIZED_HASH_VERSION

NUMBER

A versão da lógica usada para calcular QUERY_PARAMETERIZED_HASH. 1

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

Reserved for future use. The returned value for all rows is NULL.

1(1,2,3,4)

Esta coluna está presente somente quando o pacote de mudança de comportamento 2023_06 está ativado. Esta coluna faz parte do recurso hash de consulta.

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