Diagnóstico de consulta

Com o Diagnóstico de Consulta, você pode obter uma melhor compreensão do que Power Query está fazendo na Power BI Desktop. Embora possamos expandir esse recurso no futuro, incluindo a adição da capacidade de usá-lo durante as atções completas, neste momento você pode usá-lo para entender que tipo de consultas você está emitindo, quais lentidão você pode encontrar durante a atualização de criar e que tipos de eventos em segundo plano estão ocorrendo.

Para usar o Diagnóstico de Consulta, acesse a guia Ferramentas na faixa de Editor do Power Query de opções.

Diagnóstico de consulta.

Por padrão, o Diagnóstico de Consulta pode exigir direitos administrativos para ser executado (dependendo da política de IT). Se você não conseguir executar o Diagnóstico de Consulta, abra Power BI página de opções do Power BI e, na guia Diagnóstico, selecione Habilitar no Editor de Consultas (não requer a execução como administrador). Essa seleção restringe a capacidade de rastrear o diagnóstico ao fazer uma atualização completa no Power BI em vez do editor do Power Query, mas permite que você ainda o use durante a visualização, a autorização e assim por diante.

Opções de Diagnóstico de Consulta.

Sempre que você iniciar o diagnóstico, Power Query começa a rastrear as avaliações que você causar. A avaliação que a maioria dos usuários pensa é quando você pressiona a atualização 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 a filtrar, isso também inicia 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 de obter dados.

Quando você pressiona Diagnosticar Etapa, Power Query executa uma avaliação especial apenas da etapa que você está vendo. Em seguida, ele mostra o diagnóstico dessa etapa, sem mostrar o diagnóstico de 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 de Iniciar Diagnóstico, pressione Parar diagnóstico. Parar o diagnóstico permite que o mecanismo colete os rastreamentos gravados e os analisar na saída adequada. Sem essa etapa, você perderá seus rastreamentos.

Tipos de diagnóstico

Atualmente, fornecemos 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 exibição detalhada e uma exibição resumida. A exibição resumida destina-se a dar a você uma visão imediata sobre onde o tempo está sendo gasto em sua consulta. A exibição detalhada é muito mais profunda, linha por linha, e é, em geral, necessária apenas para diagnóstico sério por usuários de energia.

Para essa exibição, alguns recursos, como a coluna Consulta da Fonte de Dados, estão disponíveis atualmente apenas em determinados conectores. Trabalharemos para estender 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 privacidade de dados.

Observação

Power Query pode executar avaliações que talvez você não tenha disparado diretamente. Algumas dessas avaliações são executadas para recuperar metadados para que possamos otimizar melhor nossas consultas ou fornecer uma melhor experiência do usuário (como recuperar a lista de valores distintos em uma coluna exibida na experiência Filtrar Linhas). Outros podem estar relacionados a 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 fazem sentido, sinta-se à vontade para entrar em contato por meio de canais de suporte normais, seus comentários são como aprimoramos nosso — produto.

Exibição resumida versus detalhada

O diagnóstico de consulta fornece duas exibições: resumida e detalhada. A exibição resumida "cola" várias operações relacionadas em uma única operação. Nesse 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 desse processo.

A exibição resumida fornece uma visão geral do que ocorreu durante uma avaliação para uma revisão fácil de alto nível. Se mais detalhamento for necessário para uma operação específica, o usuário poderá ver a ID do grupo e exibir as operações correspondentes que foram agrupadas na exibição de detalhes.

Explicando várias avaliações

Ao atualizar no editor Power Query, há muito feito nos bastidores para tentar lhe dar uma experiência de usuário fluente. Por exemplo, quando você Atualizar Visualização, o avaliador executará a etapa final de cada consulta determinada. Mas, em segundo plano, ele executa sequencialmente as etapas n-1, n-2, etapas e assim por diante, para que, se você seguir as etapas, ela já estará disponível.

Para fornecer um desempenho mais alto, atualmente, ocorre algum cache para que ele não tenha que ser reprisado em todas as partes do plano de consulta final conforme ele passa pelas etapas. Embora esse cache seja útil para a produção normal, isso significa que você nem sempre obterá informações de comparação de etapa corretas devido a avaliações posteriores que esvaem 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. Ele é 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 de usuário. Em outras palavras, se você pressionar atualizar duas vezes, haverá dois números diferentes à frente do ponto, um para cada atividade do usuário realizada. Essa numeração é sequencial para uma determinada gravação de diagnóstico.

O segundo número representa uma avaliação pelo mecanismo. Esse número é sequencial durante o tempo de vida do processo em que a avaliação está na fila. Se você executar várias sessões de gravação de diagnóstico, verá que esse número continuará crescendo entre as sessões diferentes.

Para resumir, se você começar a gravar, pressionar a avaliação uma vez e parar a gravação, você terá algumas IDs em seu diagnóstico. Mas como você só fez uma ação, todos eles serão 1.1, 1.2, 1.3 e assim por diante.

A combinação de activityId e evaluationId, separada 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 de Power Query.

Etapa

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

Categoria

A categoria da operação.

Tipo de fonte de dados

Isso informa qual 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 trabalho do avaliador, abertura de conexões, envio de consultas para a fonte de dados e muito mais.

Hora de início

A hora em que a operação foi iniciada.

Hora de término

A hora em que a operação foi encerrada.

Duração Exclusiva (%)

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

% de duração exclusiva soma aproximadamente 100% em uma determinada avaliação, conforme representado pela coluna ID. Por exemplo, se você filtrar linhas com a ID 1.x, os percentuais de Duração Exclusiva serão somados a aproximadamente 100%. Esse não será 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 + hora em que o evento estava inativo) de uma avaliação pode ser calculada de uma das duas maneiras:

  • Encontre a operação chamada "Avaliação". A diferença entre a Hora de – Início da Hora de Término resulta na duração total de um evento.

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

Recurso

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

Consulta de fonte de dados

Power Query faz algo chamado Dobramento, que é o ato de executar o máximo de partes da consulta na fonte de dados de back-end possível. No modo consulta direta (por Power Query), quando habilitada, somente as transformaçãos que dobram serão executados. No modo de importação, as transformação que não podem ser dobradas serão executados localmente.

A coluna Consulta da Fonte de Dados permite que você veja a consulta ou solicitação/resposta HTTP enviada na fonte de dados de back-end. À medida que você autor de sua consulta no editor, muitas consultas de fonte de dados serão emitidas. Algumas delas são a consulta final da fonte de dados real para renderizar a versão prévia, mas outras 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 está sendo recuperado. Essa coluna também pode ajudar a determinar se a Power Query foi totalmente dobrada.

Informações adicionais

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

Contagem de linhas

O número de linhas retornadas por uma consulta de fonte de dados. Não habilitado em todos os conectores.

Comprimento do conteúdo

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

É a consulta de usuário

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

Caminho

Path representa a rota relativa da operação quando exibida como parte de uma árvore de intervalo para todas as operações em 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 dessa avaliação corresponde ao início dessa 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 nível superior tem uma duração exclusiva de 0, pois sua única finalidade é servir como a raiz da árvore.

Ramificação de operações posteriores da raiz. Por exemplo, uma operação pode ter "0/1/5" como um caminho. Esse caminho seria compreendido 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 tem 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 ocorrerá se levar à perda de detalhes. O grupo foi projetado para aproximar os "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 Resumo.

Assim como na maioria das colunas, a ID do grupo só é relevante em uma avaliação específica, conforme filtrado pela 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 usada como uma partição de firewall.

Grupo de Firewall

Categorização que explica por que essa partição precisa 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).

Expression

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

Hora de início

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

Hora de término

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 for presumido que as partições serão executadas em um único thread, a duração exclusiva será a duração "real" que pode ser atribuída a essa partição.

% de duração exclusiva

Duração exclusiva como um percentual.

Diagnósticos

Essa 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 você executar contadores de desempenho, a cada meio segundo Power Query 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.

% Tempo do Processador

Porcentagem de tempo gasto pelos processadores na consulta. Esse percentual pode chegar acima de 100% devido a vários processadores.

Tempo total do processador

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

Bytes de Dados de E/S por Segundo

Velocidade de produtividade dos dados recebidos da fonte de dados, expressos em bytes por segundo.

Confirmação (Bytes)

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

Conjunto de trabalho (bytes)

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

Leituras Adicionais

Como registrar o diagnóstico em vários casos de uso

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