Partager via


Commande .show requêtes

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

La .show queries commande répertorie les requêtes sur le cluster qui ont atteint un état final et que l’utilisateur appelant la commande a accès à la vue. Si vous le souhaitez, la commande peut retourner des requêtes qui sont toujours en cours d’exécution, des requêtes par des utilisateurs spécifiques ou des requêtes regroupées par utilisateur. Pour afficher la saisie semi-automatique des requêtes et des commandes, utilisez .show queries-and-commands.

La .show queries commande répertorie les requêtes sur la maison d’événements qui ont atteint un état final et que l’utilisateur appelant la commande a accès à la vue. Si vous le souhaitez, la commande peut retourner des requêtes qui sont toujours en cours d’exécution, des requêtes par des utilisateurs spécifiques ou des requêtes regroupées par utilisateur. Pour afficher la saisie semi-automatique des requêtes et des commandes, utilisez .show queries-and-commands.

autorisations

Un administrateur de base de données ou un moniteur de base de données peut voir n’importe quelle commande appelée sur la base de données. Les autres utilisateurs ne peuvent voir que leurs requêtes.

Syntaxe

.show queries

.showrunning queries [ by user UserPrincipalName]

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
UserPrincipalName string UPN d’un utilisateur spécifique pour lequel retourner une liste de requêtes.

Retours

  • Retourne une table contenant des requêtes exécutées précédemment sur toutes les bases de données du cluster et leurs statistiques d’achèvement. Vous pouvez utiliser des requêtes KQL pour explorer les résultats.
  • Retourne une liste des requêtes en cours d’exécution par l’utilisateur actuel, par un autre utilisateur ou par tous les utilisateurs.
  • Retourne une table contenant des requêtes exécutées précédemment sur toutes les bases de données du cluster et leurs statistiques d’achèvement. Vous pouvez utiliser des requêtes KQL pour explorer les résultats.
  • Retourne une liste des requêtes en cours d’exécution par l’utilisateur actuel, par un autre utilisateur ou par tous les utilisateurs.

Remarque

Le texte de la requête est tronqué après 64 Ko.

Le schéma de table retourné est le suivant :

ColumnName ColumnType Description
ClientActivityId string ID client de la requête
Détails string Texte de requête, tronqué à 64 Ko
Base de données string Nom de la base de données sur laquelle la requête a été exécutée
StartedOn datetime Horodatage lors du démarrage de l’exécution de la requête
LastUpdatedOn datetime Horodatage de la dernière mise à jour d’état
Durée timespan Durée de requête côté serveur
État string État d’achèvement
RootActivityId guid ID de requête côté serveur
Utilisateur string ID utilisateur qui a exécuté la requête
FailureReason string Raison de l’échec. Si la requête a réussi, ce champ est vide.
TotalCpu timespan Total du processeur consommé par la requête
CacheStatistics dynamic Statistiques d’utilisation du cache de données
Application string Nom de l’application utilisée pour exécuter la requête
MemoryPeak long Statistiques de mémoire maximale
ScannedExtentsStatistics dynamic Statistiques des partitions analysées (étendues)
Principal string AAD-ID de l’utilisateur ou de l’application utilisé pour exécuter la requête
ClientRequestProperties dynamic Propriétés de la demande du client
ResultSetStatistics dynamic Statistiques décrivant le jeu de données retourné
WorkloadGroup string Nom du groupe de charge de travail auquel la requête a été associée

Exemples

Afficher les requêtes terminées

.show queries 
| project Text, Duration
| take 10

Sortie

Détails Durée
StormEvents | trier par DeathsDirect desc 00:00:00.2343761
StormEvents | trier par DeathsDirect desc 00:00:00.2187503
StormEvents | trier par DeathsDirect desc 00:00:00.2343115
StormEvents | trier par DamageProperty desc 00:00:00.2656510
StormEvents | trier par StartTime desc 00:00:00.2343012
StormEvents | trier par StartTime desc 00:00:00.2813042
StormEvents | trier par StartTime desc 00:00:00.3594493
TestFunction(5) 00:00:00.0312024
traceAgg(now(5500d)) 00:00:00.0312952
traceAgg(now(-5500d)) 00:00:00.0312445

Afficher les requêtes en cours d’exécution par l’utilisateur actuel

.show running queries 

Afficher les requêtes en cours d’exécution par un utilisateur spécifié

.show running queries by user <UserPrincipalName>