Partilhar via

Perfil de consulta

  • Artigo

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

  • Você pode visualizar cada operador de consulta e 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.
  • Você pode descobrir e corrigir erros comuns em instruções SQL, como junções explosivas ou varreduras de tabela completa.

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.

Ver um perfil de consulta

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

  1. Ver histórico de consultas.

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

    Modo de exibição simples de resumo de execução de consulta

  3. Clique em Ver perfil da consulta.

    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 executadas a partir do cache de consulta. Para contornar o cache de consulta, faça uma alteração trivial na consulta, como alterar ou remover o LIMIT.

  4. Para exibir o perfil de consulta no modo de exibição de gráfico (o padrão), clique em Modo de exibição de gráfico. Para exibir o perfil de consulta como uma árvore, clique em Modo de exibição em árvore.

    • A visualização de gráfico é otimizada para visualizar como os dados fluem de um nó para outro.
    • O modo de exibição em árvore é otimizado para localizar rapidamente problemas com o desempenho da consulta, como identificar o operador de execução mais longa.

  5. Na vista de gráfico ou na vista de árvore, pode clicar num dos separadores na parte superior da página para visualizar informações sobre cada um dos operadores da consulta.

    • Tempo gasto: tempo agregado gasto para cada operação. O tempo total da tarefa também é fornecido.
    • Linhas: o número e o tamanho das linhas afetadas por cada um dos operadores da consulta.
    • Memória de pico: a memória de pico que cada um dos operadores da consulta consumiu.

    Nota

    Algumas operações não-Photon 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 pai para uma determinada métrica.

  6. Na visualização de gráfico, você pode clicar em um operador para mostrar métricas detalhadas. Na visualização em árvore, você pode clicar no nome do operador para ver os detalhes relacionados.

  7. Cada nó é rotulado com a sua operação. 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 Menu de kebab na parte superior da página e, em seguida, clique em Ativar modo detalhado. As operações mais comuns são:

    • Análise: Os dados foram lidos de uma fonte de dados e apresentados como registos.
    • Join: Linhas de múltiplas relações foram combinadas (intercaladas) num ú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 termos de recursos porque movem dados entre executores no cluster.
    • Hash / Sort: As linhas foram agrupadas por uma chave e avaliadas usando uma função agregada como SUM, COUNTou MAX dentro de cada grupo.
    • Filtro: a entrada é filtrada de acordo com um critério, como por uma WHERE cláusula, e um subconjunto de linhas é retornado.
    • (Reutilizado) Exchange: um Shuffle ou Broadcast Exchange é usado para redistribuir os dados entre os nós do cluster com base no particionamento desejado.
    • Collect Limit: O número de linhas retornadas foi limitado através de uma instrução LIMIT.
    • Take Ordered And Project: As N linhas superiores do resultado da consulta foram retornadas.

  8. (Opcional) Para consultas Databricks SQL, você também pode exibir o perfil de consulta na interface do usuário do Apache Spark. Clique no Menu de kebab menu kebab na parte superior da página e, em seguida, clique em Abrir na interface do usuário do Spark.

  9. Para fechar o perfil de consulta, clique em Ocultar perfil de consulta na parte inferior do painel.

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

  • A partir do editor SQL: Quando a consulta é concluída, um link perto da parte inferior da página mostra 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.

    Abrir o histórico de consultas a partir da saída do editor

    Nota

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

  • A partir de um bloco de notas: se o seu bloco de notas estiver ligado a um armazém SQL ou a uma computação sem servidor, pode aceder ao perfil de consulta utilizando a ligação por baixo da célula que contém a consulta. Clique em Ver desempenho para abrir o histórico de execução. Clique numa instrução para abrir o painel de detalhes da consulta.

    Abrir a saída do bloco de anotações do histórico de consultas

  • A partir da interface do utilizador do pipeline DLT: Pode aceder ao histórico de consultas e ao perfil no separador Histórico de Consultas na interface do utilizador do pipeline. Consulte histórico de consultas do Access para pipelines de DLT

  • Na UI de tarefas: isso se aplica apenas a tarefas sem servidor. Consulte Executar trabalhos Azure Databricks com computação sem servidor para fluxos de trabalho para saber como abrir o perfil de consulta a partir da interface do utilizador dos trabalhos.

Ver detalhes sobre o perfil de consulta

O perfil de consulta lista os operadores de nível superior da consulta em ordem inversa, com o último operador listado primeiro. Use as etapas a seguir para se familiarizar com as diferentes partes do perfil de consulta.

  1. Utilize os botões Tempo gasto, Linhas e Pico de memória na parte superior da vista do perfil de consulta para ver as métricas de nível superior em cada categoria.
  2. Clique em um operador para exibir detalhes sobre a operação, como a descrição e as métricas sobre a duração, a memória consumida, o número e o tamanho das linhas retornadas e quaisquer expressões de agrupamento e agregação ou atributos de saída usados.
  3. Para fechar os detalhes do operador, clique em Voltar aos detalhes da consulta.
  4. Para fechar o perfil de consulta, clique em Ocultar perfil de consulta na parte inferior do painel direito.

Partilhar um perfil de consulta

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

  1. Ver histórico de consultas.
  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, você poderá compartilhar a URL do perfil de consulta com ele. Clique em Share (Partilhar). O URL foi copiado para a área de transferência.
    • Caso contrário, se o outro usuário não tiver a permissão CAN MANAGE ou não for membro do espaço de trabalho, você poderá baixar o perfil de consulta como um objeto JSON. Transferir. O arquivo JSON é baixado para o seu sistema local.

Importar um perfil de consulta

Para importar o JSON para um perfil de consulta:

  1. Ver histórico de consultas.

  2. Clique no Menu Kebab Menu 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 no espaço de trabalho. Você precisa importá-lo novamente sempre que quiser visualizá-lo.

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

Próximos passos