Histórico de consultas
Se o site workspace estiver habilitado para serverless compute, o histórico de consultas também conterá todas as consultas SQL e Python executadas em serverless compute para Notebook e Job. Consulte Conectar-se a serverless compute .
Se o seu workspace tiver o Query History & Profile for DLT ativado (Public Preview), o histórico de consultas mostrará a execução de declarações CREATE e REFRESH em um SQL warehouse ou por meio de um DLT pipeline.
O senhor pode usar as informações disponíveis nessa tela para ajudá-lo a depurar problemas com as consultas.
Esta seção descreve como trabalhar com o histórico de consultas usando a UI. Para trabalhar com o histórico de consultas usando o site API, consulte Query History.
visualizar histórico da consulta
Para view execução anterior de uma consulta:
- Clique em
Query History (Histórico de consultas ) na barra lateral. - Opcionalmente, use os filtros na parte superior da página para filtrar a lista por usuário, intervalo de datas, compute, duração, status da consulta, tipo de extrato e ID do extrato.
Para as consultas Databricks SQL, os usuários não administradores sem pelo menos permissões CAN MONITOR só podem view suas próprias consultas em Query History .
Databricks SQL As consultas compartilhadas por um usuário com permissões de execução 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.
visualizar detalhes da consulta
Para view detalhes sobre uma consulta, como a instrução completa da consulta, a origem da consulta, a duração, o número de linhas retornadas e o desempenho de E/S, ou detalhes de execução.
-
visualizar o histórico da consulta.
-
Clique no nome de uma consulta.
- ID da instrução : Esse é o identificador universal exclusivo (UUID) associado ao objeto de consulta fornecido.
- Status da consulta: A consulta é marcada com seu status atual: Emfila, em execução, concluída, com falha ou cancelada.
- tipo de computação : Esse campo mostra o tipo de compute usado para a 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 no ícone
Expandir consulta para ver o texto completo. - Fonte da consulta : esse campo mostra a origem da consulta. As consultas podem vir de várias fontes, incluindo painéis AI/BI, objetos de consulta, o editor Databricks SQL, o Notebook e o pipeline DLT (Public Preview).
- Duração do relógio de parede : Mostra o tempo decorrido do relógio de parede entre o início do programar e o final da execução da consulta. O total é exibido automaticamente como a soma do tempo de programação 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 view Query Profile (Exibir perfil da 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 duração iniciada pelo senhor ou por outro usuário:
-
visualizar o histórico da consulta.
-
Clique no nome de uma consulta.
-
Ao lado de Status , clique em Cancelar .
Cancelar aparece somente quando uma consulta está em execução.
A consulta é encerrada e seu status muda para Cancelado .
As declarações que usam o DLT compute só podem ser canceladas na interface do usuário do pipeline.
Acessar a tabela do sistema de histórico de consultas
Databricks As tabelas do sistema incluem uma tabela de histórico de consultas (system.query.history) em que usuários privilegiados podem view registros de histórico de consultas tabulares de todo o seu account. Em default, somente os administradores têm acesso às tabelas de sistema do seu account. Para obter informações sobre como ativar e acessar a tabela do sistema de histórico de consultas, consulte Referência da tabela do sistema de histórico de consultas.