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