Acessar o histórico de consultas para pipelines do Delta Live Tables

Este artigo explica como acessar históricos de consulta e perfis de consulta associados a execuções de pipeline do Delta Live Tables. Você pode usar essas informações para depurar consultas, identificar gargalos de desempenho e otimizar execuções de pipeline.

Importante

Esta funcionalidade está em Pré-visualização Pública. Os administradores do espaço de trabalho podem ativar esse recurso na página Visualizações . Consulte Gerenciar visualizações do Azure Databricks.

Requisitos

• Seu pipeline deve ser configurado para ser executado no canal de visualização . Consulte Canais de tempo de execução do Delta Live Tables.
• Seu pipeline deve ser configurado para ser executado no modo acionado .

Revisar o histórico de consultas para atualizações de pipeline

Para todos os pipelines que atendem aos requisitos, uma instrução de consulta aparece no histórico de consultas quando as exibições materializadas e as tabelas de streaming são atualizadas. Há uma REFRESH instrução para cada execução de fluxo que atualiza uma tabela de destino. Você pode usar o filtro Compute na página de histórico de consultas para mostrar apenas consultas processadas usando a computação Delta Live Tables. Consulte Histórico de consultas para saber mais sobre a interface do usuário do histórico de consultas.

Para aceder aos detalhes da consulta, siga estes passos:

1. Clique em Histórico de Consultas na barra lateral.
2. Marque a caixa de seleção DLT no filtro suspenso Computação .
3. Clique em uma instrução de consulta para exibir detalhes resumidos, como a duração da consulta e métricas agregadas.
4. Clique em Ver perfil de consulta para abrir o perfil de consulta. Consulte Perfil de consulta para obter detalhes sobre o perfil de consulta.
5. Opcionalmente, use os links na seção Origem da Consulta para abrir o pipeline relacionado.

Aceder ao histórico de consultas a partir de um bloco de notas

Para exibir o histórico de consultas de dentro de um bloco de anotações anexado a um pipeline Delta Live Tables, use as seguintes etapas:

1. Abra o bloco de notas. Se o bloco de anotações estiver conectado a um pipeline Delta Live Tables, uma interface para inspecionar o pipeline será exibida na parte inferior do bloco de anotações. Consulte Desenvolver e depurar pipelines Delta Live Tables em blocos de anotações.
2. Clique na guia Histórico de consultas DLT.
3. Clique no nome de uma consulta para exibir detalhes da consulta, como duração, origem da consulta e outras métricas agregadas. Para saber mais sobre os detalhes disponíveis nesta vista, consulte Ver detalhes da consulta.

Acessar o histórico de consultas da interface do usuário do pipeline Delta Live Tables

Na página Detalhes do pipeline na interface do usuário do Delta Live Tables, clique na guia Histórico de consultas na parte inferior da tela para acessar o histórico do pipeline. Você pode visualizar o painel de detalhes da consulta e o perfil clicando em uma instrução.

Limitações

• O provisionamento e o tempo em fila não estão disponíveis.
• As métricas mostradas no painel de detalhes da consulta são atualizadas ao vivo durante a execução do fluxo, mas o perfil da consulta é atualizado somente após a conclusão da execução do fluxo.