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ée 1). 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
NAME	TEXT	Nom de 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.
SCHEMA_NAME	TEXT	Nom du schéma contenant la tâche.
TASK_SCHEMA_ID	NUMBER	Identificateur interne/généré par le système pour le schéma contenant la tâche.
DATABASE_NAME	TEXT	Nom de la base de données contenant la tâche.
TASK_DATABASE_ID	NUMBER	Identificateur interne/généré par le système pour la base de données contenant la tâche.
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.
COMPLETED_TIME	TIMESTAMP_LTZ	Heure à laquelle la tâche est terminée.
STATE	TEXT	Statut de la tâche terminée : SUCCEEDED, FAILED, CANCELLED, ou 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.
RETURN_VALUE	TEXT	Valeur définie pour le prédécesseur dans un DAG de tâches. La valeur de retour est définie explicitement par le prédécesseur en appelant la fonction SYSTEM$SET_RETURN_VALUE.
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.
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 requête renvoyée par QUERY_HISTORY.
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.
GRAPH_VERSION	NUMBER	Entier identifiant la version du DAG qui a été exécuté ou doit être exécuté. Chaque augmentation incrémentielle de la valeur représente une ou plusieurs modifications des tâches dans le DAG. 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 un DAG est/devait initialement démarrer. Le format est l’heure de l’époque (en millisecondes). . . 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. . . Veuillez noter que RUN_ID peut ne pas être un identificateur unique pour la tâche/le graphique en cours d’exécution avant la nouvelle tentative. Vous pouvez utiliser la colonne GRAPH_RUN_GROUP_ID pour remplacer RUN_ID.
ROOT_TASK_ID	TEXT	Identificateur unique de la tâche racine dans un DAG. Cet ID correspond à la valeur de la colonne ID dans la sortie SHOW TASKS pour la même tâche.
SCHEDULED_FROM	TEXT	Mécanisme qui a provoqué l’exécution de la tâche : SCHEDULE indique que l’exécution de la tâche a été lancée par la planification dans la définition de la tâche. EXECUTE TASK indique que l’exécution de la tâche a été initiée par l’exécution d’une instruction EXECUTE TASK. Pour les exécutions de tâches enfant dans un DAG, la colonne renvoie la même valeur que l’exécution de la tâche racine.
ATTEMPT_NUMBER	NUMBER	Entier représentant le nombre de tentatives d’exécution de cette tâche. Initialement un.
INSTANCE_ID	NUMBER	Identificateur interne/généré par le système pour l’instance à laquelle l’objet appartient.
CONFIG	TEXT	Affiche la configuration du niveau graphique si elle est définie pour la tâche racine, sinon affiche NULL.
QUERY_HASH	TEXT	La valeur de hachage calculée sur la base du texte SQL canonisé. 1
QUERY_HASH_VERSION	NUMBER	La version de la logique utilisée pour calculer `QUERY_HASH`. 1
QUERY_PARAMETERIZED_HASH	TEXT	La valeur de hachage calculée à partir de la requête paramétrée. 1
QUERY_PARAMETERIZED_HASH_VERSION	NUMBER	La version de la logique utilisée pour calculer `QUERY_PARAMETERIZED_HASH`. 1
GRAPH_RUN_GROUP_ID	NUMBER	Identificateur de l’exécution du graphique. Lorsqu’un graphique comporte plusieurs tâches, chacune d’entre elles affiche le même GRAPH_RUN_GROUP_ID. La combinaison de GRAPH_RUN_GROUP_ID, et ATTEMPT_NUMBER peut être utilisée pour identifier de manière unique l’exécution d’un graphique.
BACKFILL_INFO	OBJECT	Reserved for future use. The returned value for all rows is NULL.

1(1,2,3,4): Cette colonne n’est présente que lorsque le bundle de changements de comportement 2023_06 est activé. Cette colonne fait partie de la fonction de hachage de la requête.

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 query_text, completed_time
FROM snowflake.account_usage.task_history
LIMIT 10;

Copy

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

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

Copy