Perfil de consulta

Você pode usar um perfil de consulta para visualizar os detalhes de uma execução de consulta. O perfil de consulta ajuda a solucionar problemas de gargalos de desempenho durante a execução da consulta. Por exemplo:

• Você pode visualizar cada operador de consulta e as métricas relacionadas, como o tempo gasto, o número de linhas processadas, as linhas processadas e o consumo de memória.
• Você pode identificar a parte mais lenta de uma execução de consulta rapidamente e avaliar os impactos das modificações na consulta.
• Você pode descobrir e corrigir erros comuns em instruções SQL, como junções de reações ou verificações completas de tabela.

Requisitos

Para exibir um perfil de consulta, você deve ser o proprietário da consulta ou deve ter pelo menos a permissão CAN MONITOR no SQL warehouse que executou a consulta.

Exibir um perfil de consulta

Você pode exibir o perfil de consulta no histórico de consultas usando as seguintes etapas:

1. Clique no Histórico de consultas na barra lateral.

2. Clique no nome de uma consulta. Um painel de detalhes da consulta aparece no lado direito da tela.

   

   O resumo da consulta inclui:

   • Status da consulta: A consulta é marcada com seu status atual: Enfileirada, Em execução, concluída, com falha ou cancelada.
   • Detalhes do usuário e da computação: Consulte o nome de usuário, o tipo de computação e os detalhes do runtime para esta execução de consulta.
   • ID: Esse é o UUID (identificador universal exclusivo) associado à execução de consulta fornecida.
   • Instrução de consulta: Esta seção inclui a instrução de consulta completa. Se a consulta for muito longa para ser mostrada na visualização, clique em ... mais linhas para exibir o texto completo.
   • Métricas de consulta: As métricas populares para análise de consulta são mostradas no texto da consulta. Os ícones de filtro que aparecem com algumas métricas indicam a porcentagem de dados podados durante o escaneamento.
   • Consulte o perfil de consulta: Uma prévia do grafo acíclico direcionado (DAG) do perfil de consulta é mostrada neste resumo. Isso pode ser útil para estimar rapidamente a complexidade da consulta e o fluxo de execução. Clique em Ver o perfil de consulta para abrir o DAG detalhado.
   • Consulte os operadores mais longos para esta consulta: Clique neste botão para abrir o painel Operadores Superiores . Esse painel mostra os operadores que estão em execução há mais tempo na consulta.
   • Duração do tempo de relógio da consulta: o tempo total decorrido entre o início do agendamento e o final da execução da consulta é fornecido como um resumo. Um detalhamento do agendamento, otimização de consulta, remoção de dados desnecessários de arquivo e tempo de execução aparece abaixo do resumo.
   • Fonte de consulta: Clique no nome do objeto listado para ir para a origem da consulta.
   • Hora da tarefa agregada: exiba o tempo combinado necessário para executar a consulta em todos os núcleos de todos os nós. Pode ser significativamente maior do que a duração do relógio de parede se várias tarefas forem excutadas em paralelo. Pode ser menor do que a duração do tempo de relógio se as tarefas esperarem por nós disponíveis.
   • Entrada/saída (E/S): Exiba detalhes sobre os dados lidos e gravados durante a execução da consulta.

3. Clique em Exibir o perfil de consulta. Um painel Detalhes é aberto no lado direito da tela.

   

   Observação

   Se O perfil de consulta não está disponível for exibido, não haverá perfis disponíveis para essa consulta. Um perfil de consulta não está disponível para consultas que são executados no cache de consulta. Para contornar o cache de consulta, faça uma alteração trivial na consulta, como alterar ou remover o LIMIT.

Exibir detalhes do perfil de consulta

O perfil de consulta detalhado inclui métricas de resumo no lado esquerdo do painel e uma exibição de grafo de operadores à direita.

Explorar métricas de consulta

O lado esquerdo do perfil de consulta tem as seguintes guias:

1. Detalhes: abre o painel Detalhes que mostra as métricas de resumo da consulta.

2. Principais: abre o painel Operadores Principais , que mostra os operadores mais caros usados em sua consulta. Isso pode ser útil para identificar oportunidades de otimização.

3. : Abre o painel de Texto da consulta que mostra o texto completo da consulta.

Explorar o DAG

A metade direita do perfil de consulta mostra o grafo acíclico direcionado (DAG) da consulta. A exibição do grafo mostra métricas como Tempo Gasto, Pico de Memória e Linhas. Clique em cada métrica para alterar a métrica de relatório mostrada.

Você pode interagir com o DAG das seguintes maneiras:

• Use a barra de pesquisa para realçar diferentes operadores ou colunas.
• Ampliar ou reduzir o foco em diferentes partes do DAG.
• Clique em operadores para mostrar métricas e descrições detalhadas. Um painel no lado direito do grafo mostra os detalhes da operação.

Para consultas SQL do Databricks, você também pode exibir o perfil de consulta na interface do usuário do Spark. Clique no Menu de kebab próximo à parte superior da página e clique em Abrir na interface do usuário do Spark.

Por padrão, as métricas de algumas operações ficam ocultas. É improvável que essas operações sejam a causa de gargalos de desempenho. Para ver informações de todas as operações e métricas adicionais, clique em na parte superior da página e em Habilitar o modo de exibição detalhada.

Operações comuns

As operações mais comuns são:

• Verificação: os dados foram lidos de uma fonte de dados e saída como linhas.
• Junção: linhas de várias relações foram combinadas (intercaladas) em um único conjunto de linhas.
• União: as linhas de vários relacionamentos que usam o mesmo esquema foram concatenadas em um único conjunto de linhas.
• Embaralhamento: os dados foram redistribuídos ou reparticionados. As operações de ordem aleatória são caras em relação aos recursos porque movem dados entre executores no cluster.
• Hash/Classificação: as linhas foram agrupadas por uma chave e avaliadas usando uma função de agregação como SUM, COUNT ou MAX dentro de cada grupo.
• Filtro: a entrada é filtrada de acordo com um critério, como por uma cláusula WHERE, e um subconjunto de linhas é retornado.

Compartilhar um perfil de consulta

Para compartilhar um perfil de consulta com outro usuário:

1. Exiba o histórico de consulta.
2. Clique no nome da consulta.
3. Para compartilhar a consulta, você tem duas opções:
   • Se o outro usuário tiver a permissão PODE GERENCIAR na consulta, você poderá compartilhar com ele a URL do perfil da consulta. Clique em Compartilhar. A URL é copiada para a área de transferência.
   • Caso contrário, se o outro usuário não tiver a permissão PODE GERENCIAR ou não for membro do espaço de trabalho, você poderá fazer o download do perfil da consulta como um objeto JSON. Baixar. O arquivo JSON é baixado para o sistema local.

Importar um perfil de consulta

Para importar o JSON para um perfil de consulta:

1. Exiba o histórico de consulta.

2. Clique no menu do kebab no canto superior direito e selecione Importar perfil de consulta (JSON).

3. No navegador de arquivos, selecione o arquivo JSON que foi compartilhado com você e clique em Abrir. O arquivo JSON é carregado e o perfil de consulta é exibido.

   Quando você importa um perfil de consulta, ele é carregado dinamicamente na sessão do navegador e não persiste em seu espaço de trabalho. Você precisa re importá-lo sempre que quiser exibi-lo.

4. Para fechar o perfil de consulta importado, clique em X na parte superior da página.

Acessar o perfil de consulta

Você também pode acessar o perfil de consulta nas seguintes partes da interface do usuário:

• No editor do SQL: durante e após a execução da consulta, um link próximo à parte inferior da página exibe o tempo decorrido e o número de linhas retornadas. Clique nesse link para abrir o painel de detalhes da consulta. Clique em Exibir o perfil de consulta.

  

  Observação

  Se você tiver o novo editor SQL habilitado (Visualização Pública), seu link aparecerá como em um notebook.

• De um notebook: se o notebook estiver anexado a um SQL warehouse ou computação sem servidor, você poderá acessar o perfil de consulta usando o link na célula que contém a consulta. Clique em Ver desempenho para abrir o histórico de execuções. Clique em uma instrução para abrir o painel de detalhes da consulta.

  

• Na interface do usuário do Lakeflow Spark Declarative Pipelines: você pode acessar o histórico de consultas e o perfil na guia Histórico de Consultas na interface do usuário do pipeline. Consulte o histórico de consultas do Access para pipelines.

• Na interface do usuário dos trabalhos: você pode acessar perfis de consulta para trabalhos executados em SQL Warehouses e computação sem servidor. Para trabalhos executados na computação sem servidor, consulte Exibir detalhes da consulta para execuções de trabalho para saber como exibir detalhes da consulta na interface do usuário dos trabalhos.

Próximas etapas

• Saiba mais sobre como acessar métricas de consulta usando a API de histórico de consultas
• Saiba mais sobre histórico da consulta