Compartilhar via


Monitorar suas consultas T-SQL em execução e concluídas usando Atividade de consultas

Aplica-se a: ponto de extremidade de análise do 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 Atividade de consultas. Membros, Contribuidores, Visualizadores não têm permissão para acessar esse modo de exibição.

Introdução

Há duas maneiras de iniciar a experiência Atividade de consultas.

  • 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 de 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 consultas na faixa.

Execuções de consultas

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 por status, remetente ou hora 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) Carimbo de 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
Origem da execução 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 de consultas.

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

Insights de consultas

Na página Insights de consulta, você pode ver uma lista de consultas de longa duração e consultas executadas com frequência para ajudar a determinar quaisquer tendências nas consultas do seu depósito.

Para cada consulta no insight 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) nas execuções
Contagem de execuções 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 da consulta (ms) nas 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 bem-sucedidas Número de execuções de consulta bem-sucedidas
Contagem de execuções com falha Número de execuções de consultas com falha
Contagem de execuções canceladas Número de execuções de consultas canceladas

As mesmas informações sobre consultas concluídas, com falha e canceladas de Execuções de consultas junto com insights agregados também podem ser encontradas em Insights de consultas no data warehousing 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 linhas principais podem ser mostradas nas guias Execuções de consultas e Insights de consultas para as seleções de filtro especificadas.
  • Um erro "Nome de objeto inválido queryinsights.exec_requests_history" poderá ocorrer se Atividade de consultas for aberta imediatamente após a criação de um novo depósito devido às exibições do sistema subjacentes ainda não geradas. Como solução alternativa, aguarde dois minutos e atualize a página.