Categorias:

Information Schema , Funções de tabela

SERVERLESS_TASK_HISTORY

Esta função de tabela é usada para consultar o histórico de uso da tarefa sem servidor. As informações retornadas pela função incluem o nome da tarefa e os créditos consumidos pelas execuções de cada tarefa.

Sintaxe

SERVERLESS_TASK_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [ , DATE_RANGE_END => <constant_expr> ]
      [ , TASK_NAME => '<string>' ] )
Copy

Argumentos

Todos os argumentos são opcionais.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

Faixa de data/hora do intervalo de uso:

  • Se uma data final não for especificada, então CURRENT_DATE é usada como o fim do intervalo.

  • Se uma data de início não for especificada, então o intervalo começa 10 minutos antes do início de DATE_RANGE_END (ou seja, o padrão é mostrar os 10 minutos anteriores do histórico de uso). Por exemplo, se DATE_RANGE_END for CURRENT_DATE, então o padrão DATE_RANGE_START é 11:50 PM no dia anterior.

TASK_NAME => string

O nome da tarefa para a qual se recupera o histórico de uso. Somente os dados de uso para a tarefa especificada são retornados.

Observe que o nome da tarefa deve ser delimitado por aspas simples. Além disso, se o nome do tarefa contiver quaisquer espaços, letras maiúsculas e minúsculas misturadas ou caracteres especiais, o nome deve ser delimitado por aspas duplas dentro das aspas simples (por exemplo, '"My Task"' vs 'mytask').

Notas de uso

  • Retorna resultados apenas para a função ACCOUNTADMIN ou qualquer função que tenha sido explicitamente concedido o privilégio global MONITOR USAGE.

    Nota

    Uma função com o privilégio MONITOR USAGE pode ver o uso de crédito por objeto, mas não os nomes de objetos.

  • Ao chamar uma função de tabela do Information Schema, a sessão deve ter um esquema INFORMATION_SCHEMA em uso ou o nome da função deve ser totalmente qualificado. Para obter mais detalhes, consulte Snowflake Information Schema.

  • O histórico é exibido em incrementos de 1 hora.

Saída

A função retorna as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

START_TIME

TIMESTAMP_LTZ

Início do intervalo especificado.

END_TIME

TIMESTAMP_LTZ

Fim do intervalo especificado.

TASK_NAME

TEXT

Nome da tarefa.

CREDITS_USED

TEXT

Número de créditos faturados pelo uso de tarefas sem servidor durante o intervalo START_TIME e END_TIME.

Exemplos

Recuperar o histórico de uso de uma hora para sua conta:

select *
  from table(information_schema.serverless_task_history(
    date_range_start=>'2021-10-08 19:00:00.000',
    date_range_end=>'2021-10-08 20:00:00.000'));
Copy

Exemplo de saída:

+-------------------------------+-------------------------------+-----------+--------------+
| START_TIME                    | END_TIME                      | TASK_NAME | CREDITS_USED |
|-------------------------------+-------------------------------+-----------+--------------|
| 2021-10-08 04:16:22.000 -0700 | 2021-10-08 05:16:22.000 -0700 | T1        |  0.000286714 |
| 2021-10-08 05:16:22.000 -0700 | 2021-10-08 06:16:22.000 -0700 | T1        |  0.007001568 |
+-------------------------------+-------------------------------+-----------+--------------+
Copy

Recuperar o histórico das últimas 12 horas para sua conta:

select *
  from table(information_schema.serverless_task_history(
    date_range_start=>dateadd(H, -12, current_timestamp)));
Copy

Recuperar o histórico da última semana para sua conta:

select *
  from table(information_schema.serverless_task_history(
    date_range_start=>dateadd(D, -7, current_date),
    date_range_end=>current_date));
Copy

Recuperar o histórico de uso da última semana para uma tarefa específica em sua conta:

select *
  from table(information_schema.serverless_task_history(
    date_range_start=>dateadd(D, -7, current_date),
    date_range_end=>current_date,
    task_name=>'mydb.myschema.mytask'));
Copy