Histórico de consultas

Observação

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 à computação sem servidor.

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 Delta Live Tables 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 API.

Ver histórico de consultas

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.

Observação

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.

Ver 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.

Ver histórico de consultas.
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 é identificada com seu status atual: Enfileirada, Em execução, Concluída, 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 Delta Live Tables (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:

Ver histórico de consultas.
Clique no nome de uma consulta.
Ao lado de Status, clique em Cancel (Cancelar).

Observação

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

A consulta é encerrada e seu status muda para Cancelado.

Observação

As declarações que usam Delta Live Tables 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 em 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.