Compartilhar via


Comando .show queries

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

O .show queries 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 de usuários específicos ou consultas agrupadas por usuário. Para ver a conclusão de consultas e comandos, use .show queries-and-commands.

O .show queries comando lista as consultas na eventhouse 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 de usuários específicos ou consultas agrupadas por usuário. Para ver a conclusão de consultas e comandos, use .show queries-and-commands.

Permissões

Um administrador de banco de dados ou monitor de banco de dados pode ver qualquer comando chamado no banco de dados. Outros usuários só podem ver suas consultas.

Sintaxe

.show queries

.showrunning by user queries [Nome do UsuárioPrincipal]

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
UserPrincipalName string O UPN de um usuário específico para o qual retornar uma lista de consultas.

Devoluções

  • Retorna uma tabela contendo 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, por outro usuário ou por todos os usuários.
  • Retorna uma tabela contendo 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, 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 ColumnType Descrição
ClientActivityId string ID do cliente da solicitação
Texto string Texto da consulta, truncado em 64 KB
Backup de banco 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
Duration 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
Usuário string ID do usuário que executou a consulta
FailureReason string Motivo da falha. Se a consulta for 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 pico de memória
ScannedExtentsStatistics dynamic Estatísticas dos fragmentos verificados (extensões)
Principal string ID do AAD 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
Grupo de carga de trabalho string Nome do grupo de carga de trabalho ao qual a consulta estava associada

Exemplos

Mostrar consultas concluídas

.show queries 
| project Text, Duration
| take 10

Saída

Texto Duration
Eventos de Tempestade | ordenar por DeathsDirect desc 00:00:00.2343761
Eventos de Tempestade | ordenar por DeathsDirect desc 00:00:00.2187503
Eventos de Tempestade | ordenar por DeathsDirect desc 00:00:00.2343115
Eventos de Tempestade | ordenar por DamageProperty desc 00:00:00.2656510
Eventos de Tempestade | ordenar por StartTime desc 00:00:00.2343012
Eventos de Tempestade | ordenar por StartTime desc 00:00:00.2813042
Eventos de Tempestade | ordenar por StartTime desc 00:00:00.3594493
Função de teste(5) 00:00:00.0312024
traceAgg(agora(5500d)) 00:00:00.0312952
traceAgg(agora(-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>