Partilhar via

Histórico de consultas

Nota

Se seu espaço de trabalho estiver habilitado para computação sem servidor, seu histórico de consultas também conterá todas as consultas SQL e Python executadas em computação sem servidor para blocos de anotações e trabalhos. Veja Conectar a computação sem servidor.

Você pode utilizar as informações disponíveis nesta tela para ajudá-lo a solucionar problemas relacionados a consultas.

Esta seção descreve como trabalhar com o histórico de consultas usando a interface do usuário. Para trabalhar com o histórico de consultas usando a API, veja Histórico de consultas.

Ver histórico de consultas

Você pode exibir as execuções de consulta anteriores se for o proprietário da consulta. Outros usuários podem exibir execuções de consulta se tiverem pelo menos acesso CAN VIEW ao SQL warehouse que executou a consulta.

Para exibir execuções anteriores de uma consulta:

  1. Clique no ícone Histórico.Histórico de consultas na barra lateral.
  2. Opcionalmente, use os filtros próximos à parte superior da página para filtrar a lista por usuário, intervalo de datas, computação, duração, status da consulta, tipo de instrução e ID da instrução.

Nota

As consultas SQL do Databricks compartilhadas por um usuário com permissões Executar como Proprietário para outro usuário com permissões CAN RUN aparecem no histórico de consultas do usuário que executa a consulta e não do usuário que compartilhou a consulta.

Ver detalhes da consulta

Para exibir detalhes sobre uma consulta, como a instrução de consulta completa, a fonte da consulta, a duração, o número de linhas retornadas e o desempenho de E/S ou detalhes de execução.

  1. Aceda ao histórico de consultas conforme descrito na seção anterior.

  2. Clique no texto da consulta que deseja visualizar. Um painel de resumo abre-se à direita.

    Detalhes do histórico de consultas

    • Estado da consulta: A consulta é etiquetada com o seu estado atual: Em fila, A executar, Concluída, Falhada, 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 tempo de execução para esta execução de consulta.
    • ID: Este é o identificador único universal (UUID) associado à execução da consulta dada.
    • Query statement: Esta secção inclui a declaração completa da consulta. Se a consulta for muito longa para ser mostrada na visualização, clique em ... mais linhas para ver o texto completo.
    • Métricas de consulta: As métricas populares para análise de consulta são mostradas sob o texto da consulta. Os ícones de filtro que aparecem com algumas métricas indicam a porcentagem de dados removidos durante a verificação.
    • Ver perfil de consulta: Um resumo do grafo acíclico direcionado (DAG) do perfil de consulta é mostrado nesta síntese. Isto pode ser útil para estimar rapidamente a complexidade da consulta e o fluxo de execução. Clique em See query profile para abrir a DAG detalhada.
    • Veja os operadores mais longos para esta consulta: Clique neste botão para abrir o painel Principais operadores . Este painel mostra os operadores de execução mais longa na consulta.
    • Duração do relógio de parede da consulta: O total do tempo decorrido entre o início do agendamento e o final da execução da consulta é apresentado num resumo. Um detalhamento detalhado de agendamento, otimização de consultas, remoção de arquivos e tempo de execução aparece abaixo do resumo.
    • Origem da consulta: Clique no nome do objeto listado para ir para a fonte da consulta.
    • Tempo de tarefa agregado: Consulte o tempo combinado necessário para executar a consulta em todos os núcleos de todos os nós. Pode ser significativamente mais longa do que a duração real se várias tarefas forem executadas em paralelo. Pode ser menor do que a duração do relógio de parede se as tarefas esperarem pelos nós disponíveis.
    • Input/Output (E/S): Veja detalhes sobre os dados lidos e escritos durante a execução da consulta.

  3. Para obter informações mais detalhadas sobre o desempenho da consulta, incluindo seu plano de execução, clique em Exibir Perfil de Consulta na parte inferior da página. Para obter mais detalhes, consulte Perfil de consulta.

Encerrar uma consulta em execução

Para encerrar uma consulta de longa execução iniciada por você ou outro usuário:

  1. Aceda ao histórico de consultas conforme descrito na seção anterior.

  2. Clique no texto da consulta.

  3. Ao lado de Status, clique em Cancelar.

    Nota

    Cancelar só aparece quando uma consulta está em execução.

A consulta é encerrada e seu status muda para Cancelado.

Nota

As instruções que utilizam a computação do Lakeflow Spark Declarative Pipelines só podem ser canceladas através da interface de utilizador do Pipelines.

Acessar a tabela do sistema de histórico de consultas

As tabelas do sistema Azure Databricks incluem uma tabela de histórico de consultas (system.query.history) onde os utilizadores privilegiados podem ver registos do histórico de consultas tabulares a partir da sua conta. Por padrão, apenas os administradores têm acesso às tabelas do sistema da sua conta. Para obter informações sobre como habilitar e acessar a tabela do sistema de histórico de consultas, consulte Referência da tabela do sistema do histórico de consultas.

  • Last updated on