Categorias:

Information Schema , Funções de tabela

NOTIFICATION_HISTORY

Esta função de tabela pode ser usada para consultar o histórico das notificações enviadas pelo Snowflake. Essas notificações incluem:

Nota

Esta função só retorna informações sobre notificações que foram processadas (notificações que foram enviadas ou falharam). Notificações na fila não serão mostradas no histórico.

Sintaxe

NOTIFICATION_HISTORY(
  [ START_TIME => <constant_expr> ]
  [, END_TIME => <constant_expr> ]
  [, INTEGRATION_NAME => '<string>' ]
  [, RESULT_LIMIT => <integer> ] )
)
Copy

Argumentos

Todos os argumentos são opcionais.

START_TIME=> constant_expr , . END_TIME=> constant_expr

Intervalo de tempo (em formato TIMESTAMP_LTZ) quando a notificação é enviada.

  • Se START_TIME não for especificado, o intervalo começa 24 horas antes do END_TIME.

  • Se END_TIME não for especificado, o padrão é CURRENT_TIMESTAMP.

O intervalo de tempo máximo é de 14 dias.

INTEGRATION_NAME => 'string'

O nome totalmente qualificado da integração que está ligada à notificação. Se você omitir este argumento, a função retorna todas as notificações.

Padrão: uma cadeia de caracteres vazia

RESULT_LIMIT => integer

Um número especificando o número máximo de linhas retornadas pela função.

Intervalo: 1 a 10000

Padrão: 100.

Saída

A função retorna as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

CREATED

TIMESTAMP_LTZ

Carimbo de data/hora quando a notificação foi criada.

PROCESSED

TIMESTAMP_LTZ

Carimbo de data/hora da última tentativa de enviar a notificação.

MESSAGE_SOURCE

TEXT

Tipo de objeto ou recurso que gerou a notificação. Os valores válidos incluem: . . TASK (para notificações de tarefas) . SNOWPIPE (para notificações do Snowpipe) . STORED_PROCEDURE (para notificações por e-mail enviadas ao acessar o procedimento armazenado SYSTEM$SEND_EMAIL)

INTEGRATION_NAME

TEXT

Nome da integração utilizada para esta notificação.

MESSAGE

TEXT

Carga útil da mensagem.

STATUS

TEXT

Status da notificação. Valores válidos: SUCCESS ou FAILURE.

ERROR_MESSAGE

TEXT

Se a notificação falhou, fornece detalhes sobre o motivo da falha da notificação.

Notas de uso

  • Retorna resultados somente para a função ACCOUNTADMIN, o proprietário da integração (ou seja, a função com o privilégio OWNERSHIP para a integração) ou uma função com o privilégio global USAGE.

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

Exemplos

Recupere as notificações mais recentes que foram criadas nas últimas 24 horas.

select * from table(information_schema.notification_history())
Copy

Recupere as notificações mais recentes que foram criadas na última hora e enviadas usando a integração chamada MY_INTEGRATION.

select * from table(information_schema.notification_history(
  START_TIME=>dateadd('hour',-1,current_timestamp()),
  END_TIME=>current_timestamp(),
  RESULT_LIMIT=>100,
  INTEGRATION_NAME=>'MY_INTEGRATION'));
Copy