Monitorizar consultas T-SQL (Pré-visualização)

Aplica-se a:✅ endpoint de análise SQL e armazém de dados no Microsoft Fabric

Importante

Este recurso está em pré-visualização.

Use o Data Warehouse Monitor para visualizar consultas T-SQL em execução e históricas, consultas de longa duração e, frequentemente, para executar consultas sem executar código T-SQL. Integrado no portal Fabric, pode usar o Data Warehouse Monitor para confirmar que as consultas são concluídas com sucesso, analisar padrões de execução e investigar em detalhe as sequências de consultas mais lentas.

O Data Warehouse Monitor era anteriormente chamado "Query Activity".

Pré-requisitos

  • Tem de ser administrador no seu espaço de trabalho para aceder ao Data Warehouse Monitor. Membros, Colaboradores e Espectadores não têm permissão para aceder a esta visualização.

Introdução

Pode lançar a experiência Data Warehouse Monitor de duas formas.

  • Selecione Mais Opções (...) ao lado do armazém que quer monitorizar na vista do espaço de trabalho e selecione Monitorizar.

    Captura de ecrã do ponto de entrada do Monitor no menu contextual do espaço de trabalho.

  • No editor de consultas do armazém que pretende monitorizar, selecione Monitor na fita.

    Captura de ecrã da entrada Monitor na barra de ferramentas.

Histórico de consultas

Na página de histórico de consultas , pode rever execuções recentes de consultas e identificar padrões na atividade do armazém. Esta vista combina um gráfico de contagem de pedidos com uma grelha de resultados detalhada para que 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 pedidos para identificar picos de atividade durante o intervalo de tempo selecionado.
  • Use o menu Filtro para refinar a visualização por Hora de Submissão (UTC), Estado, Submetido por, Fonte de execução, Tipo de Instrução e Rótulo.
  • Use a barra de pesquisa para encontrar palavras-chave específicas no texto da consulta ou noutras colunas.
  • Use o filtro de tempo para alternar rapidamente entre as últimas 24 horas, últimos 7 dias, últimos 30 dias ou um intervalo de tempo personalizado.
  • Revise os filtros ativos como comprimidos removíveis acima da área do gráfico. Quando aplica ou remove filtros, o Monitor atualiza o gráfico e a grelha de consulta para corresponder ao conjunto atual de filtros.
  • Selecione Atualizar para recarregar os resultados atuais. Se vires uma consulta que queres parar, seleciona a consulta usando a caixa de seleção e depois seleciona Cancelar. É solicitado confirmar antes de a consulta ser cancelada. Quaisquer consultas não selecionadas que façam parte das mesmas sessões SQL que selecionaste também são canceladas.

Note

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

Captura de ecrã do diálogo de cancelamento do histórico de consultas.

  • Quando seleciona uma ou mais execuções de consulta que partilham o mesmo hash de consulta, Ver execuções semelhantes fica disponível. Use esta opção para comparar execuções do mesmo padrão de consulta e perceber se a duração, falhas ou utilização de recursos mudaram entre execuções.

Captura de ecrã do histórico de consultas Ver execuções semelhantes.

O gráfico atualiza-se para refletir a seleção atual de filtros, facilitando a resposta a perguntas como:

  • Quando é que o volume de consultas aumentou?
  • Qual é o remetente ou fonte de execução associada a um pico de atividade?
  • As consultas falhadas ou canceladas concentram-se numa janela temporal específica?

Também pode personalizar a disposição da tabela a partir do menu das colunas:

  • Escolha quais as colunas que aparecem na grelha de dados.
  • Arrasta os itens no menu da coluna para os reordenar.
  • Selecione Aplicar para atualizar a grelha para corresponder à ordem das colunas selecionadas.

Para cada consulta, os seguintes detalhes estão disponíveis na grelha de histórico de consultas . Algumas colunas podem estar ocultas por defeito e podem ser adicionadas nas opções de colunas.

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 forma de consulta que ajuda a identificar lógica de consulta semelhante entre execuções
Status Estado da consulta: Bem-sucedido, Falhado ou Cancelado
Submetido por Nome do usuário ou sistema que enviou a consulta
Tempo de envio (UTC) Data e hora de chegada do pedido
Duration Tempo total que a consulta demorou a concluir
Executar código-fonte Nome do programa cliente que iniciou a sessão
Tempo de CPU Tempo total de CPU alocado para a execução da consulta
Dados digitalizados remotamente Quantidade de dados lidos a partir do armazenamento remoto no OneLake
Dados digitalizados em disco Quantidade de dados lidos do disco local
Dados digitalizados na cache Quantidade de dados lidos da cache de memória local
ID da sessão ID que vincula a consulta a uma sessão de usuário específica
Etiqueta Etiqueta opcional associada à consulta, quando uma etiqueta foi fornecida
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 devolvidas pela consulta
ID de lote ID para um conjunto agrupado de consultas, se aplicável
ID de Ligação Identificador da ligação usada pela consulta
Nome da base de dados Nome do armazém ou endpoint de análise SQL ligado no momento da execução
Hora de fim Carimbo temporal em que 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
Resultado da perda da cache Estado da cache do conjunto de resultados para a consulta: 2 significa acerto na cache, 1 significa cache criada, e 0 significa que a cache do conjunto de resultados não foi aplicada.
ID de lote raiz ID para o batch de topo quando as consultas fazem parte de um batch aninhado
Nome do pool SQL Nome do pool SQL usado para executar o pedido
Código de Erro Código de erro devolvido para a execução da consulta quando é reportada uma falha

A mesma informação relativa a consultas em execução também pode ser encontrada usando vistas de gestão dinâmica e vistas de insights de consultas, por exemplo, queryinsights.exec_requests_history.

Informações de consulta

Os outros separadores do Monitor ajudam a passar do histórico para uma análise resumida:

  • Consultas de longa duração ajudam-no a identificar consultas com tempos de execução consistentemente mais altos.
  • Consultas frequentemente executadas ajudam-no a encontrar padrões de consulta repetidos que podem beneficiar de um ajuste.

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

Nome da coluna Description
Texto da consulta Texto da consulta executada
Duração mediana da execução Tempo médio de execução da consulta (ms) em todas as execuções
Contagem de execuções Número total de vezes que a consulta foi executada
Duração da última execução Tempo gasto 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 de sessão para a última execução

Para cada consulta no Insight de consultas executadas com freqüê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 de consultas (ms) ao longo das execuções
Duração máxima Maior tempo de execução de consulta (ms)
Duração mínima 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 execuções Número total de vezes que a consulta foi executada
Número de execuções bem-sucedidas Número de execuções de consulta bem-sucedidas
Contagem de execuções com falha Número de consultas executadas com falha
Contagem de corridas canceladas Número de execuções de consulta canceladas

Para tirar o máximo proveito destas opiniões:

  • Comece no histórico de Consultas para identificar o intervalo de tempo, o autor da submissão ou a origem da execução que deseja investigar.
  • Use Visualizar execuções semelhantes para comparar execuções que partilham o mesmo hash de consulta.
  • Migre para consultas de longa duração para identificar padrões de consulta com duração mediana elevada.
  • Revise Consultas frequentemente executadas para encontrar padrões de consulta de alto volume que sejam boas candidatas para otimização.

A mesma informação sobre consultas concluídas, falhadas e canceladas do histórico de consultas, juntamente com insights agregados, pode também ser encontrada em Query insights no Fabric data warehousing.

Limitações

  • Dependendo da carga de trabalho simultânea, consultas históricas podem demorar até 15 minutos a aparecer no Monitor.
  • O monitor mostra apenas as 10.000 primeiras linhas das seleções atuais de filtros. Para reduzir o conjunto de resultados, estreite o intervalo de tempo ou adicione filtros.
  • Se abrir o Monitor imediatamente após criar um novo armazém, pode deparar-se com um erro Invalid object name queryinsights.exec_requests_history. Este erro ocorre porque as vistas do sistema subjacente ainda não foram geradas. Como solução alternativa, espera dois minutos e depois atualiza a página.