Comando .show de consultas

Alterne os serviços usando a lista suspensa Versão. Saiba mais sobre navegação.
Aplica-se a: ✅ Microsoft Fabric ✅ Azure Data Explorer

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

O .showqueries comando lista as consultas na casa de eventos que atingiram um estado final e que o usuário que invoca o comando tem acesso para ver. Opcionalmente, o comando pode retornar consultas que ainda estão em execução, consultas por usuários específicos ou consultas agrupadas pelo usuário. Para ver a conclusão de consultas e comandos, use .show queries-and-commands.

Permissions

Um Administrador de Banco de Dados ou Monitor de Banco de Dados pode ver qualquer comando invocado no banco de dados. Outros usuários só podem ver suas consultas.

Sintaxe

.show queries

.show running queries [ by userUserPrincipalName]

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Description
UserPrincipalName string O UPN de um usuário específico para o qual retornar uma lista de consultas.

Devoluções

  • Retorna uma tabela que contém consultas executadas anteriormente em todos os bancos de dados no cluster e suas estatísticas de conclusão. Você pode usar consultas KQL para explorar os resultados.
  • Retorna uma lista de consultas em execução no momento pelo usuário atual ou por outro usuário ou por todos os usuários.
  • Retorna uma tabela que contém consultas executadas anteriormente em todos os bancos de dados no cluster e suas estatísticas de conclusão. Você pode usar consultas KQL para explorar os resultados.
  • Retorna uma lista de consultas em execução no momento pelo usuário atual ou por outro usuário ou por todos os usuários.

Observação

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

O esquema de tabela retornado é:

ColumnName TipoDeColuna Description
ClientActivityId string ID do cliente da solicitação
Texto string Texto de consulta truncado a 64 KB
Base de dados string Nome do banco de dados no 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 status
Duração timespan Duração da consulta do lado do servidor
Estado string Estado de conclusão
RootActivityId guid ID da solicitação do lado do servidor
Utilizador string ID do usuário que executou a consulta
Razão da falha string Motivo da falha. Se a consulta tiver sido bem-sucedida, esse campo estará vazio.
TotalCpu timespan Total de CPU consumida pela consulta
CacheStatistics dynamic Estatísticas de uso do cache de dados
Aplicativo string Nome do aplicativo que foi usado para executar a consulta
MemoryPeak long Estatísticas de memória de pico
ScannedExtentsStatistics dynamic Estatísticas dos fragmentos verificados (extensões)
Entidade de segurança string AAD-ID do usuário ou aplicativo que foi usado para executar a consulta
ClientRequestProperties dynamic Propriedades da solicitação do cliente
ResultSetStatistics dynamic Estatísticas que descrevem o conjunto de dados retornado
WorkloadGroup string Nome do grupo de carga de trabalho ao qual a consulta foi associada

Exemplos

Mostrar consultas concluídas

.show queries 
| project Text, Duration
| take 10

Saída

Texto Duração
StormEvents | classificar por DeathsDirect desc 00:00:00.2343761
StormEvents | classificar por DeathsDirect desc 00:00:00.2187503
StormEvents | classificar por DeathsDirect desc 00:00:00.2343115
StormEvents | classificar por DamageProperty desc 00:00:00.2656510
StormEvents | classificar por StartTime desc 00:00:00.2343012
StormEvents | classificar por StartTime desc 00:00:00.2813042
StormEvents | classificar 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 usuário atual

.show running queries 

Mostrar consultas em execução por um usuário especificado

.show running queries by user <UserPrincipalName>