Befehl ".show queries"

Der .showqueries Befehl listet Abfragen im Cluster auf, die einen endgültigen Zustand erreicht haben und die der Benutzer, der den Befehl aufruft, zugriff darauf hat. Optional kann der Befehl abfragen, die noch ausgeführt werden, Abfragen von bestimmten Benutzern oder nach Benutzer gruppierte Abfragen zurückgeben. Um die Vervollständigung von Abfragen und Befehlen anzuzeigen, verwenden Sie .show queries-and-commands.

Berechtigungen

Ein Datenbank-Admin oder Datenbankmonitor kann einen beliebigen Befehl sehen, der für die Datenbank aufgerufen wird. Andere Benutzer können nur ihre Abfragen sehen.

Syntax

.show queries

.showrunningqueries [ by userUserPrincipalName]

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich BESCHREIBUNG
UserPrincipalName string Der UPN eines bestimmten Benutzers, für den eine Liste von Abfragen zurückgegeben werden soll.

Gibt zurück

  • Gibt eine Tabelle zurück, die zuvor ausgeführte Abfragen für alle Datenbanken im Cluster und deren Abschlussstatistiken enthält. Sie können KQL-Abfragen verwenden, um die Ergebnisse zu untersuchen.
  • Gibt eine Liste der derzeit ausgeführten Abfragen des aktuellen Benutzers, eines anderen Benutzers oder aller Benutzer zurück.

Hinweis

Der Text der Abfrage wird nach 64 KB abgeschnitten.

Das zurückgegebene Tabellenschema lautet:

ColumnName ColumnType BESCHREIBUNG
ClientActivityId string Client-ID der Anforderung
Text string Abfragetext, abgeschnitten bei 64 KB
Datenbank string Name der Datenbank, für die die Abfrage ausgeführt wurde
StartedOn datetime Zeitstempel beim Starten der Abfrageausführung
LastUpdatedOn datetime Zeitstempel des letzten status Updates
Duration timespan Serverseitige Abfragedauer
State string Abschlusszustand
RootActivityId guid Serverseitige Anforderungs-ID
Benutzer string Benutzer-ID, die die Abfrage ausgeführt hat
FailureReason string Fehlerursache. Wenn die Abfrage erfolgreich war, ist dieses Feld leer.
TotalCpu timespan Cpu-Auslastung der Abfrage insgesamt
CacheStatistics dynamic Datencachenutzungsstatistiken
Anwendung string Name der Anwendung, die zum Ausführen der Abfrage verwendet wurde
MemoryPeak long Spitzenspeicherstatistiken
ScannedExtentsStatistics dynamic Statistiken der gescannten Shards (Blöcke)
Prinzipal string AAD-ID des Benutzers oder der Anwendung, die zum Ausführen der Abfrage verwendet wurde
ClientRequestProperties dynamic Clientanforderungseigenschaften
ResultSetStatistics dynamic Statistiken zur Beschreibung des zurückgegebenen Datasets
WorkloadGroup string Name der Arbeitsauslastungsgruppe, der die Abfrage zugeordnet war

Beispiele

Abgeschlossene Abfragen anzeigen

.show queries 
| project Text, Duration
| take 10

Ausgabe

Text Duration
StormEvents | sortieren nach DeathsDirect desc 00:00:00.2343761
StormEvents | sortieren nach DeathsDirect desc 00:00:00.2187503
StormEvents | sortieren nach DeathsDirect desc 00:00:00.2343115
StormEvents | sortieren nach DamageProperty desc 00:00:00.2656510
StormEvents | sortieren nach StartTime desc 00:00:00.2343012
StormEvents | sortieren nach StartTime desc 00:00:00.2813042
StormEvents | sortieren nach 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

Anzeigen ausgeführter Abfragen durch den aktuellen Benutzer

.show running queries 

Anzeigen ausgeführter Abfragen durch einen angegebenen Benutzer

.show running queries by user <UserPrincipalName>