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

Esse recurso está em uma versão prévia. Os administradores do workspace podem habilitar esse recurso na página Visualizações. Consulte Gerenciar Versões Prévias 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 definido para ser executado no modo disparado .

Examinar 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 Computação na página de histórico de consultas para mostrar apenas as consultas processadas usando a computação do Delta Live Tables. Consulte Histórico de consultas para saber mais sobre a interface do usuário do histórico de consultas.

Para acessar os detalhes da consulta, siga estas etapas:

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 do resumo, como a duração da consulta e as 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.

Acessar o histórico de consultas de um notebook

Para exibir o histórico de consultas de dentro de um notebook anexado a um pipeline do Delta Live Tables, use as seguintes etapas:

1. Abra o bloco de anotações. Se o notebook estiver anexado a um pipeline do Delta Live Tables, uma interface para inspecionar o pipeline será exibida na parte inferior do notebook. Confira Desenvolver e depurar os pipelines de Tabelas Dinâmicas Delta em notebooks.
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 exibição, consulte Exibir detalhes da consulta.

Acessar o histórico de consultas da interface do usuário do pipeline do 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 exibir o painel de detalhes da consulta e o perfil clicando em uma instrução.

Limitações

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