Monitorar consultas T-SQL (versão prévia)

Aplica-se a:✅ Endpoint de análise de SQL e Armazém de Dados no Microsoft Fabric

Importante

Esse recurso está na versão prévia.

Use Data Warehouse Monitor para exibir consultas T-SQL em execução e históricas, consultas de execução longa e consultas de execução frequente sem executar código T-SQL. Integrado ao portal Fabric, você pode usar Data Warehouse Monitor para confirmar se as consultas foram concluídas com êxito, analisar padrões de execução e investigar execuções de consulta mais lentas em detalhes.

Data Warehouse Monitor era anteriormente chamado de "Atividade de Consulta".

Pré-requisitos

  • Você deve ser um administrador em seu workspace para acessar Data Warehouse Monitor. Membros, Colaboradores e Visualizadores não têm permissão para acessar essa exibição.

Introdução

Você pode iniciar a experiência Data Warehouse Monitor de duas maneiras.

  • Selecione Mais Opções (...) ao lado do warehouse que você deseja monitorar no modo de exibição do workspace e selecione Monitor.

    Captura de tela do ponto de entrada Monitor no menu de contexto do espaço de trabalho.

  • No editor de consultas do armazém que você deseja monitorar, selecione Monitor na faixa de opções.

    Captura de tela do ponto de entrada Monitor da barra de ferramentas.

Histórico de consultas

Na página Histórico de Consultas, você pode examinar as execuções de consulta recentes e identificar padrões na atividade do armazém de dados. Essa exibição combina um gráfico de contagem de solicitações com uma grade de resultados detalhada para que você possa passar de uma tendência de alto nível para uma execução de consulta específica.

  • Use o gráfico de contagem de solicitações para detectar picos na atividade durante o intervalo de tempo selecionado.
  • Use o menu Filtro para refinar o modo de exibição por Hora de Envio (UTC), Status, Enviado por, Fonte de execução, Tipo de Instrução e Rótulo.
  • Use a barra de pesquisa para localizar palavras-chave específicas no texto da consulta ou em outras colunas.
  • Use o filtro de tempo para alternar rapidamente entre as últimas 24 horas, os últimos 7 dias, os últimos 30 dias ou um intervalo de tempo personalizado.
  • Examine os filtros ativos como pílulas removíveis acima da área do gráfico. Quando você aplica ou remove filtros, o Monitor atualiza o gráfico e a grade de consulta para corresponder ao conjunto de filtros atual.
  • Selecione Atualizar para recarregar os resultados atuais. Se você vir uma consulta que deseja parar, selecione a consulta usando a caixa de seleção e selecione Cancelar. Você será solicitado a confirmar antes que a consulta seja cancelada. Todas as consultas não selecionadas que fazem parte das mesmas sessões SQL selecionadas também são canceladas.

Note

Atualmente, os filtros aplicados na experiência de monitoramento podem não ser sincronizados entre o gráfico e a grade de dados. Para exibir resultados consistentes, use a opção de atualização para recarregar os dados.

Captura de tela da caixa de diálogo Cancelar histórico de consultas.

  • Quando você seleciona uma ou mais execuções de consulta que compartilham o mesmo hash de consulta, Visualizar execuções semelhantes fica disponível. Use essa opção para comparar execuções do mesmo padrão de consulta e entender se a duração, as falhas ou o uso de recursos foram alterados entre execuções.

Captura de tela da exibição do histórico de consultas de execuções similares.

O gráfico é atualizado para refletir a seleção de filtro atual, facilitando a resposta a perguntas como:

  • Quando o volume de consulta aumentou?
  • Qual fonte de envio ou execução está associada a um pico na atividade?
  • As consultas com falha ou canceladas estão concentradas em uma janela de tempo específica?

Você também pode personalizar o layout da tabela no menu de coluna:

  • Escolha quais colunas aparecem na grade de dados.
  • Arraste itens no menu de coluna para reordená-los.
  • Selecione Aplicar para atualizar a grade para corresponder à ordem de coluna selecionada.

Para cada consulta, os detalhes a seguir estão disponíveis na grade de histórico de consultas . Algumas colunas podem estar ocultas por padrão e podem ser adicionadas a partir de opções de coluna.

Nome da coluna Description
ID da instrução distribuída ID exclusivo para cada consulta
Texto da consulta Texto da consulta executada
Hash de consulta Valor de hash para a estrutura de consulta que ajuda a identificar lógica de consulta semelhante entre processamentos
Status Status da consulta: bem-sucedido, com falha ou cancelado
Envio feito por Nome do usuário ou sistema que enviou a consulta
Hora de envio (UTC) Data e hora em que a solicitação chegou.
Duração Tempo total que a consulta levou para ser concluída
Executar fonte Nome do programa cliente que iniciou a sessão
Hora da CPU Tempo total de CPU alocado para a execução da consulta
Dados verificados remotamente Quantidade de dados lidos do armazenamento remoto no OneLake
Dados escaneados em disco Quantidade de dados lidos do disco local
Dados verificados em cache Quantidade de dados lidos do cache de memória local
ID da sessão ID que vincula a consulta a uma sessão de usuário específica
Rótulo Rótulo opcional associado à consulta, quando um rótulo foi fornecido
Tipo de declaração Tipo de instrução SQL que foi executada, como SELECT, INSERT, UPDATE ou DELETE
Contagem de linhas Número de linhas retornadas pela consulta
ID do Lote ID de um conjunto agrupado de consultas, se aplicável
ID da conexão Identificador para a conexão usada pela consulta
Nome do banco de dados Nome do warehouse ou ponto de extremidade de análise de SQL conectado no momento da execução
Hora de término Carimbo de data/hora quando a consulta concluiu a execução
É distribuído Indica se a consulta foi executada como uma operação distribuída: 1 para sim, 0 para não
Acesso ao cache de resultados Estado do cache do conjunto de resultados para a consulta: 2 significa acesso ao cache, 1 significa cache criado, e 0 significa que o cache do conjunto de resultados não se aplicou.
ID do lote raiz ID do lote de nível superior quando as consultas fazem parte de um lote aninhado
Nome do pool de SQL Nome do pool de SQL usado para executar a solicitação
Código de erro Código de erro retornado para a execução da consulta quando uma falha é relatada

As mesmas informações sobre a execução de consultas também podem ser encontradas usando visões de gerenciamento dinâmico e visões de insights de consulta, por exemplo, queryinsights.exec_requests_history.

Insights de consulta

As outras guias do Monitor ajudam você a migrar do histórico para a análise resumida:

  • Consultas de longa execução ajudam você a identificar consultas com tempos de execução consistentemente mais altos.
  • As consultas de execução frequente ajudam você a encontrar padrões de consulta repetidos que podem se beneficiar do ajuste.

Para cada consulta no insight de consultas de execução prolongada, os seguintes detalhes são fornecidos:

Nome da coluna Description
Texto da consulta Texto da consulta executada
Duração mediana da execução Mediana de tempo de execução da consulta (ms) em todas as execuções
Contagem de corridas Número de vezes que a consulta foi executada
Duração da última execução Tempo exigido pela última execução (ms)
ID da instrução distribuída da última execução ID exclusivo para a última execução da consulta
ID da sessão da última execução ID da sessão para a última execução

Para cada consulta no insight Consultas executadas com frequência, os seguintes detalhes são fornecidos:

Nome da coluna Description
Texto da consulta Texto da consulta executada
Duração média da execução Tempo médio de execução das consultas (ms) ao longo das execuções
Duração máxima O maior tempo de execução da consulta (ms)
Duração mínima O menor tempo de execução da consulta (ms)
ID da instrução distribuída da última execução ID exclusivo para a última execução da consulta
Contagem de corridas Número de vezes que a consulta foi executada
Contagem de execuções com êxito Número de execuções de consulta bem-sucedidas
Contagem de execuções com falha Número de consultas executadas com falha
Contagem de execuções canceladas Número de execuções de consulta canceladas

Para obter o maior valor destas visualizações:

  • Comece no histórico de consultas para identificar o intervalo de tempo, o enviador ou a origem de execução que você deseja investigar.
  • Utilize a opção Exibir execuções semelhantes para comparar execuções que compartilham o mesmo hash de consulta.
  • Mova para consultas de longa execução para identificar padrões de consulta com alta duração mediana.
  • Reveja consultas executadas com frequência para encontrar estruturas de consulta de alto volume que são boas candidatas para otimização.

As mesmas informações sobre consultas concluídas, falhas e canceladas do histórico de consultas, juntamente com insights agregados, também podem ser encontradas em insights de consultas no Fabric data warehousing.

Limitações

  • Dependendo da carga de trabalho simultânea, as consultas históricas podem levar até 15 minutos para serem exibidas no Monitor.
  • O Monitor mostra apenas as 10.000 principais linhas para as seleções de filtro atuais. Para reduzir o conjunto de resultados, reduza o intervalo de tempo ou adicione filtros.
  • Se você abrir o Monitor imediatamente após a criação de um novo armazém, poderá ver um Invalid object name queryinsights.exec_requests_history erro. Esse erro ocorre porque as exibições subjacentes do sistema ainda não foram geradas. Como solução alternativa, aguarde dois minutos e atualize a página.