Schéma :: ACCOUNT_USAGE

Vue ALERT_HISTORY¶

Cette vue Account Usage vous permet de récupérer l’historique de l’utilisation des alertes au cours des 365 derniers jours (1 année). La vue affiche une ligne pour chaque exécution d’alerte, dans l’historique.

Colonnes¶

Nom de la colonne	Type de données	Description
NAME	VARCHAR	Nom de l’alerte.
DATABASE_NAME	VARCHAR	Nom de la base de données contenant l’alerte.
SCHEMA_NAME	VARCHAR	Nom du schéma contenant l’alerte.
CONDITION	VARCHAR	Texte de l’instruction SQL qui sert de condition à l’alerte.
CONDITION_QUERY_ID	VARCHAR	Identificateur interne/système pour l’instruction SQL exécutée comme condition de l’alerte.
ACTION	VARCHAR	Texte de l’instruction SQL qui sert d’action pour l’alerte.
ACTION_QUERY_ID	VARCHAR	Identificateur interne/système pour l’instruction SQL exécutée comme action de l’alerte.
ERROR_CODE	NUMBER	Code d’erreur, si l’instruction a renvoyé une erreur ou n’a pas pu être exécutée (par exemple, si l’utilisateur actuel n’avait pas les privilèges pour exécuter l’alerte).
ERROR_MESSAGE	VARCHAR	Message d’erreur si l’instruction a renvoyé une erreur.
STATE	VARCHAR	Statut de l’alerte. Il peut s’agir de l’un des éléments suivants : . SCHEDULED : l’alerte sera exécutée à l’heure spécifiée par la colonne SCHEDULED_TIME. . EXECUTING : la condition ou l’action de l’alerte est en cours d’exécution. . FAILED : l’alerte a échoué. La condition ou l’action d’alerte a rencontré une erreur qui a empêché son exécution. . CANCELLED : l’exécution de l’alerte a été annulée (par exemple, lorsque l’alerte est suspendue). . CONDITION_FALSE : la condition a été évaluée avec succès mais n’a renvoyé aucune donnée. En conséquence, l’action n’a pas été exécutée. . CONDITION_FAILED : l’évaluation de la condition a échoué. Pour plus de détails sur l’échec, vérifiez les colonnes ERROR_CODE et ERROR_MESSAGE. . ACTION_FAILED : la condition a été évaluée avec succès, mais l’exécution de l’action a échoué. Pour plus de détails sur l’échec, vérifiez les colonnes ERROR_CODE et ERROR_MESSAGE. . TRIGGERED : la condition a été évaluée avec succès, et l’action a été exécutée avec succès.
SCHEDULED_TIME	TIMESTAMP_LTZ	Heure à laquelle le début de l’exécution de la tâche est/était programmée. Notez que nous faisons de notre mieux pour assurer une précision absolue, mais nous garantissons uniquement que les alertes ne s’exécutent pas avant leur heure programmée.
COMPLETED_TIME	TIMESTAMP_LTZ	Heure de fin de la tâche ou NULL si SCHEDULED_TIME est dans le futur ou si l’alerte est toujours en cours d’exécution.
DATABASE_ID	NUMBER	Identificateur interne / généré par le système pour la base de données contenant le schéma.
SCHEMA_ID	NUMBER	Identifiant interne / généré par le système pour le schéma.

Notes sur l’utilisation¶

La latence pour la vue peut atteindre 45 minutes.

Pour des performances accrues, filtrez les requêtes sur la colonne COMPLETED_TIME ou SCHEDULED_TIME.

Exemples¶

Récupérer les enregistrements pour les 10 dernières exécutions de tâches :

SELECT name, condition, condition_query_id, action, action_query_id, state
FROM snowflake.account_usage.alert_history
LIMIT 10;

Copy

Récupérer les enregistrements des tâches effectuées au cours de l’heure écoulée :

SELECT name, condition, condition_query_id, action, action_query_id, state
FROM snowflake.account_usage.alert_history
WHERE COMPLETED_TIME > DATEADD(hours, -1, CURRENT_TIMESTAMP());

Copy