Compartilhar via


Práticas recomendadas para um desempenho mais rápido na análise integrada do Power BI

Este artigo fornece recomendações para a renderização mais rápida de relatórios, dashboards e blocos em seu aplicativo.

Observação

Lembre-se de que o tempo de carregamento depende principalmente de elementos relevantes para o relatório e os próprios dados, incluindo visuais, o tamanho dos dados e a complexidade das consultas e medidas. Para obter mais informações, consulte o guia de otimização do Power BI.

Atualizar ferramentas e pacotes do SDK

Mantenha as ferramentas e os pacotes do SDK up-to-date.

Inicializar a inserção

Pré-carregamento

Use powerbi.preload() para melhorar o desempenho do usuário final. O método powerbi.preload() baixa JavaScript, arquivos css e outros itens, que são usados posteriormente para inserir um relatório.

Ligue powerbi.preload() se você não estiver inserindo o relatório imediatamente. Por exemplo, se o conteúdo inserido do Power BI não aparecer na home page, use powerbi.preload() para baixar e armazenar em cache os itens usados para inserir o conteúdo.

Inicializando o iFrame

Observação

O SDK do cliente do Power BI versão 2.9 é necessário para inicializar o iFrame.

powerbi.bootstrap(element, config) permite que você inicie a inserção antes que todos os parâmetros necessários estejam disponíveis. A API de bootstrap prepara e inicializa o iFrame. Ao usar a API de inicialização, ainda é necessário chamar powerbi.embed(element, config) no mesmo elemento HTML.

Por exemplo, um dos casos de uso para esse recurso é executar o iFrame bootstrap e as chamadas de back-end para inserção, em paralelo.

Dica

Use a bootstrap API quando possível para gerar o iFrame antes que seja visível para o usuário final.

Ao inserir um relatório ou outros itens do Power BI, verifique se o contêiner de inserção faz parte do DOM e se o atributo CSS de exibição não está definido como nenhum , pois isso pode causar comportamentos inesperados. Se você quiser ocultar o contêiner de inserção, considere usar o atributo CSS de visibilidade.

Inserir parâmetros

O powerbi.embed(element, config) método recebe um elemento e um parâmetro de configuração. O parâmetro de configuração inclui campos que têm implicações de desempenho.

Inserir URL

Evite gerar a URL de inserção por conta própria. Em vez disso, certifique-se de obter a URL de Incorporação chamando Obter Relatórios, Obter Painéis ou chamando a Obter Blocos API. O parâmetro de configuração na URL é usado para melhorias de desempenho.

Permissions

Forneça permissões de exibição se você não pretende inserir um relatório no modo de edição. Dessa forma, o tempo não é gasto inicializando componentes que são usados apenas no modo de edição.

Filtros, favoritos e segmentações

Normalmente, os visuais de relatório são salvos com dados armazenados em cache. Os relatórios renderizam os dados armazenados em cache enquanto as consultas são executadas. Se filtros, favoritos ou segmentações forem fornecidos, os dados armazenados em cache não serão usados, e os visuais serão renderizados somente após o término da consulta visual.

Se você inserir relatórios com os mesmos filtros, indicadores e segmentações de dados, salve o relatório com os filtros, indicadores e segmentações já aplicados. Quando você salva o relatório desta maneira, ele é renderizado usando os dados armazenados em cache que incluem filtros, marcadores e segmentações de dados, o que melhora o desempenho.

Alternar entre relatórios

Ao inserir vários relatórios no mesmo espaço, não gere um novo iFrame para cada relatório. Em vez disso, insira o novo relatório no mesmo iFrame para substituir o relatório anterior. Use powerbi.embed(element, config) com uma configuração diferente para inserir o novo relatório.

Observação

A inserção de relatórios usando o inserção para seus clientes (também conhecido como um cenário de "aplicativo possui dados"), requer o uso de um token de inserção com permissões para todos os relatórios e modelos semânticos. Para obter mais informações, consulte a API de geração de token.

Vários elementos visuais

Ao inserir vários visuais do mesmo relatório, não gere um novo iFrame para cada visual. Use um único iFrame para renderizar o relatório com os visuais especificados.

Ao inserir vários visuais em um único iFrame, considere os seguintes pontos:

  • O Power BI usa iFrames para inserir um relatório. Às vezes, talvez você queira adicionar mais conteúdo entre os visuais (por exemplo, texto ou gráficos que não vêm do relatório). Nesse caso, talvez você precise de um iFrame diferente para renderizar visuais diferentes. Para obter o melhor desempenho, tente organizar os visuais para que você use o menor número possível de iFrames. Para reduzir o número de iFrames, considere usar o recurso de layout personalizado.

  • Se você tiver visuais de relatórios diferentes ou modelos semânticos diferentes, considere unir os modelos semânticos e criar um novo relatório para que você possa incluir todos os visuais no mesmo iFrame.

  • Outra alternativa, se você tiver regiões nãotiguosas ou dados de vários modelos semânticos, será criar um painel e fixar os visuais nele. Isto permite-lhe:

    • Insira os blocos individuais em iFrames não contíguos. Os blocos do painel são mais leves que os relatórios e são carregados mais rapidamente.
    • Insira todo o painel em um iFrame. Isso permite que você tenha visuais de diferentes relatórios ou modelos semânticos em um iFrame sem criar um novo relatório.

    Tenha em mente, no entanto, que os blocos de dashboard não são interativos e não são atualizados com a mesma frequência que os visuais.

Cache de consultas

Organizações com capacidade do Power BI Premium ou capacidade do Power BI Embedded podem aproveitar o cache de consultas para acelerar os relatórios associados a um modelo semântico.

Saiba mais sobre o cache de consultas no Power BI.

Medir o desempenho

Eventos de desempenho

Para medir o desempenho embutido, você pode utilizar dois eventos:

  1. Evento carregado: o tempo até que o relatório seja inicializado (o logotipo do Power BI desaparece quando a carga é concluída).
  2. Evento renderizado: o tempo até que o relatório seja totalmente renderizado, usando os dados reais. O evento renderizado é acionado sempre que o relatório é renderizado novamente (por exemplo, depois de aplicar filtros). Para medir um relatório, certifique-se de fazer os cálculos no primeiro evento acionado.

Os dados armazenados em cache são renderizados quando disponíveis, mas nenhum outro evento é gerado.

Saiba mais sobre o tratamento de eventos.

Performance Analyzer

Para examinar o desempenho dos elementos de relatório, você pode usar o Analisador de Desempenho no Power BI Desktop. O Analisador de Desempenho permite que você veja e registre logs que medem o desempenho de cada um dos elementos de relatório.

Saiba mais sobre o Analisador de Desempenho.

Observação

Lembre-se sempre de comparar o desempenho do relatório inserido com o desempenho no powerbi.com. Isso pode ajudá-lo a entender a origem dos problemas de desempenho