Historique des requêtes

Remarque

Si votre espace de travail est activé pour le calcul serverless, votre historique des requêtes contient également toutes les requêtes SQL et Python exécutées sur le calcul serverless pour les notebooks et les travaux. Voir Se connecter à un calcul sans serveur.

Si votre espace de travail a le historique des requêtes et le profil pour les pipelines déclaratifs Lakeflow activé (préversion publique), votre historique des requêtes affiche les instructions CREATE et REFRESH exécutées sur un entrepôt SQL ou via des pipelines déclaratifs Lakeflow.

Vous pouvez utiliser les informations disponibles sur cet écran pour vous aider à déboguer les problèmes liés aux requêtes.

Cette section décrit comment utiliser l’historique des requêtes avec l’interface utilisateur. Pour travailler avec l’historique des requêtes à l’aide de l’API, consultez historique des requêtes.

Voir l’historique des requêtes

Vous pouvez afficher les exécutions de requête précédentes si vous êtes le propriétaire de la requête. D’autres utilisateurs peuvent afficher les exécutions de requête s’ils disposent au moins d’un accès CAN VIEW à l’entrepôt SQL qui a exécuté la requête.

Pour afficher les exécutions précédentes pour une requête :

1. Cliquez sur Historique des requêtes dans la barre latérale.
2. Si vous le souhaitez, utilisez les filtres en haut de la page pour filtrer la liste par utilisateur, plage de dates, calcul, durée, état de la requête, type d’instruction et ID d’instruction.

Remarque

Les requêtes Databricks SQL partagées par un utilisateur disposant d’autorisations Exécuter en tant que propriétaire pour un autre utilisateur disposant d’autorisations CAN RUN apparaissent dans l’historique des requêtes de l’utilisateur qui exécute la requête et non l’utilisateur qui a partagé la requête.

Afficher les détails de la requête

Pour afficher des détails sur une requête, tels que l’instruction de requête complète, la source de requête, la durée, le nombre de lignes retournées et les performances d’E/S ou les détails d’exécution.

1. Accédez à l’historique des requêtes comme indiqué dans la section précédente.

2. Cliquez sur le texte de requête à afficher. Un panneau récapitulative s’ouvre à droite.

   

   • État de la requête : La requête est marquée avec son état actuel : Mise en file d’attente, Exécution, Fin, Échec ou Annulation.
   • Détails de l’utilisateur et du calcul : Consultez les détails du nom d’utilisateur, du type de calcul et du runtime pour cette exécution de requête.
   • ID: Il s’agit de l’identificateur universel unique (UUID) associé à l’exécution de requête donnée.
   • Instruction de requête : Cette section inclut l’instruction de requête complète. Si la requête est trop longue pour être affichée dans l’aperçu, cliquez sur ... plus de lignes pour afficher le texte intégral.
   • Métriques de requête : Les métriques populaires pour l’analyse des requêtes sont affichées sous le texte de la requête. Les icônes de filtre qui s’affichent avec certaines métriques indiquent le pourcentage de données élaguées lors de l’analyse.
   • Consultez le profil de requête : Un aperçu du profil de requête dirigé vers un graphe acyclique (DAG) s’affiche dans ce résumé. Cela peut être utile pour estimer rapidement la complexité et le flux d’exécution des requêtes. Cliquez sur Afficher le profil de requête pour ouvrir le DAG détaillé.
   • Consultez les opérateurs les plus longs pour cette requête : Cliquez sur ce bouton pour ouvrir le panneau Opérateurs principaux . Ce volet affiche les opérateurs en cours d’exécution les plus longs dans la requête.
   • Durée de l'horloge de la requête : Le temps total écoulé entre le début de la planification et la fin de l'exécution de la requête est fourni sous forme de résumé. Une répartition détaillée de la planification, de l’optimisation des requêtes et de la taille des fichiers et du temps d’exécution apparaît sous le résumé.
   • Source de requête : Cliquez sur le nom de l’objet répertorié pour accéder à la source de la requête.
   • Heure de la tâche agrégée : Affichez le temps combiné nécessaire pour exécuter la requête sur tous les cœurs de tous les nœuds. Il peut être beaucoup plus long que la durée de l’horloge murale si plusieurs tâches sont excutées en parallèle. Elle peut être plus courte que la durée de l’horloge murale si les tâches attendent des nœuds disponibles.
   • Entrée/sortie (E/S) : Affichez des détails sur les données lues et écrites pendant l’exécution de la requête.

3. Pour plus d’informations sur les performances de la requête, y compris son plan d’exécution, cliquez sur Afficher le profil de requête en bas de la page. Pour plus de détails, voir Profil de la requête.

Terminer une requête en cours d'exécution

Pour terminer une requête de longue durée démarrée par vous ou un autre utilisateur :

1. Accédez à l’historique des requêtes comme indiqué dans la section précédente.

2. Cliquez sur le texte de la requête.

3. En regard du champ Status (États), cliquez sur Cancel (Annuler).

   Remarque

   Annuler s’affiche seulement quand une requête est en cours d’exécution.

La requête est terminée et son état change en annulation.

Remarque

Les instructions utilisant les pipelines déclaratifs Lakeflow pour le calcul ne peuvent être annulées qu'à partir de l'interface utilisateur de Pipelines.

Accéder à la table système de l'historique des requêtes

Les tables système Azure Databricks incluent une table d’historique des requêtes (system.query.history) où les utilisateurs privilégiés peuvent afficher les enregistrements d’historique des requêtes tabulaires à partir de votre compte. Par défaut, seuls les administrateurs ont accès aux tables système de votre compte. Pour plus d’informations sur l’activation et l’accès à la table système de l’historique des requêtes, consultez Informations de référence sur la table système de l’historique des requêtes.