Gravando diagnóstico de consulta no Power BI

Ao criar no Power Query, o fluxo de trabalho básico é que você se conecta a uma fonte de dados, aplica algumas transformações, potencialmente atualiza seus dados no editor do Power Query e, em seguida, carrega-os no modelo do Power BI. Quando ele estiver no modelo do Power BI, você poderá atualizá-lo de tempos em tempos no Power BI Desktop (se estiver usando a Área de Trabalho para exibir a análise), além das atualizações que fizer no serviço.

Embora você possa obter um resultado semelhante no final de um fluxo de trabalho de criação, ao atualizar no editor ou no próprio Power BI, diferentes avaliações são realizadas pelo software para as distintas experiências de usuário fornecidas. É importante saber o que esperar ao fazer o diagnóstico de consulta nesses diferentes fluxos de trabalho para que você não se surpreenda com os dados de diagnóstico muito diferentes.

Para iniciar o Diagnóstico de Consulta, acesse a guia Ferramentas na faixa de opções do editor do Power Query. Você é apresentado aqui com algumas opções diferentes.

Há duas opções principais aqui, 'Etapa de Diagnóstico' e 'Iniciar Diagnóstico' (emparelhada com 'Parar Diagnóstico'). O primeiro fornecerá informações sobre uma consulta até uma etapa selecionada e é mais útil para entender quais operações estão sendo executadas localmente ou remotamente em uma consulta. Este último fornece mais informações sobre uma variedade de outros casos, discutidos abaixo.

Especificações do conector

É importante mencionar que não há como cobrir todas as diferentes permutações do que você verá no Diagnóstico de Consulta. Há muitas coisas que podem mudar exatamente o que você vê nos resultados:

• Connector
• Transformações aplicadas
• Sistema em que você está executando
• Configuração de rede
• Opções de configuração avançadas
• Configuração ODBC

Para obter a cobertura mais ampla, esta documentação se concentrará no Diagnóstico de Consultas da tabela Northwind Customers, tanto no SQL quanto no OData. As notas do OData usam o ponto de extremidade público encontrado no site do OData.org, enquanto você precisará fornecer um servidor SQL por conta própria. Muitas fontes de dados serão significativamente diferentes delas e terão a documentação específica do conector adicionada ao longo do tempo.

Iniciar/parar o diagnóstico

'Iniciar Diagnóstico' e 'Parar Diagnóstico' são mais amplamente aplicáveis do que 'Etapa de Diagnóstico', mas também fornecerão muitas mais informações que você precisará organizar. Por exemplo, iniciar o diagnóstico, atualizar uma versão prévia e parar fornecerá informações equivalentes para executar a Etapa de Diagnóstico em cada etapa (devido a como o Power Query funciona no editor para atualizar cada etapa de forma independente).

Para iniciar a gravação, selecione Iniciar Diagnóstico, execute as avaliações desejadas (criação, atualização de visualização, atualização completa) e selecione Parar Diagnóstico.

Criação

A principal diferença do fluxo de trabalho de criação é que ele geralmente gerará mais avaliações individuais do que as observadas em outros fluxos de trabalho. Conforme discutido no artigo principal de Diagnóstico de Consultas, isso é resultado do preenchimento de várias interfaces do usuário, como o alternador ou as listas suspensas de filtro.

Vamos percorrer um exemplo. Estamos usando o conector OData neste exemplo, mas ao examinar a saída, também examinaremos a versão SQL do mesmo banco de dados. Para ambas as fontes de dados, vamos nos conectar à fonte de dados por meio de 'Nova Fonte', 'Fontes Recentes' ou 'Obter Dados'. Para a conexão SQL, você precisará inserir credenciais para o seu servidor, mas para o endpoint OData público, você pode inserir o endpoint vinculado acima.

Depois de se conectar e escolher a autenticação, selecione a tabela Clientes no serviço OData.

Isso apresentará a tabela de Clientes na interface do Power Query. Digamos que queremos saber quantos Representantes de Vendas existem em diferentes países/regiões. Primeiro, clique com o botão direito do mouse no Representante de Vendas na coluna Título do Contato, passe o mouse sobre Filtros de Texto e selecione Igual.

Agora, selecione Agrupar Por na faixa de opções e faça um agrupamento por País, com sua agregação sendo uma Contagem.

Isso deve apresentar os mesmos dados que você vê abaixo.

Por fim, navegue de volta para a guia Ferramentas da Faixa de Opções e selecione Parar Diagnóstico. Isso interromperá o rastreamento e criará seu arquivo de diagnóstico para você, e o resumo e as tabelas detalhadas aparecerão no lado esquerdo.

Se você rastrear uma sessão de criação inteira, geralmente esperará ver algo como uma avaliação da consulta da origem, seguida de avaliações relacionadas ao navegador relevante, e pelo menos uma consulta emitida para cada etapa que você aplicar (com potencial para mais, dependendo das ações exatas de UX executadas). Em alguns conectores, as avaliações paralelas ocorrerão por motivos de desempenho que produzirão conjuntos de dados muito semelhantes.

Atualizar visualização

Quando terminar de transformar seus dados, você terá uma sequência de etapas em uma consulta. Ao pressionar "Atualizar Versão Prévia" ou "Atualizar Tudo" no editor do Power Query, você não verá apenas uma etapa em seu diagnóstico de consulta. O motivo para isso é que a atualização no Editor do Power Query atualiza explicitamente a consulta até a última etapa aplicada e, em seguida, revisita cada etapa aplicada, atualizando a consulta até aquele ponto e retornando à origem.

Isso significa que, se você tiver cinco etapas em sua consulta, incluindo Origem e Navegador, deverá ver cinco avaliações diferentes em seu diagnóstico. O primeiro, cronologicamente, muitas vezes (mas nem sempre) levará mais tempo. Isso ocorre devido a dois motivos diferentes:

• Ele pode potencialmente armazenar dados de entrada temporariamente, de modo que consultas seguintes (representando etapas anteriores na Consulta do Usuário) possam acessar esses dados localmente de forma mais rápida.
• Pode ter transformações aplicadas a ele que truncam significativamente a quantidade de dados que precisa ser retornada.

Observe que, ao mencionar "Atualizar Tudo", todas as consultas serão atualizadas e você precisará filtrar aquelas que são importantes para você, conforme esperado.

Atualização completa

O Diagnóstico de Consulta pode ser usado para diagnosticar a chamada "consulta final" que é emitida durante a atualização no Power BI, em contraste com apenas a experiência do editor do Power Query. Para fazer isso, primeiro você precisa carregar os dados para o modelo uma vez. Se você estiver planejando fazer isso, lembre-se de que, se você selecionar Fechar e Aplicar, a janela do editor será fechada (interrompendo o rastreamento), então você precisa fazer isso na segunda atualização, ou clicar no ícone suspenso abaixo de Fechar e Aplicar e selecionar Aplicar em vez disso.

De qualquer forma, selecione Iniciar Diagnóstico na seção Diagnóstico da guia Ferramentas no editor. Depois de fazer isso, atualize seu modelo ou até mesmo apenas a tabela de seu interesse.

Depois de terminar de carregar os dados no modelo, selecione Parar Diagnóstico.

Você pode esperar ver alguma combinação de metadados e consultas de dados. As chamadas de metadados capturam as informações que podem sobre a fonte de dados. A recuperação de dados é acessar a fonte de dados, emitir a consulta final da fonte de dados com operações reduzidas e, em seguida, executar localmente quaisquer avaliações que estejam faltando.

É importante observar que, apenas porque você vê um recurso (banco de dados, ponto de extremidade da Web etc.) ou uma consulta de fonte de dados em seu diagnóstico, isso não significa que ele esteja necessariamente executando atividades de rede. O Power Query pode recuperar essas informações de seu cache. Em atualizações futuras, indicaremos se as informações estão sendo recuperadas ou não do cache para facilitar o diagnóstico.

Etapa de diagnóstico

'Etapa de Diagnóstico' é mais útil para obter uma visão sobre as avaliações que estão ocorrendo até uma etapa específica, o que pode ajudá-lo a identificar, nessa etapa, qual é o desempenho, assim como quais partes da consulta estão sendo executadas localmente ou remotamente.

Se você usou "Diagnosticar Etapa" na consulta que criamos acima, descobrirá que ela retorna apenas umas 10 linhas ou mais e, se examinarmos a última linha com uma Consulta da Fonte de Dados, poderemos ter uma boa ideia do que será nossa consulta emitida final para a fonte de dados. Nesse caso, podemos ver que o Representante de Vendas foi filtrado remotamente, mas o agrupamento (por processo de eliminação) ocorreu localmente.

Se você iniciar e parar o diagnóstico e atualizar a mesma consulta, obteremos 40 linhas devido ao fato de que, conforme mencionado acima, o Power Query está obtendo informações sobre cada etapa, não apenas a etapa final. Isso dificulta quando você está apenas tentando obter informações sobre uma parte específica da sua consulta.

Leitura adicional

Uma introdução ao recurso

Mais sobre como ler e visualizar seus rastreamentos gravados

Como entender quais operações de consulta estão sendo dobradas usando o Diagnóstico de Consulta