Catégories :

Information Schema , Fonctions de table

NOTIFICATION_HISTORY

Cette fonction de table peut être utilisée pour interroger l’historique des notifications envoyées par Snowflake. Ces notifications comprennent :

Note

Cette fonction renvoie uniquement des informations sur les notifications qui ont été traitées (notifications qui ont été envoyées ou qui ont échoué). Les notifications dans la file d’attente ne seront pas affichées dans l’historique.

Syntaxe

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

Arguments

Tous les arguments sont facultatifs.

START_TIME=> constant_expr , . END_TIME=> constant_expr

Plage horaire (au format TIMESTAMP_LTZ) à laquelle la notification est envoyée.

  • Si START_TIME n’est pas spécifié, l’intervalle commence 24 heures avant END_TIME.

  • Si END_TIME n’est pas spécifié, la valeur par défaut est CURRENT_TIMESTAMP.

La plage horaire maximale est de 14 jours.

INTEGRATION_NAME => 'string'

Le nom entièrement qualifié de l’intégration qui est liée à la notification. Si vous omettez cet argument, la fonction renvoie toutes les notifications.

Par défaut : une chaîne vide.

RESULT_LIMIT => integer

Un nombre spécifiant le nombre maximum de lignes renvoyé par la fonction.

Plage : de 1 à 10000

Par défaut : 100.

Sortie

La fonction renvoie les colonnes suivantes :

Nom de la colonne

Type de données

Description

CREATED

TIMESTAMP_LTZ

Horodatage de la création de la notification.

PROCESSED

TIMESTAMP_LTZ

Horodatage de la dernière tentative d’envoi de la notification.

MESSAGE_SOURCE

TEXT

Type d’objet ou de fonction qui a généré la notification. Les valeurs valides incluent : . . TASK (pour les notifications provenant des tâches) . SNOWPIPE (pour les notifications provenant de Snowpipe) . STORED_PROCEDURE (pour les notifications par e-mail envoyées en appelant la procédure stockée SYSTEM$SEND_EMAIL)

INTEGRATION_NAME

TEXT

Nom de l’intégration utilisée pour cette notification.

MESSAGE

TEXT

Charge utile du message.

STATUS

TEXT

Statut de la notification. Les valeurs valides sont : SUCCESS ou FAILURE.

ERROR_MESSAGE

TEXT

Si la notification a échoué, fournit des détails sur la raison de l’échec.

Notes sur l’utilisation

  • Renvoie les résultats uniquement pour le rôle ACCOUNTADMIN, le propriétaire de l’intégration (c’est-à-dire le rôle avec le privilège OWNERSHIP sur l’intégration), un rôle avec le privilège USAGE sur l’intégration.

  • Lors de l’appel d’une fonction de table Information Schema, la session doit avoir un schéma INFORMATION_SCHEMA en cours d’utilisation ou le nom de la fonction doit être complètement qualifié. Pour plus de détails, voir Schéma d’information de Snowflake.

Exemples

Récupère les notifications les plus récentes créées au cours des 24 dernières heures.

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

Récupérez les notifications les plus récentes qui ont été créées au cours de la dernière heure et envoyées à l’aide de l’intégration nommée 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