Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo fornisce consigli per il rendering più rapido di report, dashboard e riquadri nell'applicazione.
Annotazioni
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 gli strumenti e i pacchetti SDK up-to-date.
- Usare la versione più recente di Power BI Desktop.
- Installare la versione più recente dell'SDK client di Power BI. Rilasciamo continuamente nuove migliorie, quindi assicurarsi di verificare di tanto in tanto.
- 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.
Chiama powerbi.preload() se non incorpori 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.
Inizializzazione dell'iFrame
Annotazioni
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 dell'iFrame e le chiamate back-end per l'incorporazione, 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
Evitare di generare manualmente l'URL di incorporamento. Invece, assicurati di ottenere l'URL di embedding chiamando l'API Ottieni report, Ottieni dashboard o Ottieni riquadri. Il parametro config nell'URL viene usato per migliorare le prestazioni.
Permissions
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 slicer
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 segmenti, i dati memorizzati nella cache non vengono utilizzati e gli oggetti visivi vengono visualizzati solo dopo il completamento della query dell'oggetto visivo.
Se si incorporano report con gli stessi filtri, segnalibri e slicer, salvare il report con i filtri, i segnalibri e gli slicer 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 gli slicer, 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.
Annotazioni
L'incorporamento di report utilizzando l'incorporamento per i propri clienti (noto anche come scenario "app owns data"), richiede l'uso di un token di incorporamento con l'autorizzazione per tutti i report e i modelli semantici. Per altre informazioni, vedere l'API di generazione del token.
Visuali multiple
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 nella cache delle query
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 Performance
Per misurare le prestazioni incorporate, è possibile usare due eventi:
- Evento Loaded: il tempo fino all'inizializzazione del report (il logo di Power BI scompare al termine del caricamento).
- Evento sottoposto a rendering: il tempo necessario per il rendering completo del report, usando i dati effettivi. L'evento di rendering viene generato ogni volta che il report viene rielaborato, 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 delle prestazioni
Per esaminare le prestazioni degli elementi del report, è possibile usare Analizzatore prestazioni in Power BI Desktop. Analizzatore prestazioni consente di visualizzare e registrare i log che misurano le prestazioni di ogni elemento del report.
Altre informazioni su Performance Analyzer.
Annotazioni
Ricordarsi sempre di confrontare le prestazioni del report integrato con le prestazioni su powerbi.com. Ciò può aiutare a comprendere l'origine dei problemi di prestazioni