Affichage des tâches et des graphiques de tâches dans Snowsight¶

Privilèges requis pour voir l’historique des tâches¶

Pour voir l’historique des tâches dans Snowsight, vous devez disposer des mêmes privilèges que ceux requis pour exécuter la fonction TASK_HISTORY. En d’autres termes, vous devez utiliser un rôle qui inclut l’un des rôles ou privilèges suivants sur la tâche :

• Le rôle ACCOUNTADMIN.

• Le rôle disposant du privilège OWNERSHIP sur la tâche (c’est-à-dire le propriétaire de la tâche).

• Le privilège MONITOR ou OPERATE sur la tâche.

• Le privilège MONITOR EXECUTION global.

Le rôle que vous utilisez doit pouvoir interroger la vue TASK_HISTORY Account Usage. Vous pouvez attribuer le rôle de base de données USAGE_VIEWER dans la base de données partagée SNOWFLAKE au rôle que vous utilisez.

Par exemple, pour voir l’historique de la tâche mytask, vous pouvez accorder le privilège OWNERSHIP sur cette tâche et le rôle de base de données USAGE_VIEWER sur la base de données Snowflake partagée en exécutant les commandes SQL suivantes :

GRANT OWNERSHIP ON TASK mytask TO ROLE myrole;
GRANT DATABASE ROLE USAGE_VIEWER TO ROLE myrole;

Pour plus de détails, voir :

• Rôles de base de données SNOWFLAKE du schéma ACCOUNT_USAGE

• GRANT DATABASE ROLE

Vérifier l’historique d’exécution d’une tâche¶

L’historique d’exécution des tâches comprend des détails sur chaque exécution d’une tâche donnée. Vous pouvez voir l’heure d’exécution planifiée, le statut, la valeur de retour, la durée d’une tâche et d’autres informations.

Pour chaque instance, vous pouvez voir les éléments suivants :

• Heure d’exécution planifiée : Heure d’exécution de la tâche planifiée.

• Statut : Statut de la dernière tentative d’exécution de la tâche.

• Durée : Durée, en secondes, de l’exécution de la tâche.

Pour voir l’historique de l’exécution :

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Catalog » Database Explorer.

3. Dans le volet de droite, à l’aide de l’explorateur d’objets, naviguez vers une base de données et un schéma.

4. Pour le schéma sélectionné, sélectionnez et développez Tasks.

5. Sélectionnez une tâche. Les informations sur la tâche s’affichent, y compris les sous-onglets Task Details, Graph et Run History.

6. Sélectionnez l’onglet Run History.

Vérifier l’historique des tâches au niveau du compte¶

Examinez l’historique des exécutions de tâches au niveau du compte pour identifier les tâches qui échouent, les tâches qui durent longtemps et d’autres cas de surveillance et de débogage pour un compte entier, plutôt que pour une tâche spécifique.

To view account-level history for tasks, perform the following steps:

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Transformation » Tasks.

3. Pour voir les exécutions de tâches individuelles, sélectionnez View » Task Runs dans les filtres.

Après avoir sélectionné l’historique des exécutions de tâches, vous pouvez filtrer la page pour afficher les informations pertinentes.

• Sélectionnez le filtre Date Range pour afficher l’historique des tâches du dernier jour aux 12 derniers mois, ou une plage personnalisée.

• Sélectionnez le filtre Task status pour afficher l’historique des tâches pour un ou plusieurs statuts, tels que Succeeded, Failed, Cancelled ou Skipped.

• Filtrez par nom de tâche pour voir les tendances en matière de statut ou de durée dans le temps pour des tâches spécifiques.

• Filtrez par nom de la base de données ou du schéma qui contient les tâches.

Par exemple, pour identifier les tâches de longue durée, sélectionnez le filtre Status pour n’afficher que les tâches réussies, et triez le champ Duration par ordre décroissant. Pour un débogage avancé, vous pouvez ouvrir le tableau filtré et trié dans les feuilles de calcul en utilisant le bouton Open in worksheets. Vous pouvez alors modifier l’instruction SQL avec les arguments LIMIT / FETCH et GROUP BY pour identifier les bases de données et les schémas avec un classement des 25 plus longues tâches.

Vous pouvez également sélectionner une tâche spécifique pour obtenir plus de détails.

Viewing the Tasks page¶

To identify failing tasks, long-running tasks, and other monitoring and debugging cases, review the history of your task graph runs on the Tasks page.

Pour voir les exécutions du graphique des tâches, procédez comme suit :

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Transformation » Tasks.

   

Dans l’onglet Task Graphs, vous pouvez effectuer les opérations suivantes :

• Survolez le compteur Previous Runs pour afficher le statut des dernières exécutions dans l’ordre chronologique.

• Le graphique Duration Trend visualise les durées d’exécution des tâches dans le temps (sur la base de la plage de dates sélectionnée) en mettant en évidence une ligne médiane à l’intérieur d’une plage min-max. Vous pouvez ainsi déterminer rapidement si la durée des tâches est stable, si elle fluctue ou si elle suit une tendance, et identifier les valeurs aberrantes.

• Utilisez le menu à points de suspension pour exécuter manuellement le graphique, modifier la tâche racine (par exemple, modifier la planification ou les paramètres) ou suspendre/reprendre le graphique.

Vous pouvez filtrer la page pour afficher les informations pertinentes. Il est recommandé de filtrer par base de données et par schéma afin de réduire les temps de chargement sur les comptes importants.

• Sélectionnez le filtre Date Range pour afficher l’historique des tâches des 7 derniers jours (paramètre par défaut). Vous pouvez le remplacer par 1 jour. Notez que le filtre de la plage de dates ne s’applique qu’au compteur des exécutions précédentes et aux tendances de la durée d’exécution.

• Sélectionnez le filtre Last Run Status pour afficher les graphiques des tâches pour un ou plusieurs statuts, tels que Succeeded, Failed, Canceled ou Skipped lors de l’exécution la plus récente. Ce filtre s’applique uniquement à la dernière exécution terminée d’un graphique de tâches.

• Filtre sur le nom de la base de données ou du schéma qui contient les tâches.

• Utilisez le champ de recherche pour filtrer sur le nom de la tâche racine.

Vous pouvez également sélectionner un graphique de tâche spécifique pour obtenir plus de détails, comme le montre l’image suivante :

La sélection d’un graphique de tâches ouvre toujours les détails de l’exécution la plus récente. Si vous souhaitez consulter les détails d’un cycle précédent, vous pouvez sélectionner Open previous runs sur la page du cycle graphique spécifique.

Accès au graphique des tâches à partir d’une page d’objet de tâche¶

Avec cette avant-première, vous pouvez également accéder à la page Task Graph à partir d’une page d’historique d’exécution spécifique si la tâche fait partie d’un graphique de tâches.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Catalog » Database Explorer.

3. Dans le volet de droite, à l’aide de l’explorateur d’objets, naviguez vers une base de données et un schéma.

4. Pour le schéma sélectionné, sélectionnez et développez Tasks.

5. Sélectionnez une tâche. Les informations sur la tâche s’affichent, y compris les sous-onglets Task Details, Graph et Run History.

6. Sélectionnez l’onglet Run History.

7. Si la tâche est associée à un graphique de tâches, un onglet Task Graph se trouve à côté de Task, comme le montre l’image suivante.

   Sélectionnez Task Graph pour voir les détails du graphique de la tâche.

   

Considérations et limites¶

• Pour voir un graphique de tâches dans le cadre de cette fonction, vous devez avoir un rôle comportant au moins l’un des privilèges suivants :

  • Privilèges OWNERSHIP sur la tâche (c’est-à-dire le propriétaire de la tâche).

  • Privilèges MONITOR ou OPERATE sur la tâche.

  • Le privilège MONITOR EXECUTION global.

  • Le rôle ACCOUNTADMIN.

  Le rôle doit également disposer du privilège USAGE sur la base de données et le schéma qui stockent la tâche, sinon les valeurs DATABASE_NAME et SCHEMA_NAME dans la sortie sont NULL.