Diagnóstico de consultas

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

Para utilizar o Diagnóstico de Consultas, aceda ao separador Ferramentas no friso 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 do Power BI e, na guia Diagnóstico, selecione Habilitar no Editor de Consultas (não requer execução como administrador). Essa seleção impede que você possa rastrear diagnósticos ao fazer uma atualização completa no Power BI em vez do editor do Power Query, mas permite que você ainda o use ao visualizar, criar e assim por diante.

Sempre que inicia diagnósticos, o Power Query começa a rastrear todas as avaliações que causar. A avaliação que a maioria dos usuários pensa é quando você pressiona refresh ou quando recupera dados pela primeira vez, mas 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 daria início a uma avaliação, mas não se associa a uma consulta de usuário e isso é representado no diagnóstico. Outras consultas geradas pelo sistema podem incluir o navegador ou a experiência get data.

Quando prime o Passo de Diagnóstico, o Power Query executa uma avaliação especial apenas do passo que está a ver. Em seguida, ele mostra o diagnóstico para essa etapa, sem mostrar o diagnóstico para outras etapas na consulta. Isso pode tornar muito mais fácil obter uma visão estreita de um problema.

É importante que, se você estiver gravando todos os rastreamentos do Iniciar diagnóstico, pressione Parar diagnóstico. Parar o diagnóstico permite que o motor colete os vestígios gravados e os analise na saída adequada. Sem este passo, perderá os seus vestígios.

Tipos de diagnóstico

Atualmente, fornecemos três tipos de diagnóstico, um dos quais tem dois níveis de detalhe.

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 vista resumida destina-se a dar-lhe uma visão imediata sobre onde o tempo está a ser gasto na sua consulta. A visão detalhada é muito mais profunda, linha por linha, e é, em geral, necessária apenas para diagnósticos sérios por usuários avançados.

Para esse modo de exibição, alguns recursos, como a coluna Consulta da Fonte de Dados, estão atualmente disponíveis apenas em determinados conectores. Trabalharemos para ampliar a amplitude dessa cobertura no futuro.

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

Nota

O Power Query pode executar avaliações que talvez você não tenha acionado diretamente. Algumas dessas avaliações são realizadas para recuperar metadados para que possamos otimizar melhor nossas consultas ou fornecer uma melhor experiência ao usuário (como recuperar a lista de valores distintos dentro de uma coluna que são exibidos na experiência Filtrar Linhas). Outros podem estar relacionados à forma como um conector lida com avaliações paralelas. Ao mesmo tempo, se você vir em seu diagnóstico de consulta consultas repetidas que você não acredita que façam sentido, sinta-se à vontade para entrar em contato por meio de canais de suporte normais — seu feedback é como melhoramos nosso produto.

Vista resumida vs. vista detalhada

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

A visão resumida fornece uma visão geral do que ocorreu durante uma avaliação para facilitar a revisão de alto nível. Se for necessário detalhar mais para uma operação específica, o usuário pode olhar para o ID do grupo e exibir as operações correspondentes que foram agrupadas na visualização detalhada.

Explicar as avaliações múltiplas

Ao atualizar no editor do Power Query, há muito feito nos bastidores para tentar proporcionar-lhe uma experiência de utilizador fluente. Por exemplo, quando atualizar a Pré-visualização, o avaliador executará o passo final de cada Consulta. Mas então, em segundo plano, ele executa sequencialmente n-1 passos, n-2, passos e assim por diante, de modo que, se você voltar atrás em seus passos, ele já está disponível.

Para fornecer um desempenho mais alto, atualmente algum cache acontece para que ele não precise executar novamente todas as partes do plano de consulta final à medida que ele volta pelas etapas. Embora esse cache seja útil para a criação normal, isso significa que você nem sempre obterá informações corretas de comparação de etapas devido a avaliações posteriores que extraem 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.

Id é um identificador composto. É formado por dois números: um antes do ponto e outro depois. O primeiro número é o mesmo para todas as avaliações que resultaram de uma única ação do usuário. Em outras palavras, se você pressionar atualizar duas vezes, haverá dois números diferentes liderando o ponto, um para cada atividade do usuário realizada. Esta numeração é sequencial para um determinado registo de diagnóstico.

O segundo número representa uma avaliação pelo motor. Este número é sequencial durante o tempo de vida do processo em que a avaliação está enfileirada. Se você executar várias sessões de gravação de diagnóstico, verá que esse número continuará a crescer nas diferentes sessões.

Para resumir, se você começar a gravar, pressionar a avaliação uma vez e parar a gravação, você terá algum número de Ids em seu diagnóstico. Mas como você só tomou uma ação, todas elas serão 1.1, 1.2, 1.3 e assim por diante.

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

Query

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

Passo

O nome do Passo no painel direito do editor do Power Query. Itens como menus suspensos de filtro geralmente se associam à etapa em que você está filtrando, mesmo que você não esteja atualizando a etapa.

Categoria

A categoria da operação.

Tipo de fonte de dados

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

Operação

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

Hora de início

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

Hora de fim

A hora em que a operação terminou.

Duração exclusiva (%)

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

A % de duração exclusiva soma aproximadamente 100% dentro de uma determinada avaliação, representada pela coluna Id. Por exemplo, se você filtrar em linhas com Id 1.x, as porcentagens de Duração Exclusiva somarão aproximadamente 100%. Esse não é o caso se você somar os valores % de Duração Exclusiva de todas as linhas em uma determinada tabela de diagnóstico.

Duração exclusiva

O tempo absoluto, em vez de %, de duração exclusiva. A duração total (ou seja, duração exclusiva + tempo em que o evento esteve inativo) de uma avaliação pode ser calculada de duas formas:

• Encontre a operação chamada "Avaliação". A diferença entre Hora de Término e Hora de Início resulta 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. Observe que, nos casos em que as informações coletadas para um evento não contabilizam a duração total, uma operação chamada "Trace Gaps" é gerada para contabilizar esse intervalo de tempo.

Recurso

O recurso que você está acessando para obter dados. O formato exato deste recurso depende da fonte de dados.

Consulta da fonte de dados

O Power Query faz algo chamado dobragem, que é o ato de executar o maior número possível de partes da consulta na fonte de dados back-end. No modo de Consulta Direta (através do Power Query), quando ativado, apenas as transformações dobradas serão executadas. No modo de importação, as transformações que não podem ser dobradas serão executadas localmente.

A coluna Consulta da Fonte de Dados permite que você veja a consulta ou a solicitação/resposta HTTP enviada em relação à fonte de dados back-end. À medida que você cria sua Consulta no editor, muitas Consultas de Fonte de Dados serão emitidas. Alguns deles são a Consulta de Fonte de Dados final real para renderizar a visualização, mas outros podem ser para criação de perfil de dados, menus suspensos de filtro, informações sobre junções, recuperação de metadados para esquemas e qualquer número de outras consultas pequenas.

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 garantir que o conteúdo adequado esteja sendo recuperado. Esta 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 pelos nossos conectores. Grande parte é esfarrapada 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. As informações registradas a partir 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 ativado em todos os conectores.

Comprimento do conteúdo

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

É consulta do usuário

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

Caminho

Path representa a rota relativa da operação quando visto como parte de uma árvore de intervalos para todas as operações dentro de uma única avaliação. No topo (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 final desta avaliação mostra quando toda a avaliação terminou. Esta operação de nível superior tem uma duração exclusiva de 0, uma vez que o seu único objetivo é servir como raiz da árvore.

Outras operações ramificam-se a partir da raiz. Por exemplo, uma operação pode ter "0/1/5" como caminho. Este caminho seria entendido como:

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

A operação "0/1/5" pode ter um nó filho, nesse caso, o caminho tem a forma "0/1/5/8", com 8 representando o índice da criança.

ID do Grupo

A combinação de duas (ou mais) operações não ocorrerá se levar à perda de detalhes. O agrupamento é projetado para aproximar "comandos" executados durante a avaliação. Na vista detalhada, várias operações partilham um ID de Grupo, correspondente aos grupos que são agregados na vista Resumo.

Como acontece com a maioria das colunas, o ID do grupo só é relevante dentro de uma avaliação específica, conforme filtrado pela coluna Id.

Esquema de partições de privacidade de dados

Id

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

Chave de partição

Corresponde à Consulta/Etapa usada como uma partição de 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 (esta lista pode ser usada para construir um gráfico).

Expression

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

Hora de início

Hora em que a avaliação começou para esta partição.

Hora de fim

Hora em que a avaliação terminou para esta partição.

Duração

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

Duração exclusiva

Se as partições são assumidas para executar em um único thread, duração exclusiva é a duração "real" que pode ser atribuída a esta partição.

Duração exclusiva %

Duração exclusiva em percentagem.

Diagnóstico

Esta coluna só aparece quando o diagnóstico de consulta "Agregado" ou "Detalhado" também é capturado, permitindo que o usuário corresponda entre as duas saídas de diagnóstico.

Esquema de contadores de desempenho

Quando executa contadores de desempenho, cada meio segundo do 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 consomem muito mais recursos.

% de tempo do processador

Porcentagem do tempo gasto pelos processadores na consulta. Essa porcentagem pode chegar acima de 100% por causa de vários processadores.

Tempo total do processador

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

Bytes de dados de E/S por segundo

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

Confirmar (bytes)

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

Conjunto de trabalho (bytes)

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

Leitura adicional

Como registrar diagnósticos em vários casos de uso

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