Schéma :: ACCOUNT_USAGE

Vue COMPLETE_TASK_GRAPHS¶

Cette vue Account Usage peut être utilisée pour demander le statut des exécutions de graphiques terminées (c’est-à-dire les exécutions qui ont réussi, qui ont échoué ou qui ont été annulées). Un graphique est actuellement défini comme une tâche planifiée unique ou un DAG de tâches composé d’une tâche racine planifiée et d’une ou plusieurs tâches enfants (c’est-à-dire des tâches qui ont une tâche prédécesseur définie). Dans le cadre de cette fonction, la tâche racine désigne soit la tâche planifiée unique, soit la tâche racine d’un DAG.

La vue évite la limitation de 10 000 lignes de COMPLETE_TASK_GRAPHS.

Colonnes¶

Nom de la colonne	Type de données	Description
ROOT_TASK_NAME	TEXT	Nom de la tâche racine.
DATABASE_NAME	TEXT	Nom de la base de données contenant le graphique.
SCHEMA_NAME	TEXT	Nom du schéma contenant le graphique.
STATE	TEXT	Statut de l’exécution du graphique : `SUCCEEDED` : toutes les tâches du graphique se sont exécutées avec succès jusqu’à leur terme, ou l’exécution de la tâche racine a réussi et une ou plusieurs exécutions de tâches enfants ont été ignorées. `FAILED` : une ou plusieurs exécutions de tâches dans le graphique ont échoué, ou l’exécution de la tâche racine a réussi et une ou plusieurs exécutions de tâches enfants ont échoué. `CANCELLED` : une ou plusieurs exécutions de tâches dans le graphique ont été annulées, ou l’exécution de la tâche racine a réussi et une ou plusieurs exécutions de tâches enfants ont été annulées. Notez que si le statut de l’exécution de la tâche racine est SKIPPED, la fonction ne renvoie pas de ligne pour l’exécution.
FIRST_ERROR_TASK_NAME	TEXT	Nom de la première tâche du graphique qui a produit une erreur ; renvoie NULL si aucune tâche n’a produit d’erreur.
FIRST_ERROR_CODE	NUMBER	Code d’erreur de l’erreur renvoyée par la tâche nommée dans FIRST_ERROR_TASK_NAME ; renvoie NULL si aucune tâche n’a produit d’erreur.
FIRST_ERROR_MESSAGE	TEXT	Message d’erreur de l’erreur renvoyée par la tâche nommée dans FIRST_ERROR_TASK_NAME ; renvoie NULL si aucune tâche n’a produit d’erreur.
SCHEDULED_TIME	TIMESTAMP_LTZ	Heure à laquelle l’exécution de la tâche racine a été planifiée. 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 racine a commencé à s’exécuter. Cet horodatage s’aligne sur l’heure de début de la requête renvoyée par QUERY_HISTORY.
NEXT_SCHEDULED_TIME	TIMESTAMP_LTZ	Time when the standalone or root task (in a DAG of tasks) is next scheduled to start running, assuming the current run of the standalone task or DAG started at the SCHEDULED_TIME time completes in time.
COMPLETED_TIME	TIMESTAMP_LTZ	Time when the last task in the DAG was completed.
ROOT_TASK_ID	TEXT	Unique identifier for the root task in a DAG. This ID matches the ID column value in the SHOW TASKS output for the same task.
GRAPH_VERSION	NUMBER	Integer identifying the version of the DAG that was run, or is scheduled to be run.
RUN_ID	NUMBER	Time when the standalone or root task in a DAG is/was originally scheduled to start running. Format is epoch time (in milliseconds). The combination of the ROOT_TASK_ID and RUN_ID values identifies a specific run of a DAG. . Original scheduled time refers to rare instances when the system may reschedule the same task to run at a different time to retry it or rebalance the load. If that happens, RUN_ID shows the original scheduled run time and SCHEDULED_TIME shows the rescheduled run time.

Notes sur l’utilisation¶

La latence pour la vue peut atteindre 45 minutes.
La vue n’affiche que les objets pour lesquels le rôle actuel de la session s’est vu accorder des privilèges d’accès.

Exemples¶

Récupérer les enregistrements des 10 dernières exécutions de graphique des tâches effectuées dans votre compte :

select root_task_name, state from snowflake.account_usage.complete_task_graphs
  limit 10;