Comando .show queries

  • Artigo

O .showqueries comando lista as consultas no cluster que atingiram um estado final e que o utilizador que invoca o comando tem acesso para ver. Opcionalmente, o comando pode devolver consultas que ainda estão em execução, consultas por utilizadores específicos ou consultas agrupadas pelo utilizador. Para ver a conclusão de consultas e comandos, utilize .show queries-and-commands.

Permissões

Uma Base de Dados Administração ou Um Monitor de Base de Dados pode ver qualquer comando invocado na base de dados. Os outros utilizadores só podem ver as respetivas consultas.

Syntax

.show queries

.showrunningqueries [ by userUserPrincipalName]

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
UserPrincipalName string O UPN de um utilizador específico para o qual pode devolver uma lista de consultas.

Devoluções

  • Devolve uma tabela que contém consultas executadas anteriormente em todas as bases de dados no cluster e as respetivas estatísticas de conclusão. Pode utilizar consultas KQL para explorar os resultados.
  • Devolve uma lista de consultas atualmente executadas pelo utilizador atual, por outro utilizador ou por todos os utilizadores.

Nota

O texto da consulta é truncado após 64 KB.

O esquema de tabela devolvido é:

ColumnName ColumnType Description
ClientActivityId string ID de cliente do pedido
Texto string Texto da consulta, truncado a 64 KB
Base de Dados string Nome da base de dados na qual a consulta foi executada
StartedOn datetime Carimbo de data/hora quando a execução da consulta foi iniciada
LastUpdatedOn datetime Carimbo de data/hora da última atualização de estado
Duração timespan Duração da consulta do lado do servidor
Estado string Estado de conclusão
RootActivityId guid ID do pedido do lado do servidor
Utilizador string ID de utilizador que executou a consulta
FailureReason string Motivo da falha. Se a consulta tiver sido efetuada com êxito, este campo estará vazio.
TotalCpu timespan CPU total consumida pela consulta
CacheStatistics dynamic Estatísticas de utilização da cache de dados
Aplicação string Nome da aplicação que foi utilizada para executar a consulta
MemoryPeak long Estatísticas de memória de pico
ScannedExtentsStatistics dynamic Estatísticas das partições horizontais digitalizadas (extensões)
Principal string AAD-ID do utilizador ou aplicação que foi utilizado para executar a consulta
ClientRequestProperties dynamic Propriedades do pedido de cliente
ResultSetStatistics dynamic Estatísticas que descrevem o conjunto de dados devolvido
Grupo de Cargas de Trabalho string Nome do grupo de cargas de trabalho ao qual a consulta foi associada

Exemplos

Mostrar consultas concluídas

Executar a consulta

.show queries 
| project Text, Duration
| take 10

Saída

Texto Duração
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 em execução pelo utilizador atual

.show running queries

Mostrar consultas em execução por um utilizador especificado

.show running queries by user <UserPrincipalName>

Conteúdo relacionado