Compartilhar via


Monitore suas consultas T-SQL em andamento e concluídas usando a Atividade de Consultas

Aplica-se a:✅ ponto de extremidade de análise SQL e Warehouse no Microsoft Fabric

O monitoramento de consultas SQL é essencial para monitorar e solucionar problemas de desempenho do seu armazém do Fabric e também para manter a eficiência do depósito. Com a Atividade de consultas, você tem uma visão completa de todas as consultas T-SQL em execução e históricas, juntamente com uma lista de consultas de longa duração e executadas com frequência sem precisar executar nenhum código T-SQL. Você pode usar Atividade de consultas para garantir que as consultas não demorem mais do que o esperado para serem executadas e sejam concluídas com êxito.

Pré-requisitos

  • Você deve ser um administrador em seu espaço de trabalho para acessar a atividade de consulta. Membros, Contribuidores, Visualizadores não têm permissão para acessar esse modo de exibição.

Comece

Há duas maneiras de iniciar a experiência da atividade de consulta.

  • Selecione Mais opções (...) ao lado do depósito que você deseja monitorar no modo de exibição do espaço de trabalho e selecione Atividade de consultas.

    Captura de tela do ponto de entrada da atividade de consulta no menu de contexto do espaço de trabalho.

  • No editor de consultas do depósito que você deseja monitorar, selecione Atividade de consultas na faixa.

    Captura de tela do ponto de entrada de atividade de consulta da faixa de opções.

Execuções de consulta

Na página Execuções de consulta, você pode ver uma lista de consultas em execução, bem-sucedidas, canceladas e com falha até os últimos 30 dias.

  • Use a lista suspensa para filtrar o status, o enviador ou o tempo de envio.
  • Use a barra de pesquisa para filtrar por palavras-chave específicas no texto da consulta ou em outras colunas.

Para cada consulta, os seguintes detalhes são fornecidos:

Nome da coluna Descrição
ID da instrução distribuída ID exclusivo para cada consulta
Texto da consulta Texto da consulta executada (até 8.000 caracteres)
Hora de envio (UTC) Data e hora em que a solicitação chegou.
Duração Tempo total necessário para a execução da consulta
Status Status da consulta (Em execução, Bem-sucedida, Falha ou Cancelada)
Emissor Nome do usuário ou sistema que enviou a consulta
ID da sessão ID que vincula a consulta a uma sessão de usuário específica
Executar fonte Nome do programa cliente que iniciou a sessão

Quando quiser recarregar as consultas exibidas na página, selecione o botão Atualizar na faixa. Se você vir uma consulta cuja execução deseja interromper imediatamente, marque a consulta usando a caixa de seleção e selecione o botão Cancelar. Você deverá confirmar em uma caixa de diálogo antes que a consulta seja cancelada. Todas as consultas não selecionadas que fazem parte das mesmas sessões SQL selecionadas também serão canceladas.

Captura de tela da caixa de diálogo Cancelar execuções da Consulta.

As mesmas informações sobre a execução de consultas também podem ser encontradas usando exibições de gerenciamento dinâmico.

Insights de consulta

Na página Insights de consulta, é possível visualizar uma lista de consultas de execução prolongada e executar consultas com frequência para ajudar a determinar as tendências nas consultas do seu warehouse.

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

Nome da coluna Descrição
Texto da consulta Texto da consulta executada (até 8.000 caracteres)
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 Descrição
Texto da consulta Texto da consulta executada (até 8.000 caracteres)
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 execuções 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

As mesmas informações sobre consultas concluídas, com falha e canceladas de execuções de Consulta, juntamente com insights agregados, também podem ser encontradas emInsights de consulta no armazenamento de dados do Fabric .

Limitações

  • As consultas históricas podem levar até 15 minutos para aparecer em Atividade de consultas, dependendo da carga de trabalho simultânea que está sendo executada.
  • Somente as 10.000 principais linhas podem ser exibidas nas guias Execuções de consulta e Insights de consulta para as seleções de filtro fornecidas.
  • Um erro "Nome de objeto inválido queryinsights.exec_requests_history" poderá ocorrer se a atividade de consulta for aberta imediatamente após a criação de um novo warehouse, devido às exibições subjacentes do sistema ainda não geradas. Como solução alternativa, aguarde dois minutos e atualize a página.