Perfil de consulta

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

• O senhor 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 rapidamente a parte mais lenta da execução de uma consulta e avaliar os impactos das modificações na consulta.
• O senhor pode descobrir e corrigir erros comuns nas instruções do site SQL, como junções explosivas ou varreduras de tabelas completas.

Requisitos

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

visualizar um perfil de consulta

O senhor pode acessar view o perfil de consulta do histórico de consultas usando as seguintes etapas:

1. Clique em Query History (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: Emfila, em execução, concluída, com falha ou cancelada.
   • Detalhes do usuário e compute: Veja o nome de usuário, o tipo de compute e os detalhes do tempo de execução dessa consulta.
   • ID: Esse é o identificador universal exclusivo (UUID) associado à execução de determinada consulta.
   • Declaração de consulta: esta seção inclui a instrução de consulta completa. Se a consulta for muito longa para ser exibida na visualização, clique em ... more lines (mais linhas ) para view o texto completo.
   • Métricas de consulta: As métricas populares para análise de consultas são mostradas sob o texto da consulta. Os ícones de filtro que aparecem com algumas métricas indicam a porcentagem de dados eliminados durante a varredura.
   • Consulte perfil de consulta: Uma visualização do gráfico 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 perfil de consulta para abrir o DAG detalhado.
   • Veja os operadores mais longos para esta consulta: Clique nesse botão para abrir o painel Principais operadores . Esse painel mostra os operadores de execução mais longa na consulta.
   • Duração do relógio de parede da consulta: O tempo total decorrido entre o início do programar e o final da execução da consulta é fornecido como um resumo. Uma análise detalhada da programação, da otimização de consultas e da poda de arquivos, bem como do tempo de execução, aparece abaixo do resumo.
   • Fonte da consulta: clique no nome do objeto listado para acessar a fonte da consulta.
   • Tempo de tarefa agregado: visualize o tempo combinado que levou para executar a consulta em todos os núcleos de todos os nós. Ela pode ser significativamente mais longa do que a duração do relógio de parede se várias tarefas forem executadas em paralelo. Ela pode ser mais curta do que a duração do relógio de parede se a tarefa esperar por nós disponíveis.
   • Entrada/Saída (IO): exibe detalhes sobre os dados lidos e gravados durante a execução da consulta.

3. Clique em Ver perfil de consulta . Um painel de detalhes é aberto no lado direito da tela.

   

nota

Se o perfil de consulta não estiver disponível for exibido, nenhum perfil estará disponível para essa consulta. Um perfil de consulta não está disponível para consultas que são executadas a partir do cache de consultas. Para contornar o cache de consultas, faça uma alteração trivial na consulta, como alterar ou remover o LIMIT.

visualizar detalhes do perfil de consulta

O perfil de consulta detalhado inclui métricas resumidas no lado esquerdo do painel e um gráfico view das operadoras no lado direito.

Explorar métricas de consulta

O lado esquerdo do perfil de consulta tem a seguinte guia:

1. Detalhes : Abre o painel Details (Detalhes ) que mostra as métricas de resumo da consulta.

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

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

nota

Algumas operações que não são de fótons são executadas como um grupo e compartilham métricas comuns. Nesse caso, todas as operações têm o mesmo valor que o operador principal para uma determinada métrica.

Explore o DAG

A metade direita do perfil da consulta mostra o gráfico acíclico direcionado (DAG) da consulta. O gráfico view mostra métricas como tempo gasto , pico de memória e linhas . Clique em cada métrica para alterar as métricas de relatório exibidas.

Você pode interagir com o DAG das seguintes formas:

• Use a barra de pesquisa para destacar diferentes operadores ou colunas.
• Aumente ou diminua o zoom e foque em diferentes partes do DAG.
• Clique nos operadores para exibir métricas e descrições detalhadas. Um painel no lado direito do gráfico mostra os detalhes das operações.

Para consultas Databricks SQL, o senhor também pode view o perfil da consulta na interface do usuário Apache Spark. Clique no menu kebab próximo à parte superior da página e, em seguida, clique em Open in Spark UI .

Em default, as métricas de algumas operações estão ocultas. É improvável que essas operações sejam a causa dos gargalos de desempenho. Para ver as informações de todas as operações e ver as métricas adicionais, clique em na parte superior da página e, em seguida, clique em Enable verbose mode (Ativar modo detalhado ).

Operações comuns

As operações mais comuns são:

• Escanear : os dados foram lidos de uma fonte de dados e exibidos como linhas.
• junção : As linhas de várias relações foram combinadas (intercaladas) em um único conjunto de linhas.
• União : linhas de várias relações que usam o mesmo esquema foram concatenadas em um único conjunto de linhas.
• Shuffle: os dados foram redistribuídos ou reparticionados. As operações de embaralhamento são caras em relação ao recurso porque movem os dados entre os executores no clustering.
• Hash / Classificação : As linhas foram agrupadas por um key e avaliadas usando uma função agregada, como SUM, COUNT ou MAX em cada grupo.
• Filtro : a entrada é filtrada de acordo com um critério, como por meio de 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. visualizar o histórico da 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 CAN MANAGE na consulta, o senhor poderá compartilhar com ele o URL do perfil da consulta. Clique em Compartilhar . O URL é copiado para sua prancheta.
   • Caso contrário, se o outro usuário não tiver a permissão CAN MANAGE ou não for membro do workspace, o senhor poderá download o perfil de consulta como um objeto JSON. Faça o download . O arquivo JSON é baixado em seu sistema local.

Importar um perfil de consulta

Para importar o JSON de um perfil de consulta:

1. visualizar o histórico da consulta.

2. Clique no menu kebab no canto superior direito e selecione Import query profile (JSON) .

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

   Quando o senhor importa um perfil de consulta, ele é carregado dinamicamente na sessão do navegador e não persiste no site workspace. O senhor precisa reimportá-lo sempre que quiser acessá-lo em view.

4. Para fechar o perfil query importado, clique em X na parte inicio da página.

Acesse o perfil de consulta

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

• No editor 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 Ver perfil de consulta .

  

nota

Se o senhor tiver o novo editor SQL ativado (Public Preview), seu link aparecerá como em um Notebook.

• A partir de um Notebook : Se o Notebook estiver anexado a um SQL warehouse ou serverless compute, o senhor poderá acessar o perfil da consulta usando o link abaixo da célula que contém a consulta. Clique em Ver desempenho para abrir o histórico de execução. Clique em uma declaração para abrir o painel de detalhes da consulta .

  

• Na interface do usuário DLT pipeline : O senhor pode acessar o histórico e o perfil da consulta na Query History tab na interface de usuário pipeline. Consulte o histórico de consultas do Access para o pipeline DLT.

• Na interface do usuário do trabalho : O senhor pode acessar os perfis de consulta para a execução do trabalho no armazém SQL e serverless compute. Para a execução do trabalho em serverless compute, consulte Visualizar detalhes da consulta para a execução do trabalho para saber como view detalhes da consulta na interface do usuário do trabalho.

Próximas etapas

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