Utilisation de la page Historique pour surveiller les requêtes

Cette page History Onglet Historique vous permet de consulter et d’approfondir les détails de toutes les requêtes exécutées au cours des 14 derniers jours. La page affiche une liste historique des requêtes, y compris les requêtes exécutées depuis SnowSQL ou d’autres clients SQL.

Note

Pour plus de détails sur l’examen de l’historique des requêtes dans Snowsight, voir Surveillance de l’activité des requêtes avec l’historique des requêtes.

Les informations affichées par défaut pour chaque requête sont les suivantes :

  • Statut actuel des requêtes : en attente dans une file d’attente, en cours d’exécution, réussite, échec.

  • Texte SQL de votre requête.

  • ID de la requête.

  • Informations sur l’entrepôt utilisé pour exécuter la requête.

  • Heure de début et de fin de la requête, ainsi que la durée.

  • Informations sur la requête, y compris le nombre d’octets analysés et le nombre de lignes renvoyées.

Note

Les colonnes Start Time et End Time affichent les heures dans le fuseau horaire de l’utilisateur connecté. Il n’y a pas d’option pour modifier ce paramètre. Les paramètres de session n’affectent pas ce paramètre.

Dans ce chapitre :

Aperçu des fonctions

Page d'historique de la console classique

Note

Les colonnes de la page History sont dérivées de la vue QUERY_HISTORY. Voir Vue QUERY_HISTORY pour plus obtenir d’informations, notamment la description des colonnes.

Vous pouvez effectuer les tâches suivantes dans la page History :

  • Utilisez la case à cocher auto-refresh en haut à droite pour activer/désactiver le rafraîchissement automatique de la session. Si elle est cochée, la page se rafraîchit toutes les 10 secondes. Vous pouvez également cliquer sur l’icône Refresh pour actualiser la page à tout moment.

  • Utilisez le bouton Show/Hide Filters pour ouvrir/fermer un panneau permettant de spécifier un ou plusieurs filtres qui contrôlent les requêtes affichées sur la page. Les filtres que vous spécifiez sont actifs pour la session en cours.

  • Utilisez la case à cocher Include client-generated statements pour afficher ou masquer les instructions SQL exécutées par des sessions d’interface Web en dehors des feuilles de calcul SQL. Par exemple, chaque fois qu’un utilisateur accède à Warehouses Onglet Entrepôts, Snowflake exécute une instruction SHOW WAREHOUSES en arrière-plan. Décochez la case Include client-generated statements pour masquer ce « bruit » dans la liste des requêtes affichées.

  • Utilisez la case à cocher Include queries executed by user tasks pour afficher ou masquer les instructions SQL exécutées ou les procédures stockées appelées par les tâches utilisateur.

  • Faire défiler la liste des requêtes affichées. La liste comprend (jusqu’à) 100 des premières requêtes qui correspondent à vos filtres, ou les 100 dernières requêtes (si aucun filtre n’est appliqué). En bas de la liste, si d’autres requêtes sont disponibles, vous pouvez continuer la recherche, ce qui ajoute (jusqu’à) 100 des prochaines requêtes correspondantes à la liste.

  • Cliquez sur un en-tête de colonne quelconque pour trier la page par colonne ou ajoutez/supprimez des colonnes dans l’affichage.

  • Cliquez sur le texte d’une requête (ou sélectionnez la requête et cliquez sur View SQL) pour afficher le SQL complet de la requête.

  • Sélectionnez une requête qui n’est pas encore terminée et cliquez sur Abort pour annuler la requête.

  • Cliquez sur l’ID d’une requête afin d’afficher les détails de la requête, y compris le résultat et le profil de la requête.

Note

La page History affiche les requêtes exécutées au cours des 14 derniers jours, en commençant par les plus récentes. Vous pouvez utiliser le filtre End Time pour afficher les requêtes basées selon une date spécifiée. Cependant, si vous spécifiez une date antérieure aux 14 derniers jours, aucun résultat ne sera renvoyé.

Affichage des détails et des résultats de la requête

Snowflake conserve le résultat d’une requête pendant un certain temps, après quoi le résultat est purgé. Cette limite n’est pas réglable. Pour plus d’informations, voir Utilisation de résultats de requête persistants.

Pour afficher les détails et le résultat d’une requête particulière, cliquez sur Query ID dans la page History. La page Query Detail apparaît (voir ci-dessous), permettant ainsi voir les détails d’exécution de la requête, ainsi que le résultat (si disponible).

Page de détails des requêtes de la console classique

Vous pouvez également utiliser le bouton Export Result pour exporter le résultat de la requête (s’il est encore disponible) dans un fichier.

Note

Vous ne pouvez voir que les résultats des requêtes que vous avez exécutées. Si vous possédez les privilèges pour voir les requêtes exécutées par un autre utilisateur, la page Query Detail affiche les détails de la requête. Toutefois, pour des raisons de confidentialité des données, la page n’affiche pas le résultat réel de la requête.

Exportation des résultats de requête

Sur une page quelconque de l’interface où vous pouvez voir le résultat d’une requête (par exemple Worksheets, Query Detail), si le résultat de la requête est encore disponible, vous pouvez exporter le résultat dans un fichier.

Lorsque vous cliquez sur le bouton Export Result pour une requête, vous êtes invité à spécifier le nom et le format du fichier. Snowflake prend en charge les formats de fichier suivants pour l’exportation des requêtes :

  • Comma-separated values (CSV)

  • Tab-separated values (TSV)

Note

  • Vous ne pouvez exporter les résultats que pour les requêtes pour lesquelles vous pouvez voir les résultats (c’est-à-dire les requêtes que vous avez exécutées). Si vous n’avez pas exécuté une requête ou si le résultat de la requête n’est plus disponible, le bouton Export Result n’est pas affiché pour la requête.

  • L’interface Web prend uniquement en charge l’exportation de résultats de 100 MB maximum. Si le résultat d’une requête dépasse cette limite, vous êtes invité à procéder ou non à l’exportation.

  • Les invites d’exportation peuvent différer selon votre navigateur. Par exemple, dans Safari, vous êtes uniquement invité à choisir le format d’exportation (CSV ou TSV). Une fois l’exportation terminée, vous êtes invité à télécharger le résultat exporté dans une nouvelle fenêtre dans laquelle vous pouvez utiliser l’option Save Page As… du navigateur pour enregistrer le résultat dans un fichier.

Affichage du profil de requête

Page de profil des requêtes de la console classique

Outre les détails et les résultats de la requête, Snowflake fournit le Query Profile pour analyser les statistiques et les détails de la requête, y compris les composants d’exécution individuels qui composent la requête. Pour plus d’informations, voir Analyse des requêtes à l’aide du profil de requête.

Interrogation des données historiques expurgées d’une Snowflake Native App

Pour les requêtes liées à une Snowflake Native App, les champs query_text et error_message sont expurgés de l’historique de la requête dans les contextes suivants :

  • Les requêtes sont exécutées lors de l’installation ou de la mise à niveau de l’application.

  • Requêtes provenant d’une tâche enfant d’une procédure stockée appartenant à l’application.

Dans chacune de ces situations, la cellule de l’historique de la requête dans Snowsight apparaît vide.