Schéma :

ACCOUNT_USAGE

Vue TASK_HISTORY

Cette vue Account Usage vous permet de récupérer l’historique de l’utilisation des tâches au cours des 365 derniers jours (année1), lorsque ces métadonnées d’historique sont disponibles. La vue affiche une ligne pour chaque série de tâches dans l’historique.

Colonnes

Nom de la colonne	Type de données	Description
QUERY_ID	TEXT	ID de l’instruction SQL exécutée par la tâche. Peut être associé à la vue QUERY_HISTORY pour obtenir des détails supplémentaires sur l’exécution de l’instruction ou de la procédure stockée.
NAME	TEXT	Nom de la tâche.
DATABASE_NAME	TEXT	Nom de la base de données contenant la tâche.
SCHEMA_NAME	TEXT	Nom du schéma contenant la tâche.
QUERY_TEXT	TEXT	Texte de l’instruction SQL.
CONDITION_TEXT	TEXT	Texte de la condition WHEN que la tâche évalue lors de la détermination de l’exécution.
STATE	TEXT	Statut de la tâche terminée : SUCCEEDED, FAILED ou CANCELLED. A partir de novembre 2020, la vue renvoie également les tâches avec un statut SKIPPED. Notez que la vue ne renvoie pas d’exécutions de tâches SCHEDULED ou EXECUTING. Pour récupérer les détails de l’historique des tâches pour les exécutions dans un statut planifié ou en cours d’exécution, interrogez la fonction de la table TASK_HISTORY dans Information Schema.
ERROR_CODE	NUMBER	Code d’erreur, si l’instruction a renvoyé une erreur.
ERROR_MESSAGE	TEXT	Message d’erreur si l’instruction a renvoyé une erreur.
SCHEDULED_TIME	TIMESTAMP_LTZ	Heure à laquelle la tâche est/était programmée pour commencer à s’exécuter. Notez que nous faisons de notre mieux pour assurer une précision absolue, mais nous garantissons uniquement que les tâches ne s’exécutent pas avant leur heure programmée.
QUERY_START_TIME	TIMESTAMP_LTZ	Heure à laquelle la requête dans la définition de tâche a commencé à s’exécuter. Cet horodatage s’aligne sur l’heure de début de la demande renvoyée par QUERY_HISTORY.
COMPLETED_TIME	TIMESTAMP_LTZ	Heure à laquelle la tâche est terminée.
ROOT_TASK_ID	TEXT	Identificateur unique de la tâche racine dans une arborescence de tâches. Cet ID correspond à la valeur de la colonne ID dans la sortie SHOW TASKS pour la même tâche.
GRAPH_VERSION	NUMBER	Entier identifiant la version de l’arborescence des tâches qui a été exécutée ou doit être exécutée. Chaque augmentation incrémentielle de la valeur représente une ou plusieurs modifications des tâches dans l’arborescence. Si la tâche racine est recréée (à l’aide de CREATE OR REPLACE TASK), le numéro de version redémarre à partir de 1.
RUN_ID	NUMBER	Heure à laquelle la tâche autonome ou racine dans une arborescence de tâches est/devait initialement démarrer. Le format est l’heure de l’époque (en millisecondes). La combinaison des valeurs ROOT_TASK_ID et RUN_ID identifie une exécution spécifique d’une arborescence de tâches. . L’heure planifiée d’origine se réfère à de rares cas où le système peut replanifier la même tâche pour qu’elle s’exécute à un autre moment pour la réessayer ou rééquilibrer la charge. Si cela se produit, RUN_ID affiche l’heure d’exécution planifiée d’origine et SCHEDULED_TIME affiche l’heure d’exécution reprogrammée.
RETURN_VALUE	TEXT	Valeur définie pour le prédécesseur dans une arborescence de tâches. La valeur de retour est définie explicitement par le prédécesseur en appelant la fonction SYSTEM$SET_RETURN_VALUE.

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. Consultez la section Exemples (dans cette rubrique).

Exemples

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

SELECT * FROM snowflake.account_usage.task_history
  LIMIT 10;

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

SELECT * FROM snowflake.account_usage.task_history
    WHERE COMPLETED_TIME > DATEADD(hours, -1, CURRENT_TIMESTAMP());