Surveiller vos requêtes T-SQL en cours d’exécution et terminées à l’aide de l’activité des requêtes
S’applique à : 
point de terminaison d’analytique SQL et entrepôt dans Microsoft Fabric
La surveillance des requêtes SQL est essentielle à la supervision et à la résolution des problèmes de performances de votre entrepôt Fabric, ainsi qu’à la maintenance de l’efficacité de l’entrepôt. Avec l’activité des requêtes, vous disposez d’une vue unique de toutes les requêtes T-SQL en cours d’exécution et d’historique, ainsi que d’une liste de requêtes longues et fréquemment exécutées sans avoir à exécuter de code T-SQL. Vous pouvez utiliser l’activité des requêtes pour vous assurer que les requêtes ne prennent pas plus de temps que prévu pour s’exécuter et qu’elles se terminent correctement.
Prérequis
- Vous devez être administrateur dans votre espace de travail pour accéder à l’activité des requêtes. Les membres, contributeurs, viewers n’ont pas l’autorisation d’accéder à cette vue.
Bien démarrer
Vous pouvez lancer l’expérience d’activité des requêtes de deux façons.
Sélectionnez Plus d’options (...) en regard de l’entrepôt que vous souhaitez surveiller dans l’affichage de l’espace de travail, puis sélectionnez Activité des requêtes.
Dans l’éditeur de requête de l’entrepôt que vous souhaitez surveiller, sélectionnez Activité des requêtes dans le ruban.
Exécutions des requêtes
Sur la page Exécutions des requêtes, vous pouvez voir une liste des requêtes en cours d’exécution, réussies, annulées et ayant échoué au cours des 30 derniers jours.
- Utilisez la liste déroulante pour filtrer le statut, l’expéditeur ou l’heure d’envoi.
- Utilisez la barre de recherche pour filtrer des mot clé spécifiques dans le texte de la requête ou d’autres colonnes.
Pour chaque requête, les détails suivants sont fournis :
| Nom de colonne | Description |
|---|---|
| ID d’instruction distribuée | ID unique pour chaque requête |
| Texte de la requête | Texte de la requête exécutée (jusqu’à 8 000 caractères) |
| Heure d’envoi (UTC) | Horodateur de la réception de la requête |
| Durée | Durée d’exécution de la requête |
| État | Statut de la requête (En cours d’exécution, réussie, échec ou annulée) |
| Expéditeur | Nom de l’utilisateur ou du système qui a envoyé la requête |
| ID de session | ID liant la requête à une session utilisateur spécifique |
| Exécution source | Nom du programme client qui a lancé la session |
Lorsque vous souhaitez recharger les requêtes affichées sur la page, sélectionnez le bouton Actualiser dans le ruban. Si vous voyez une requête en cours d’exécution que vous souhaitez arrêter immédiatement, sélectionnez la requête à l’aide de la case à cocher, puis le bouton Annuler. Vous serez invité dans une boîte de dialogue à confirmer l’annulation de la requête. Toutes les requêtes non sélectionnées qui font partie des mêmes sessions SQL que vous sélectionnez seront également annulées.
Les mêmes informations concernant les requêtes en cours d’exécution sont également disponibles dans les vues de gestion dynamique.
Insights de requête
Sur la page Insights des requêtes, vous pouvez voir une liste des requêtes longues et fréquemment exécutées pour vous aider à déterminer les tendances dans les requêtes de votre entrepôt.
Pour chaque requête dans l’insight des requêtes longues, les détails suivants sont fournis :
| Nom de colonne | Description |
|---|---|
| Texte de la requête | Texte de la requête exécutée (jusqu’à 8 000 caractères) |
| Durée médiane d’exécution | Temps d’exécution de requête médian (ms) entre les exécutions |
| Nombre d’exécutions | Nombre total de fois où la requête a été exécutée |
| Durée de la dernière exécution | Temps de la dernière exécution (ms) |
| ID de l’instruction distribuée de la dernière exécution | ID unique pour la dernière exécution de la requête |
| ID de session de la dernière exécution | ID de session pour la dernière exécution |
Pour chaque requête dans l’insight des requêtes fréquemment exécutées, les détails suivants sont fournis :
| Nom de colonne | Description |
|---|---|
| Texte de la requête | Texte de la requête exécutée (jusqu’à 8 000 caractères) |
| Durée moyenne d’exécution | Durée moyenne d’exécution des requêtes (ms) entre les exécutions |
| Durée maximale | Temps d’exécution de requête le plus long (ms) |
| Durée minimale | Durée d’exécution de requête la plus courte (ms) |
| ID de l’instruction distribuée de la dernière exécution | ID unique pour la dernière exécution de la requête |
| Nombre d’exécutions | Nombre total de fois où la requête a été exécutée |
| Nombre d’exécutions réussies | Nombre d’exécutions de requêtes réussies |
| Nombre d’exécutions ayant échoué | Nombre d’exécutions de requêtes ayant échoué |
| Nombre d’exécutions annulées | Nombre d’exécutions de requêtes annulées |
Les mêmes informations concernant les requêtes terminées, ayant échoué et annulées à partir des exécutions des requêtes, ainsi que les insights agrégés, sont également disponibles dans Insights des requêtes dans l’entrepôt de données Fabric.
Limites
- Les requêtes historiques peuvent prendre jusqu’à 15 minutes pour apparaître dans l’activité des requêtes en fonction de la charge de travail simultanée en cours d’exécution.
- Seules les 10 000 premières lignes peuvent être affichées dans les onglets Exécutions des requêtes et Insights des requêtes pour les sélections de filtres données.
- Une erreur « Nom d’objet non valide queryinsights.exec_requests_history » peut se produire si l’activité des requêtes est ouverte immédiatement après la création d’un nouvel entrepôt, en raison des vues système sous-jacentes non encore générées. Pour contourner ce problème, attendez deux minutes, puis actualisez la page.