ALERT_HISTORY¶

Syntaxe¶

ALERT_HISTORY(
      [ SCHEDULED_TIME_RANGE_START => <constant_expr> ]
      [, SCHEDULED_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <integer> ]
      [, ALERT_NAME => '<string>' ] )

Arguments¶

Tous les arguments sont facultatifs.

SCHEDULED_TIME_RANGE_START => constant_expr , . SCHEDULED_TIME_RANGE_END => constant_expr

Période (au format TIMESTAMP_LTZ), au cours des 7 derniers jours, pendant laquelle l’évaluation de la condition de l’alerte a été programmée.

• Si SCHEDULED_TIME_RANGE_END n’est pas spécifié, la fonction renvoie les alertes déjà terminées, en cours d’exécution ou planifiées ultérieurement.

• Si SCHEDULED_TIME_RANGE_END vaut CURRENT_TIMESTAMP, la fonction renvoie les alertes déjà terminées ou en cours d’exécution. Notez qu’une alerte exécutée immédiatement avant l’heure actuelle peut toujours être identifiée comme étant planifiée.

Note

Si aucune heure de début ou de fin n’est spécifiée, les alertes les plus récentes sont renvoyées, jusqu’à la valeur RESULT_LIMIT spécifiée.

Si l’intervalle de temps ne tombe pas dans les 7 derniers jours, une erreur est renvoyée.

RESULT_LIMIT => integer

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

Si le nombre de lignes correspondantes est supérieur à cette limite, les exécutions d’alertes avec l’horodatage le plus récent sont renvoyées, jusqu’à la limite spécifiée.

Plage : de 1 à 10000

Par défaut : 100.

ALERT_NAME => string

Une chaîne insensible à la casse spécifiant une alerte. Seuls les noms d’alerte non qualifiés sont pris en charge. Seules les exécutions de l’alerte spécifiée sont renvoyées. Notez que si plusieurs alertes portent le même nom, la fonction renvoie l’historique de chacune de ces alertes.

Notes sur l’utilisation¶

• Renvoie les résultats uniquement pour le rôle ACCOUNTADMIN ou le propriétaire de l’alerte (c’est-à-dire le rôle doté du privilège OWNERSHIP sur la tâche).

• Cette fonction renvoie un maximum de 10 000 lignes, définies dans la valeur de l’argument RESULT_LIMIT. La valeur par défaut est 100.

  Notez que lorsque la fonction ALERT_HISTORY est interrogée, ses arguments de nom d’alerte, d’intervalle de temps et de limite de résultat sont appliqués d’abord, suivis des clauses WHERE et LIMIT, respectivement, si elles sont spécifiées. En outre, la fonction ALERT_HISTORY renvoie les enregistrements dans l’ordre SCHEDULED_TIME décroissant. Les alertes qui sont terminées (c’est-à-dire avec un état SUCCEEDED, FAILED ou CANCELLED) ont tendance à être programmées plus tôt, de sorte qu’elles sont généralement renvoyées plus tard dans l’ordre dans les résultats de la recherche.

  En pratique, si vous avez de nombreuses alertes en cours sur votre compte, les résultats renvoyés par la fonction pourraient inclure moins d’alertes terminées que prévu, ou que des alertes programmées, surtout si la valeur RESULT_LIMIT est relativement faible. Pour interroger l’historique des alertes déjà exécutées, Snowflake recommande d’utiliser une combinaison des arguments SCHEDULED_TIME_RANGE_START => constant_expr et/ou SCHEDULED_TIME_RANGE_END => constant_expr.

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

• Cette fonction peut renvoyer toutes les exécutions exécutées au cours des sept derniers jours ou la prochaine exécution planifiée au cours des huit jours suivants.

Sortie¶

La fonction de table ALERT_HISTORY produit une ligne pour chaque exécution d’alerte. Chaque ligne contient les colonnes suivantes :

Exemples¶

Voir Suivi de l’exécution des alertes.