Commande .show queries

La .showqueries 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 à voir. Si vous le souhaitez, la commande peut retourner des requêtes qui sont toujours en cours d’exécution, des requêtes effectuées par des utilisateurs spécifiques ou des requêtes regroupées par utilisateur. Pour voir l’exécution des requêtes et des commandes, utilisez .show queries-and-commands.

Autorisations

Un Administration 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 peuvent uniquement voir leurs requêtes.

Syntax

.show queries

.showrunningqueries [ by userUserPrincipalName]

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	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 précédemment exécutées 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 la liste des requêtes en cours d’exécution par l’utilisateur actuel, par un autre utilisateur ou par tous les utilisateurs.

Notes

Le texte de la requête est tronqué au bout de 64 Ko.

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

ColumnName	ColumnType	Description
ClientActivityId	string	ID client de la demande
Texte	string	Texte de la 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 au démarrage de l’exécution de la requête
LastUpdatedOn	datetime	Horodatage de la dernière mise à jour status
Duration	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 d’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 cpu 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 de pointe
ScannedExtentsStatistics	dynamic	Statistiques des partitions analysées (étendues)
Principal	string	AAD-ID de l’utilisateur ou de l’application qui a été utilisé pour exécuter la requête
ClientRequestProperties	dynamic	Propriétés de la requête cliente
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

Texte	Duration
StormEvents | sort by DeathsDirect desc	00:00:00.2343761
StormEvents | sort by DeathsDirect desc	00:00:00.2187503
StormEvents | sort by DeathsDirect desc	00:00:00.2343115
StormEvents | sort par DamageProperty desc	00:00:00.2656510
StormEvents | sort by StartTime desc	00:00:00.2343012
StormEvents | sort by StartTime desc	00:00:00.2813042
StormEvents | sort by 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