Diagnóstico de consulta

Ao usar o Diagnóstico de Consultas, você pode entender melhor o que o Power Query está fazendo durante a criação e durante a atualização no Power BI Desktop. Embora esse recurso esteja se expandindo no futuro, incluindo a adição da capacidade de usá-lo durante atualizações completas, você pode usá-lo no momento para entender que tipo de consultas você está emitindo, quais lentidão você pode encontrar durante a atualização de criação e que tipo de eventos em segundo plano estão acontecendo.

Para usar o Diagnóstico de Consulta, vá até a guia Ferramentas na faixa de opções do editor do Power Query.

Por padrão, o Diagnóstico de Consulta pode exigir direitos administrativos para ser executado (dependendo da política de TI). Se você não conseguir executar o Diagnóstico de Consulta, abra a página de opções da área de trabalho Power BI. Na guia Diagnóstico, selecione Habilitar em Editor de Consultas (não requer a execução como administrador). Essa seleção impede que você possa rastrear o diagnóstico ao fazer uma atualização completa em Power BI em vez do editor de Power Query, mas permite que você ainda o use ao visualizar e criar.

Sempre que você inicia os diagnósticos, o Power Query começa a registrar todas as avaliações que você provocar. A avaliação que a maioria dos usuários imagina é aquela em que você pressiona atualizar ou quando recupera dados pela primeira vez. Entretanto, há muitas ações que podem causar avaliações, dependendo do conector. Por exemplo, com o conector SQL, quando você recupera uma lista de valores para filtrar, isso também dispara uma avaliação, mas ela não está associada a uma consulta do usuário, e isso é refletido nos diagnósticos. Outras consultas geradas pelo sistema podem incluir o navegador ou a experiência de obter dados.

Quando você pressiona Etapa de Diagnóstico, o Power Query executa uma avaliação especial apenas da etapa que você está olhando. Em seguida, ele mostra o diagnóstico dessa etapa, sem mostrar o diagnóstico de outras etapas da consulta. Essa avaliação pode levar mais facilmente a uma visão limitada sobre um problema.

É importante que, se você estiver gravando todos os rastreamentos do Diagnóstico Inicial, pressione Parar diagnóstico. Interromper o diagnóstico permite que o mecanismo colete os rastreamentos gravados e os processe no formato de saída adequado. Sem essa etapa, os rastros são perdidos.

Tipos de diagnóstico

Há três tipos de diagnóstico, um dos quais tem dois níveis de detalhes.

O primeiro desses diagnósticos são os diagnósticos primários, que têm uma visão detalhada e uma visão resumida. A visão resumida tem como objetivo fornecer um insight imediato de como o tempo está sendo gasto em sua consulta. A visão detalhada é muito mais profunda, linha por linha, e, em geral, só é necessária para diagnósticos mais sérios feitos por usuários avançados.

Para esse modo de exibição, alguns recursos, como a coluna Consulta da Fonte de Dados, estão disponíveis apenas em determinados conectores.

As partições de privacidade de dados fornecem uma melhor compreensão das partições lógicas usadas para privacidade de dados.

Visualização resumida vs. detalhada

O diagnóstico de consulta fornece dois modos de exibição: resumido e detalhado. A exibição resumida "recolhe" várias operações relacionadas em uma única operação. Nesse processo, os detalhes coletados em cada operação são combinados e as durações exclusivas são somadas. Nenhuma informação é perdida nesse processo.

A exibição resumida fornece uma visão geral do que ocorreu durante uma avaliação para oferecer um revisão rápida de alto nível. Quando há necessidade de mais detalhamento para uma operação específica, você pode examinar a ID do grupo e exibir as operações correspondentes que foram agrupadas na exibição detalhada.

Explicando várias avaliações

Quando ocorre uma atualização no editor de Power Query, Power Query executa muito trabalho nos bastidores para oferecer uma experiência fluente ao usuário. Por exemplo, quando você atualiza a versão prévia, o avaliador executa a etapa final de cada consulta fornecida. Em seguida, em segundo plano, ele executa sequencialmente etapas n-1, etapas n-2, etapas n-3 e cada etapa subsequente. Portanto, se você percorrer as etapas, o resultado já estará disponível.

Para proporcionar melhor desempenho, atualmente algum armazenamento em cache é feito para que não seja necessário reexecutar todas as partes do plano da consulta final ao retornar pelas etapas. Embora esse armazenamento em cache seja útil para a autoria normal, isso significa que você nem sempre obtém informações corretas para a comparação entre etapas, devido a avaliações posteriores que recorrem a dados armazenados em cache.

Esquema de diagnóstico

Id

Ao analisar os resultados de uma gravação, é importante filtrar a sessão de gravação por ID, para que colunas como % de Duração Exclusiva façam sentido.

A ID é um identificador composto. Ela é formada por dois números: um antes do ponto e outro depois. O primeiro número é o mesmo para todas as avaliações resultantes de uma única ação do usuário. Em outras palavras, se você clicar em Atualizar duas vezes, haverá dois números diferentes antes do ponto, um para cada ação do usuário realizada. Essa numeração é sequencial para uma determinada gravação de diagnóstico.

O segundo número representa uma avaliação do motor. Esse número segue uma sequência durante todo o tempo de execução do processo no qual a avaliação é enfileirada. Se você executar várias sessões de gravação de diagnósticos, esse número continuará a crescer ao longo das diferentes sessões.

Para resumir, se você iniciar a gravação, pressionar “Evaluation” uma vez e parar a gravação, alguns IDs aparecerão nos diagnósticos. Mas, como você só realizou uma ação, todos eles são 1.1, 1.2, 1.3, e assim por diante.

A combinação da activityId e da evaluationId, separadas pelo ponto, fornece um identificador exclusivo para uma avaliação de uma única sessão de gravação.

Consulta

O nome da Consulta no painel esquerdo do editor do Power Query.

Etapa

O nome da Etapa no painel à direita do editor do Power Query. Elementos como listas suspensas de filtro geralmente são associados à etapa que está sendo filtrada, mesmo que a etapa não esteja sendo atualizada.

Categoria

A categoria da operação.

Variante de fonte de dados

Esses dados informam que tipo de fonte de dados você está acessando, como SQL ou Oracle.

Operação

A operação real que está sendo executada. Essa operação pode incluir o trabalho do avaliador, a abertura de conexões, o envio de consultas para a fonte de dados e muito mais.

Hora de início

A hora em que a operação começou.

Hora de término

A hora em que a operação terminou.

Duração exclusiva (%)

A coluna Duração Exclusiva de um evento é a quantidade de tempo em que o evento esteve ativo. Isso contrasta com o valor de "duração" que resulta da subtração dos valores da coluna Hora de Início e da coluna Hora de Término de um evento. Esse valor de duração representa o tempo total decorrido entre o momento em que um evento começou e quando foi encerrado, o que pode incluir momentos em que o evento estava em um estado suspenso ou inativo e outro evento estava consumindo recursos.

O percentual de duração exclusiva totaliza aproximadamente 100% dentro de uma determinada avaliação, conforme representado pela coluna ID. Por exemplo, se você filtrar linhas com id 1.x, os percentuais de Duração Exclusiva somarão aproximadamente 100%. Esse não é o caso se você somar os valores de % de Duração Exclusiva de todas as linhas em uma determinada tabela de diagnóstico.

Duração exclusiva

O tempo absoluto, em vez da porcentagem da duração exclusiva. A duração total (ou seja, duração exclusiva + tempo em que o evento estava inativo) de uma avaliação pode ser calculada por meio de uma dessas maneiras:

• Localize a operação chamada Avaliação. A diferença entre Hora de Término e Hora de Início resultará na duração total de um evento.

• Subtraia a hora mínima de início de todas as operações em um evento da hora máxima de término. Em casos em que as informações coletadas de um evento não representam a duração total, uma operação chamada Lacunas de Rastreamento é gerada para considerar esse intervalo de tempo.

Recurso

O recurso que você está usando para acessar dados. O formato exato desse recurso depende da fonte de dados.

Consulta da fonte de dados

O Power Query faz algo chamado folding, que consiste em executar o maior número possível de partes da consulta diretamente na fonte de dados de back-end. No modo DirectQuery (via Power Query), quando habilitado, somente são executadas as transformações que permitem folding. No modo de importação, as transformações que não podem ser dobradas são executadas localmente.

A coluna Consulta da Fonte de Dados mostra a consulta ou a solicitação HTTP e a resposta que Power Query envia à fonte de dados de back-end. À medida que você cria sua consulta no editor, muitas Consultas de Fonte de Dados são emitidas. Algumas dessas consultas são, na verdade, a consulta final efetiva da fonte de dados que gera a pré-visualização. Mas outras consultas podem ser usadas para dar suporte ao perfilamento de dados, a menus suspensos de filtro, a informações sobre junções ou à recuperação de metadados de esquemas.

Em geral, você não deve se preocupar com o número de Consultas de Fonte de Dados emitidas, a menos que haja motivos específicos para se preocupar. Em vez disso, você deve se concentrar em verificar se o conteúdo adequado está sendo recuperado. Essa coluna também pode ajudar a determinar se a avaliação do Power Query foi totalmente dobrada.

Informações adicionais

Há muitas informações recuperadas por nossos conectores. Grande parte é irregular e não se encaixa bem em uma hierarquia de colunas padrão. Essas informações são colocadas em um registro na coluna de informações adicionais. Informações registradas de conectores personalizados também aparecem aqui.

Contagem de linhas

O número de linhas retornadas por uma Consulta de Fonte de Dados. Não habilitada em todos os conectores.

Comprimento do conteúdo

Comprimento do conteúdo retornado por requisições HTTP, conforme comumente definido. Esse esquema não está habilitado em todos os conectores e não é preciso para conectores que recuperam solicitações em partes.

É consulta do usuário

Um valor booliano que indica se é uma consulta criada pelo usuário e se está presente no painel à esquerda ou se foi gerada por alguma outra ação do usuário. Outras ações do usuário podem incluir itens como seleção de filtro ou uso do navegador na experiência de obter dados.

Caminho

O caminho representa a rota relativa da operação quando exibido como parte de uma árvore de intervalo para todas as operações dentro de uma única avaliação. Na parte superior (raiz) da árvore, há uma única operação chamada Avaliação com o caminho 0. A hora de início desta avaliação corresponde ao início desta avaliação como um todo. A hora de término dessa avaliação mostra quando toda a avaliação foi concluída. Essa operação de alto nível tem uma duração exclusiva igual a 0, pois sua única finalidade é servir como a raiz da árvore.

Operações adicionais partem da raiz. Por exemplo, uma operação pode ter "0/1/5" como um caminho. Esse caminho seria entendido como:

• 0: raiz da árvore
• 1: pai da operação atual
• 5: índice da operação atual

A operação 0/1/5 pode ter um nó filho, nesse caso, o caminho teria o formato 0/1/5/8, com 8 representando o índice do filho.

ID do grupo

A combinação de duas (ou mais) operações não ocorre quando isso levar à perda de detalhes. O agrupamento foi projetado para aproximar "comandos" executados durante a avaliação. Na exibição detalhada, várias operações compartilham uma ID de Grupo, correspondente aos grupos agregados na exibição Resumida.

Assim como acontece com a maioria das colunas, o ID do grupo só é relevante no contexto de uma avaliação específica, conforme definido pela filtragem na coluna Id.

Esquema de partições de privacidade de dados

Id

O mesmo que a ID dos outros resultados de diagnóstico de consulta. A parte inteira representa uma única ID de atividade, enquanto a parte fracionária representa uma única avaliação.

Chave de partição

Corresponde à Consulta/Etapa que é usada como uma partição do firewall.

Grupo de firewall

Categorização que explica por que essa partição deve ser avaliada separadamente, incluindo detalhes sobre o nível de privacidade da partição.

Recursos acessados

Lista de caminhos de recursos para todos os recursos acessados por essa partição e, em geral, identifica exclusivamente uma fonte de dados.

Entradas de partição

Lista de chaves de partição das quais a partição atual depende (essa lista pode ser usada para criar um grafo).

Expressão

A expressão que é avaliada com base na consulta/etapa da partição. Em vários casos, coincide com a consulta/o passo.

Hora de início

Momento em que a avaliação foi iniciada para esta partição.

Hora de término

Hora em que a avaliação terminou nesta partição.

Duração

Um valor derivado de Hora de Término menos Hora de Início.

Duração exclusiva

Se for assumido que as partições são executadas em uma única thread, a duração exclusiva é a duração "real" que pode ser atribuída a essa partição.

Duração exclusiva %

Duração exclusiva como porcentagem.

Diagnósticos

Essa coluna só aparece quando o diagnóstico de consulta "Agregado" ou "Detalhado" também é capturado, permitindo que o usuário faça a correspondência entre as duas saídas de diagnóstico.

Esquema de contadores de desempenho

Quando você executa contadores de desempenho, a cada meio segundo o Power Query tira um instantâneo da utilização de recursos. Esse instantâneo não é útil para consultas muito rápidas, mas pode ser útil para consultas que usam muito mais recursos.

% de tempo do processador

Percentual do tempo gasto pelos processadores na consulta. Esse percentual pode ser maior que 100% devido a vários processadores.

Tempo total de processador

Duração total do tempo de processador gasto na consulta.

Bytes de dados de entrada/saída por segundo

Velocidade de taxa de transferência dos dados recebidos da fonte de dados, expressa em bytes por segundo.

Compromisso (bytes)

Quantidade de memória virtual reservada pela avaliação.

Conjunto de trabalho (bytes)

Quantidade de memória reservada pela avaliação.

Conteúdo relacionado

• Como registrar diagnósticos em vários casos de uso
• Saiba mais sobre como ler e visualizar seus rastreamentos gravados
• Como entender quais operações de consulta estão usando dobramento com o Diagnóstico de Consultas