Categorias:: Information Schema , Funções de tabela

SERVERLESS_ALERT_HISTORY¶

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

Consulte também:: Exibição SERVERLESS_ALERT_HISTORY (ACCOUNT_USAGE)

Sintaxe¶

SERVERLESS_ALERT_HISTORY(
  [ DATE_RANGE_START => <constant_expr> ]
  [ , DATE_RANGE_END => <constant_expr> ]
  [ , ALERT_NAME => '<string>' ] )

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, o intervalo começará 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.

ALERT_NAME => string

O nome do alerta para o qual deseja recuperar o histórico de uso. Somente os dados de uso do alerta especificado são retornados.

Observe que o nome do alerta deve estar entre aspas simples. Além disso, se o nome do alerta contiver espaços, caracteres maiúsculos e minúsculos ou caracteres especiais, o nome deverá estar entre aspas duplas dentro das aspas simples (por exemplo, '"My Alert"' vs. 'myalert').

Notas de uso¶

A função de tabela retorna resultados somente para a função ACCOUNTADMIN ou qualquer função que tenha recebido explicitamente 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.
Quando você chama uma função de tabela 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.
ALERT_NAME	TEXT	Nome do alerta.
CREDITS_USED	TEXT	Número de créditos cobrados pelo uso de alerta sem servidor durante a janela de START_TIME e END_TIME.

Exemplos¶

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

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>'2024-10-08 19:00:00.000 -0700',
    DATE_RANGE_END=>'2024-10-08 20:00:00.000 -0700'));

Exemplo de saída:

+-------------------------------+-------------------------------+------------+--------------+
| START_TIME                    | END_TIME                      | ALERT_NAME | CREDITS_USED |
|-------------------------------+-------------------------------+------------+--------------|
| 2024-10-08 04:16:22.000 -0700 | 2024-10-08 05:16:22.000 -0700 | A1         |  0.000286714 |
| 2024-10-08 05:16:22.000 -0700 | 2024-10-08 06:16:22.000 -0700 | A1         |  0.007001568 |
+-------------------------------+-------------------------------+------------+--------------+

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

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>DATEADD(H, -12, CURRENT_TIMESTAMP)));

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

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>DATEADD(D, -7, CURRENT_DATE),
    DATE_RANGE_END=>CURRENT_DATE));

Recupere o histórico de uso da semana passada para um alerta específico em sua conta:

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>DATEADD(D, -7, CURRENT_DATE),
    DATE_RANGE_END=>CURRENT_DATE,
    ALERT_NAME=>'my_database.my_schema.my_alert'));