Comando .show queries

  • Artículo

El .showqueries comando enumera las consultas en el clúster que han alcanzado un estado final y que el usuario que invoca el comando tiene acceso para ver. Opcionalmente, el comando puede devolver consultas que todavía se están ejecutando, consultas por usuarios específicos o consultas agrupadas por usuario. Para ver las consultas y la finalización de comandos, use .show queries-and-commands.

Permisos

Una base de datos Administración o monitor de base de datos puede ver cualquier comando invocado en la base de datos. Otros usuarios solo pueden ver sus consultas.

Syntax

.show queries

.showrunningqueries [ by userUserPrincipalName]

Más información sobre las convenciones de sintaxis.

Parámetros

Nombre Tipo Requerido Descripción
UserPrincipalName string UPN de un usuario específico para el que se va a devolver una lista de consultas.

Devoluciones

  • Devuelve una tabla que contiene consultas ejecutadas previamente en todas las bases de datos del clúster y sus estadísticas de finalización. Puede usar consultas KQL para explorar los resultados.
  • Devuelve una lista de consultas que ejecuta actualmente el usuario actual, o por otro usuario, o por todos los usuarios.

Nota

El texto de la consulta se trunca después de 64 KB.

El esquema de tabla devuelto es:

ColumnName ColumnType Descripción
ClientActivityId string Id. de cliente de la solicitud
Texto string Texto de consulta, truncado a 64 KB
Base de datos string Nombre de la base de datos en la que se ejecutó la consulta
StartedOn datetime Marca de tiempo cuando se inició la ejecución de consultas
LastUpdatedOn datetime Marca de tiempo de la última actualización de estado
Duration timespan Duración de la consulta del lado servidor
State string Estado de finalización
RootActivityId guid Id. de solicitud del lado servidor
Usuario string Identificador de usuario que ejecutó la consulta
FailureReason string Motivo del error. Si la consulta se realizó correctamente, este campo está vacío.
TotalCpu timespan Cpu total consumida por la consulta
CacheStatistics dynamic Estadísticas de uso de la caché de datos
Application string Nombre de la aplicación que se usó para ejecutar la consulta
MemoryPeak long Estadísticas de memoria máxima
ScannedExtentsStatistics dynamic Estadísticas de las particiones escaneadas (extensiones)
Principal string Identificador de AAD del usuario o aplicación que se usó para ejecutar la consulta
ClientRequestProperties dynamic Propiedades de solicitud de cliente
ResultSetStatistics dynamic Estadísticas que describen el conjunto de datos devuelto
WorkloadGroup string Nombre del grupo de cargas de trabajo al que estaba asociada la consulta

Ejemplos

Mostrar consultas completadas

Ejecución de la consulta

.show queries 
| project Text, Duration
| take 10

Salida

Texto Duration
StormEvents | ordenar por DeathsDirect desc 00:00:00.2343761
StormEvents | ordenar por DeathsDirect desc 00:00:00.2187503
StormEvents | ordenar por DeathsDirect desc 00:00:00.2343115
StormEvents | ordenar por DamageProperty desc 00:00:00.2656510
StormEvents | ordenar por StartTime desc 00:00:00.2343012
StormEvents | ordenar por StartTime desc 00:00:00.2813042
StormEvents | ordenar por 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

Mostrar consultas en ejecución por parte del usuario actual

.show running queries

Mostrar consultas en ejecución por un usuario especificado

.show running queries by user <UserPrincipalName>

Contenido relacionado