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.
Se o workspace tiver o Histórico e o Perfil de Consultas para DLT habilitados (Visualização Pública), o histórico de consultas será exibido CREATE e REFRESH as instruções serão executadas em um SQL warehouse ou por meio de um pipeline do Delta Live Tables.
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](https://docs.databricks.com/api/azure/workspace/query histórico).
Ver o histórico de consultas
Para exibir execuções anteriores de uma consulta:
- Clique em
Histórico de Consultas na barra lateral. - 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.
Para consultas SQL do Databricks, os usuários não administradores sem pelo menos permissões CAN MONITOR só podem exibir suas próprias consultas no Histórico de Consultas.
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.
Exiba o histórico de consulta.
Clique no nome de uma consulta.
- ID da instrução: esse é o identificador universalmente exclusivo (UUID) associado ao objeto de consulta fornecido.
- Status da consulta: a consulta é marcada com seu status atual: Enfileirada, Em execução, Concluída, Com falha ou Cancelada.
- Tipo de computação: esse campo mostra o tipo de computação usado para a consulta.
- 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 no
ícone Expandir consulta para ver o texto completo. - Origem da consulta: esse campo mostra onde a consulta se originou. As consultas podem vir de várias fontes, incluindo painéis de IA/BI, objetos de consulta, o editor SQL do Databricks, notebooks e pipelines do Delta Live Tables (Visualização Pública).
- Duração do relógio de parede: mostra o tempo decorrido do relógio de parede entre o início do agendamento e o final da execução da consulta. O total é exibido automaticamente como a soma do tempo de agendamento e do tempo de execução. Para saber mais, cada um desses campos pode ser expandido em subcategorias.
- Detalhes do resumo: a parte inferior do painel inclui detalhes resumidos sobre o desempenho da consulta, incluindo tempo de tarefa agregado, linhas lidas e retornadas, arquivos e partições e qualquer derramamento que possa ter ocorrido.
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:
Exiba o histórico de consulta.
Clique no nome de uma consulta.
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
As instruções que usam a computação do Delta Live Tables só podem ser canceladas na interface do 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.