Gravando diagnósticos 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, atualiza potencialmente seus dados no editor do Power Query e os carrega no modelo do Power BI. Quando estiver no modelo do Power BI, você poderá atualizá-lo periodicamente no Power BI Desktop (se estiver usando o Desktop para exibir análises), além de quaisquer atualizações feitas no serviço.

Embora você possa obter um resultado semelhante no final de um fluxo de trabalho de criação, atualização no editor ou atualização no Power BI propriamente dito, avaliações muito diferentes são executadas pelo software para as diferentes experiências de usuário fornecidas. É importante saber o que esperar ao fazer diagnósticos de consulta nesses diferentes fluxos de trabalho para que você não seja surpreendido pelos dados de diagnóstico muito diferentes.

Para iniciar o Diagnóstico de Consultas, aceda ao separador Ferramentas no friso 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' (emparelhado 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 local ou remotamente em uma consulta. Este último dá-lhe mais informações sobre uma variedade de outros casos, discutidos abaixo.

Especificidades 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:

• Conector
• Transformações aplicadas
• Sistema em que está a executar
• 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 Consulta da tabela Northwind Customers, tanto em SQL quanto em OData. As notas OData usam o ponto de extremidade público encontrado no site da OData.org, enquanto você precisará fornecer um servidor SQL para si mesmo. Muitas fontes de dados serão significativamente diferentes destas, e terão documentação específica do conector adicionada ao longo do tempo.

Iniciar/parar diagnósticos

'Start Diagnostics' e 'Stop Diagnostics' são mais amplamente aplicáveis do que 'Diagnose Step', mas também lhe darão muito mais informações que você precisará classificar. Por exemplo, iniciar o diagnóstico, atualizar uma pré-visualização e, em seguida, parar irá fornecer-lhe informações equivalentes à execução do Passo de Diagnóstico em cada passo (devido à forma como o Power Query funciona no editor para atualizar cada passo 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 vistas em outros fluxos de trabalho. Conforme discutido no artigo principal do Diagnóstico de Consulta, eles são resultado do preenchimento de várias interfaces de usuário, como o navegador ou os menus suspensos de filtro.

Vamos dar um exemplo. Estamos usando o conector OData neste exemplo, mas ao revisar 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á colocar credenciais para seu servidor, mas para o ponto de extremidade OData público você pode colocar no ponto de extremidade vinculado acima.

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

Isto irá apresentar-lhe a tabela 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 em 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 seu agregado sendo uma contagem.

Isto deve apresentar-lhe os mesmos dados que 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 as tabelas resumidas e detalhadas aparecerão no lado esquerdo.

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

Atualizar pré-visualização

Quando terminar de transformar seus dados, você terá uma sequência de etapas em uma consulta. Quando premir 'Atualizar Pré-visualização' ou 'Atualizar Tudo' no editor do Power Query, não verá apenas um passo no diagnóstico da consulta. A razão para isso é que a atualização no Editor do Power Query atualiza explicitamente a consulta que termina com a última etapa aplicada e, em seguida, volta pelas etapas aplicadas e atualiza a consulta até esse ponto, de volta à origem.

Isso significa que, se você tiver cinco etapas em sua consulta, incluindo Origem e Navegador, esperará ver cinco avaliações diferentes em seu diagnóstico. A primeira, cronologicamente, muitas vezes (mas nem sempre) demorará mais tempo. Isto deve-se a duas razões diferentes:

• Ele pode potencialmente armazenar em cache dados de entrada que as consultas executadas depois dele (representando etapas anteriores na Consulta do usuário) podem acessar mais rapidamente localmente.
• Ele pode ter transformações aplicadas a ele que truncam significativamente a quantidade de dados que devem ser retornados.

Observe que, ao falar sobre "Atualizar tudo", ele atualizará todas as consultas e você precisará filtrar para as que lhe interessam, como seria de esperar.

Atualização completa

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

De qualquer forma, certifique-se de selecionar 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 mesa com a qual você se importa.

Quando 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 possíveis sobre a fonte de dados. A recuperação de dados consiste em acessar a fonte de dados, emitir a Consulta de Fonte de Dados construída final com operações dobradas e, em seguida, executar quaisquer avaliações que estejam faltando no topo, localmente.

É importante observar que só 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 atividade de rede. O Power Query pode recuperar essas informações de seu cache. Em atualizações futuras, indicaremos se as informações estão ou não sendo recuperadas do cache para facilitar o diagnóstico.

Etapa de diagnóstico

'Diagnosticar etapa' é mais útil para obter uma visão sobre quais avaliações estão acontecendo até uma única etapa, o que pode ajudá-lo a identificar, até essa etapa, como é o desempenho, bem como quais partes da sua consulta estão sendo executadas local ou remotamente.

Se você usou 'Etapa de diagnóstico' na consulta que criamos acima, descobrirá que ela retorna apenas 10 ou mais linhas, e se olharmos para a última linha com uma Consulta de Fonte de Dados, podemos ter uma boa ideia de qual será nossa consulta final emitida para a fonte de dados. Neste caso, podemos ver que o Representante de Vendas foi filtrado remotamente, mas o agrupamento (por processo de eliminação) aconteceu localmente.

Se iniciar e parar o diagnóstico e atualizar a mesma consulta, obtemos 40 linhas devido ao facto de, como mencionado acima, o Power Query estar a obter informações sobre cada passo, não apenas sobre o passo final. Isso torna mais difícil quando você está apenas tentando obter informações sobre uma parte específica da sua consulta.

Leitura adicional

Uma introdução ao recurso

Mais informações sobre como ler e visualizar os seus vestígios gravados

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