Schéma :

ORGANIZATION_USAGE

Vue ALERT_HISTORY

Important

Cette vue n’est disponible que dans le compte de l’organisation. Pour plus d’informations, voir Vues premium dans le compte de l’organisation.

La vue Utilisation de l’organisation vous permet de récupérer l’historique de l’utilisation de l”alerte. La vue affiche une ligne pour chaque exécution d’une alerte dans l’historique.

Colonnes

Colonnes au niveau de l’organisation

Nom de la colonne

Type de données

Description

ORGANIZATION_NAME

VARCHAR

Nom de l’organisation.

ACCOUNT_LOCATOR

VARCHAR

Identificateur du compte généré par le système.

ACCOUNT_NAME

VARCHAR

Identificateur défini par l’utilisateur pour le compte.

Colonnes supplémentaires

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.

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.

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.

ERROR_CODE

NUMBER

Code d’erreur, si l’alerte renvoie une erreur ou ne s’exécute pas (par exemple, si l’utilisateur actuel n’a pas les privilèges pour exécuter l’alerte).

ERROR_MESSAGE

VARCHAR

Message d’erreur si l’alerte a renvoyé une erreur.

STATE

VARCHAR

Statut de l’alerte. Elle peut être sous la forme suivante :

  • SCHEDULED : l’alerte s’exécutera à l’heure spécifiée par la colonne SCHEDULED_TIME. Ce statut ne s’applique pas aux alertes sur de nouvelles données.

  • 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. Ce statut ne s’applique pas aux alertes sur de nouvelles données.

  • 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 l’alerte planifiée est/était censée commencer à s’exécuter.

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.

SCHEDULED_FROM

VARCHAR

Spécifie ce qui a déclenché l’alerte. La colonne contient l’une des valeurs suivantes :

  • SCHEDULE : l’alerte a été planifiée pour s’exécuter normalement, comme décrit dans la clause SCHEDULE de CREATE ALERT.

  • EXECUTE ALERT : l’alerte a été planifiée à l’aide de EXECUTE ALERT.

  • TRIGGER : l’alerte sur les nouvelles données a été exécutée parce que la table ou la vue sous-jacente contient de nouvelles données.

Notes sur l’utilisation

  • La latence pour la vue peut atteindre 24 heures.

  • 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 account_name, name, condition, condition_query_id, action, action_query_id, state
  FROM snowflake.organization_usage.alert_history
  LIMIT 10;
Copy

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

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