Procedure consigliate per prestazioni più veloci nell'analisi incorporata di Power BI

  • Articolo

Questo articolo fornisce consigli per il rendering più rapido di report, dashboard e riquadri nell'applicazione.

Nota

Tenere presente che il tempo di caricamento dipende principalmente da elementi rilevanti per il report e i dati stessi, inclusi gli oggetti visivi, le dimensioni dei dati e la complessità delle query e delle misure. Per altre informazioni, vedere la guida all'ottimizzazione di Power BI.

Aggiornare gli strumenti e i pacchetti SDK

Mantenere aggiornati gli strumenti e i pacchetti SDK.

  • Usare la versione più recente di Power BI Desktop.
  • Installare la versione più recente dell'SDK client di Power BI. Vengono rilasciati continuamente nuovi miglioramenti, quindi assicurarsi di eseguire il completamento di volta in volta.
  • Usare la versione più recente dell'editor tabulare.

Inizializzare l'incorporamento

Precaricamento

Usare powerbi.preload() per migliorare le prestazioni dell'utente finale. Il metodo powerbi.preload() scarica JavaScript, file CSS e altri elementi, che vengono usati in un secondo momento per incorporare un report.

Chiamare powerbi.preload() se non si incorpora immediatamente il report. Ad esempio, se il contenuto di Power BI incorporato non viene visualizzato nella home page, usare powerbi.preload() per scaricare e memorizzare nella cache gli elementi usati per incorporare il contenuto.

Bootstrap dell'iFrame

Nota

Power BI Client SDK versione 2.9 è necessario per eseguire il bootstrap dell'iFrame.

powerbi.bootstrap(element, config) consente di avviare l'incorporamento prima che siano disponibili tutti i parametri obbligatori. L'API bootstrap prepara e inizializza l'iFrame. Quando si usa l'API bootstrap, è comunque necessario chiamare powerbi.embed(element, config) sullo stesso elemento HTML.

Ad esempio, uno dei casi d'uso per questa funzionalità consiste nell'eseguire il bootstrap iFrame e le chiamate back-end per l'incorporamento, in parallelo.

Suggerimento

Usare l'API bootstrap quando possibile per generare l'iFrame prima che sia visibile all'utente finale.

Quando si incorpora un report o altri elementi di Power BI, assicurarsi che il contenitore di incorporamento faccia parte del DOM e che l'attributo CSS di visualizzazione non sia impostato su nessuno , in quanto ciò può causare comportamenti imprevisti. Se si vuole nascondere il contenitore di incorporamento, è consigliabile usare l'attributo CSS di visibilità.

Parametri di incorporamento

Il powerbi.embed(element, config) metodo riceve un elemento e un parametro config. Il parametro config include campi con implicazioni sulle prestazioni.

URL di incorporamento

Evita di generare manualmente l'URL di incorporamento. Assicurarsi invece di ottenere l'URL di incorporamento chiamando l'API Recupera report, Ottieni dashboard o Ottieni riquadri . Il parametro config nell'URL viene usato per migliorare le prestazioni.

Autorizzazioni

Fornire le autorizzazioni di visualizzazione se non si intende incorporare un report in modalità di modifica. In questo modo, il tempo non viene dedicato all'inizializzazione dei componenti usati solo in modalità di modifica.

Filtri, segnalibri e filtri dei dati

In genere, gli oggetti visivi del report vengono salvati con dati memorizzati nella cache. I report eseguono il rendering dei dati memorizzati nella cache durante l'esecuzione delle query. Se vengono forniti filtri, segnalibri o filtri dei dati, i dati memorizzati nella cache non vengono usati e gli oggetti visivi vengono visualizzati solo dopo la fine della query visiva.

Se si incorporano report con gli stessi filtri, segnalibri e filtri dei dati, salvare il report con filtri, segnalibri e filtri dei dati già applicati. Quando si salva il report in questo modo, viene eseguito il rendering usando i dati memorizzati nella cache che includono i filtri, i segnalibri e i filtri dei dati, migliorando le prestazioni.

Passaggio da un report all'altro

Quando si incorporano più report nello stesso spazio, non generare un nuovo iFrame per ogni report. Invece, incorporare il nuovo report nello stesso iFrame per sovrascrivere il report precedente. Usare powerbi.embed(element, config) con una configurazione diversa per incorporare il nuovo report.

Nota

L'incorporamento di report usando l'incorporamento per i clienti (noto anche come scenario di dati di proprietà dell'app), richiede l'uso di un token di incorporamento con autorizzazioni per tutti i report e i modelli semantici. Per altre informazioni, vedere l'API di generazione del token.

Più oggetti visivi

Quando si incorporano più oggetti visivi dello stesso report, non generare un nuovo iFrame per ogni oggetto visivo. Usare un singolo iFrame per eseguire il rendering del report con gli oggetti visivi specificati.

Quando si incorporano più oggetti visivi in un singolo iFrame, considerare i punti seguenti:

  • Power BI usa iFrame per incorporare un report. In alcuni casi potrebbe essere necessario aggiungere altri contenuti tra gli oggetti visivi, ad esempio testo o grafica che non provengono dal report. In tal caso, potrebbe essere necessario un iFrame diverso per eseguire il rendering di oggetti visivi diversi. Per ottenere prestazioni ottimali, provare a disporre gli oggetti visivi in modo da usare il minor numero possibile di iFrame. Per ridurre il numero di iFrame, è consigliabile usare la funzionalità di layout personalizzato.

  • Se si hanno oggetti visivi di report diversi o modelli semantici diversi, è consigliabile unire i modelli semantici e creare un nuovo report in modo che sia possibile includere tutti gli oggetti visivi nello stesso iFrame.

  • Un'altra alternativa, se sono presenti aree non contigue o dati da più modelli semantici, consiste nel creare un dashboard e aggiungere gli oggetti visivi. In questo modo è possibile:

    • Incorporare i singoli riquadri in iFrame non contigui. I riquadri del dashboard sono più leggeri rispetto ai report e vengono caricati più velocemente.
    • Incorporare l'intero dashboard in un iFrame. In questo modo è possibile avere oggetti visivi di report o modelli semantici diversi in un iFrame senza creare un nuovo report.

    Tenere presente, tuttavia, che i riquadri del dashboard non sono interattivi e non vengono aggiornati con la stessa frequenza degli oggetti visivi.

Memorizzazione di query nella cache

Le organizzazioni con capacità Power BI Premium o power BI Embedded possono sfruttare la memorizzazione nella cache delle query per velocizzare i report associati a un modello semantico.

Altre informazioni sulla memorizzazione nella cache delle query in Power BI.

Misurare le prestazioni

Eventi di prestazioni

Per misurare le prestazioni incorporate, è possibile usare due eventi:

  1. Evento Loaded: il tempo fino all'inizializzazione del report (il logo di Power BI scompare al termine del caricamento).
  2. Evento sottoposto a rendering: l'ora fino al rendering completo del report, usando i dati effettivi. L'evento sottoposto a rendering viene generato ogni volta che viene eseguito il rendering del report, ad esempio dopo l'applicazione dei filtri. Per misurare un report, assicurarsi di eseguire i calcoli sul primo evento generato.

Il rendering dei dati memorizzati nella cache viene eseguito quando disponibile, ma non viene generato alcun altro evento.

Altre informazioni sulla gestione degli eventi.

Analizzatore prestazioni

Per esaminare le prestazioni degli elementi del report, è possibile usare il analizzatore prestazioni in Power BI Desktop. Il analizzatore prestazioni consente di visualizzare e registrare i log che misurano le prestazioni di ogni elemento del report.

Altre informazioni sulle analizzatore prestazioni.

Nota

Ricordarsi sempre di confrontare le prestazioni del report incorporate con le prestazioni in powerbi.com. Ciò può aiutare a comprendere l'origine dei problemi di prestazioni

Contenuto correlato