Fonction de table NOTIFICATION_HISTORY : modifications de la sortie

Attention

Ce changement de comportement est présent dans le bundle 2024_04.

Pour connaître le statut actuel du bundle, reportez-vous à Historique du bundle.

La fonction NOTIFICATION_HISTORY évolue pour fournir des informations sur les éléments suivants :

  • Notifications qui n’ont pas encore été traitées.

  • Tentatives d’envoi de notifications qui ont initialement échoué et qui sont relancées.

Les sections suivantes expliquent comment ces changements impactent la sortie de la fonction :

Modifications du nombre de lignes retournées

Le nombre de lignes renvoyées par la fonction change :

Avant la modification:

Cette fonction renvoie une ligne pour chaque notification qui a été traitée (notifications qui ont été envoyées ou qui ont échoué).

Si plusieurs tentatives ont été faites pour envoyer une notification, la fonction renvoie une ligne pour la dernière tentative effectuée.

Après la modification:

Cette fonction renvoie une ligne pour chaque tentative d’envoi d’une notification. La valeur de la colonne STATUS indique le statut de la tentative :

  • Si la tentative a échoué mais peut être réitérée, la valeur est RETRIABLE_FAILURE.

  • Si la tentative a échoué et ne peut être renouvelée, la valeur est FAILURE.

  • Si la tentative a réussi, la valeur est SUCCESS.

En outre, la fonction renvoie une ligne pour chaque notification qui n’a pas encore été traitée (notifications en file d’attente).

Nouvelles colonnes dans la sortie

Lorsque le bundle de changements de comportement est activé, la sortie de la fonction NOTIFICATION_HISTORY comprend les nouvelles colonnes suivantes :

Nom de la colonne

Type de données

Description

ID

VARCHAR

ID unique d’une demande d’envoi de notification.

Si Snowflake ne parvient pas à envoyer une notification et tente à nouveau de l’envoyer, la fonction renvoie une ligne pour chaque tentative. Chaque ligne pour une tentative a la même valeur dans la colonne ID mais une valeur différente dans la colonne ATTEMPT.

ATTEMPT

INTEGER

Numéro de la tentative d’envoi de la notification.

MESSAGE_SOURCE_INFO

OBJECT

Objet contenant des informations sur la source de la notification. Les champs de cet objet dépendent du type de la source :

  • Pour les notifications d’erreur pour les tâches, l’objet contient les champs suivants :

    • name : nom de la tâche.

    • graph_run_group_id : identificateur de l’exécution du graphique.

    • attempt_number : nombre entier représentant le nombre de tentatives d’exécution de cette tâche.

  • Pour les notifications d’erreur concernant Snowpipe, l’objet contient le champ pipe_name, qui spécifie le nom du canal.

  • Pour les notifications envoyées en appelant la procédure stockée SYSTEM$SEND_EMAIL, l’objet contient le champ query_id, qui spécifie l’ID de l’instruction qui a appelé la procédure stockée.

Suppression de la colonne MESSAGE

La colonne MESSAGE est obsolète et sera supprimée à l’avenir.

Réf : 1593

Langage: Français