Schéma :: ACCOUNT_USAGE

Vue COMPLETE_TASK_GRAPHS¶

Vous pouvez utiliser la vue Account Usage pour demander le statut des exécutions graphiques terminées, telles que les exécutions qui se sont déroulées avec succès, qui ont échoué ou qui ont été annulées. Un graphique est actuellement défini comme une tâche planifiée unique ou un graphique de tâches composé d’une tâche racine planifiée et d’une ou plusieurs tâches enfants. 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 graphique de tâches.

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.
SCHEDULED_FROM	TEXT	Une des options : `SCHEDULE` : La tâche a été planifiée pour s’exécuter normalement, comme décrit dans les clauses SCHEDULE ou AFTER de CREATE TASK. `EXECUTE TASK` : l’exécution de la tâche était planifiée à l’aide de EXECUTE TASK. `MANUAL RETRY` : l’exécution de la tâche était planifiée à l’aide de EXECUTE TASK … RETRY LAST. `TRIGGER` : la tâche a été exécutée parce que le flux, dans la clause `WHEN` de la tâche, contenait de nouvelles données. Pour les exécutions de tâches enfant dans un graphique de tâches, la colonne renvoie la même valeur que l’exécution de la tâche racine.
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	Heure à laquelle la tâche autonome ou racine (dans un DAG de tâches) doit ensuite commencer à s’exécuter, en supposant que l’exécution en cours de la tâche autonome ou du DAG démarré à l’heure SCHEDULED_TIME se termine à temps.
COMPLETED_TIME	TIMESTAMP_LTZ	Heure à laquelle la dernière tâche de DAG s’est achevée.
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.
GRAPH_VERSION	NUMBER	Entier identifiant la version du DAG qui a été exécuté ou doit être exécuté.
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.
ATTEMPT_NUMBER	NUMBER	Entier représentant le nombre de tentatives d’exécution de cette tâche. Initialement un.
CONFIG	TEXT	Affiche la configuration au niveau du graphique utilisée pendant l’exécution du graphique si elle est explicitement définie. Dans le cas contraire, affiche NULL.
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	Réservé pour une utilisation future. La valeur renvoyée pour toutes les lignes est NULL.

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;

Copy