Condividi tramite


Comando .show queries

Il .show queries comando elenca le query nel cluster che hanno raggiunto uno stato finale e che l'utente che richiama il comando ha accesso a vedere. Facoltativamente, il comando può restituire query ancora in esecuzione, query per utenti specifici o query raggruppate per utente. Per visualizzare sia le query che il completamento dei comandi, usare .show queries-and-commands.

Autorizzazioni

Un amministratore del database o Monitoraggio database può visualizzare qualsiasi comando richiamato nel database. Gli altri utenti possono visualizzare solo le query.

Sintassi

.show queries

.showrunning queries [ by user UserPrincipalName]

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
UserPrincipalName string UPN di un utente specifico per il quale restituire un elenco di query.

Valori restituiti

  • Restituisce una tabella contenente query eseguite in precedenza in tutti i database del cluster e le relative statistiche di completamento. È possibile usare query KQL per esplorare i risultati.
  • Restituisce un elenco di query attualmente in esecuzione dall'utente corrente o da un altro utente o da tutti gli utenti.

Nota

Il testo della query viene troncato dopo 64 KB.

Lo schema di tabella restituito è:

ColumnName ColumnType Descrizione
ClientActivityId string ID client della richiesta
Testo string Testo della query, troncato a 64 KB
Database string Nome del database in cui è stata eseguita la query
StartedOn datetime Timestamp all'avvio dell'esecuzione della query
LastUpdatedOn datetime Timestamp dell'ultimo aggiornamento dello stato
Durata timespan Durata query sul lato server
Provincia string Stato di completamento
RootActivityId guid ID richiesta lato server
User string ID utente che ha eseguito la query
FailureReason string Motivo dell'errore. Se la query ha esito positivo, questo campo è vuoto.
TotalCpu timespan CPU totale utilizzata dalla query
CacheStatistics dynamic Statistiche di utilizzo della cache dei dati
Applicazione string Nome dell'applicazione usata per eseguire la query
MemoryPeak long Statistiche di memoria di picco
ScannedExtentsStatistics dynamic Statistiche delle partizioni analizzate (extent)
Entità di sicurezza string ID AAD dell'utente o dell'applicazione usato per eseguire la query
ClientRequestProperties dynamic Proprietà della richiesta client
ResultSetStatistics dynamic Statistiche che descrivono il set di dati restituito
WorkloadGroup string Nome del gruppo di carico di lavoro a cui è stata associata la query

Esempi

Mostra query completate

.show queries 
| project Text, Duration
| take 10

Output

Testo Durata
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 by 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

Visualizzare le query in esecuzione dall'utente corrente

.show running queries 

Visualizzare le query in esecuzione da un utente specificato

.show running queries by user <UserPrincipalName>