Comando .show query

  • Articolo

Il .showqueries 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 da utenti specifici o query raggruppate dall'utente. Per visualizzare il completamento di query e comandi, usare .show query-and-commands.

Autorizzazioni

Un database Amministrazione o Monitoraggio database può visualizzare qualsiasi comando richiamato nel database. Altri utenti possono visualizzare solo le query.

Sintassi

.show queries

.showrunningqueries [ by userUserPrincipalName]

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Tipo Obbligatoria Descrizione
UserPrincipalName string UPN di un utente specifico per cui restituire un elenco di query.

Restituisce

  • Restituisce una tabella contenente query eseguite in precedenza in tutti i database nel cluster e le relative statistiche di completamento. È possibile usare le 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 di query
LastUpdatedOn datetime Timestamp dell'ultimo aggiornamento dello stato
Durata timespan Durata della query lato server
State string Stato di completamento
RootActivityId guid ID richiesta lato server
Utente 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 sull'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)
Server principale string ID AAD dell'utente o dell'applicazione usata 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 associato alla query

Esempio

Mostra query completate

Eseguire la query

.show queries 
| project Text, Duration
| take 10

Output

Testo Durata
StormEvents | ordinare in base a DeathsDirect desc 00:00:00.2343761
StormEvents | ordinare in base a DeathsDirect desc 00:00:00.2187503
StormEvents | ordinare in base a DeathsDirect desc 00:00:00.2343115
StormEvents | ordinare per DamageProperty desc 00:00:00.2656510
StormEvents | ordinare per StartTime desc 00:00:00.2343012
StormEvents | ordinare per StartTime desc 00:00:00.2813042
StormEvents | ordinare per 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>

Contenuti correlati