Função de tabela NOTIFICATION_HISTORY: Alterações na saída¶

Atenção

Essa mudança de comportamento está no pacote 2024_04.

Para saber o status atual do pacote, consulte Histórico do pacote.

A função NOTIFICATION_HISTORY está mudando para fornecer informações sobre:

Notificações que ainda não foram processadas.
Tentativas de envio de notificações que falharam inicialmente e que estão sendo repetidas.

As próximas seções explicam como essas alterações afetam a saída da função:

Alterações no número de linhas retornadas
Novas colunas na saída
Depreciação da coluna MESSAGE

Alterações no número de linhas retornadas¶

O número de linhas retornadas pela função está mudando:

Antes da mudança:

Esta função retorna uma linha para cada notificação que foi processada (notificações que foram enviadas ou falharam).

Se várias tentativas forem feitas para enviar uma notificação, a função retornará uma linha para a última tentativa feita.

Após a mudança:

Esta função retorna uma linha para cada tentativa de envio de uma notificação. O valor na coluna STATUS indica o status da tentativa:

Se a tentativa falhou, mas pode ser repetida, o valor será RETRIABLE_FAILURE.
Se a tentativa falhar e não puder ser repetida, o valor será FAILURE.
Se a tentativa for bem-sucedida, o valor será SUCCESS.

Além disso, a função retorna uma linha para cada notificação que ainda não foi processada (notificações que estão na fila).

Novas colunas na saída¶

Quando esse pacote de mudança de comportamento está ativado, a saída da função NOTIFICATION_HISTORY inclui as seguintes novas colunas:

Nome da coluna	Tipo de dados	Descrição
ID	VARCHAR	ID exclusivo de uma solicitação para enviar uma notificação. Se o Snowflake não enviar uma notificação e tentar enviá-la novamente, a função retornará uma linha para cada tentativa. Cada linha para uma tentativa tem o mesmo valor na coluna ID, mas um valor diferente na coluna ATTEMPT.
ATTEMPT	INTEGER	Número da tentativa feita para enviar a notificação.
MESSAGE_SOURCE_INFO	OBJECT	Objeto contendo informações sobre a origem da notificação. Os campos neste objeto dependem do tipo da fonte: Para notificações de erro para tarefas, o objeto contém os seguintes campos: `name`: o nome da tarefa. `graph_run_group_id`: identificador para a execução do gráfico. `attempt_number`: número inteiro que representa o número da tentativa para executar esta tarefa. Para notificações de erro para Snowpipe, o objeto contém o campo `pipe_name`, que especifica o nome do canal. Para notificações enviadas ao chamar o procedimento armazenado SYSTEM$SEND_EMAIL, o objeto contém o campo `query_id`, que especifica o ID da instrução que chamou o procedimento armazenado.

Nome da coluna

Tipo de dados

Descrição

VARCHAR

ID exclusivo de uma solicitação para enviar uma notificação.

Se o Snowflake não enviar uma notificação e tentar enviá-la novamente, a função retornará uma linha para cada tentativa. Cada linha para uma tentativa tem o mesmo valor na coluna ID, mas um valor diferente na coluna ATTEMPT.

ATTEMPT

INTEGER

Número da tentativa feita para enviar a notificação.

MESSAGE_SOURCE_INFO

OBJECT

Objeto contendo informações sobre a origem da notificação. Os campos neste objeto dependem do tipo da fonte:

Para notificações de erro para tarefas, o objeto contém os seguintes campos:
- name: o nome da tarefa.
- graph_run_group_id: identificador para a execução do gráfico.
- attempt_number: número inteiro que representa o número da tentativa para executar esta tarefa.
Para notificações de erro para Snowpipe, o objeto contém o campo pipe_name, que especifica o nome do canal.
Para notificações enviadas ao chamar o procedimento armazenado SYSTEM$SEND_EMAIL, o objeto contém o campo query_id, que especifica o ID da instrução que chamou o procedimento armazenado.

Depreciação da coluna MESSAGE¶

A coluna MESSAGE está obsoleta e será removida no futuro.

Ref: 1593