Commande .show requêtes

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.

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.

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
State	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

Exécuter la requête

.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>

Contenu connexe

• Requête .cancel