Compartilhar via

Histórico de consultas

Observação

Se o workspace estiver habilitado para computação sem servidor, o histórico de consultas também conterá todas as consultas SQL e Python executadas na computação sem servidor para notebooks e trabalhos. Consulte Conectar-se ao computador sem servidor.

Você pode usar as informações disponíveis nesta tela para ajudá-lo a depurar problemas com consultas.

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

Ver o histórico de consultas

Você pode exibir execuções de consulta anteriores se for o proprietário da consulta. Outros usuários poderão exibir execuções de consulta se tiverem, pelo menos, ACESSO 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.

Observação

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.

Exibir detalhes da consulta

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

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

  2. Clique no texto da consulta que você deseja exibir. Um painel de resumo é aberto à direita.

    Detalhes do histórico de consultas

    • 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 GAD (grafo acíclico direcionado) do perfil de consulta é mostrada nesta síntese. 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 . Este painel mostra os operadores que estão em execução há mais tempo na consulta.
    • Duração do relógio de parede da consulta: O tempo total decorrido entre o início do agendamento e o fim 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.
    • Tempo agregado da tarefa: Visualize o tempo combinado necessário para realizar 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. Ele pode ser menor do que a duração do relógio de parede se as tarefas aguardarem 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. Para obter informações mais detalhadas sobre o desempenho da consulta, incluindo seu plano de execução, clique em Exibir Perfil de Consulta próximo à parte inferior da página. Para obter mais detalhes, confira Perfil de consulta.

Encerrar uma consulta em execução

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

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

  2. Clique no texto da consulta.

  3. Próximo ao Status, clique em Cancelar.

    Observação

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

A consulta é encerrada e seu status muda para Cancelado.

Observação

Instruções que utilizam a computação do Lakeflow Spark Declarative Pipelines só podem ser canceladas pela interface de usuário do Pipelines.

Acessar a tabela do sistema do histórico de consultas

As tabelas do sistema do Azure Databricks incluem uma tabela de histórico de consultas (system.query.history) em que os usuários privilegiados podem exibir registros de histórico de consultas tabulares de toda a sua conta. Por padrão, somente 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 do histórico de consultas, consulte Referência da tabela do sistema do histórico de consultas.

  • Last updated on