Procedure consigliate per le prestazioni di Power BI EmbeddedPower BI Embedded performance best practices

Questa pagina è stata utile?

Questo articolo contiene suggerimenti su come velocizzare il rendering di report, dashboard e riquadri nell'applicazioneThis article provides recommendations for faster rendering of reports, dashboards, and tiles in your application

Parametri di incorporamentoEmbed parameters

Il metodo Powerbi.embed() riceve alcuni parametri per incorporare un report, un dashboard o un riquadro.Powerbi.embed() method receives few parameters to embed a report, a dashboard, or a tile. Questi parametri presentano implicazioni per le prestazioni.These parameters have performance implications.

URL di incorporamentoEmbed URL

Evitare di generare manualmente l'URL di incorporamento.Avoid generating the embed URL yourself. Assicurarsi invece di ricevere l'URL di chiamando l'API Get Reports, Get Dashboards o Get Tiles.Instead, make sure you get the Embed URL by calling the Get reports, the Get dashboards, or the Get tiles API. È stato aggiunto all'URL un nuovo parametro denominato config , usato per migliorare le prestazioni.We added a new parameter to the URL called config, used for performance improvements.

AutorizzazioniPermissions

Concedere le autorizzazioni per la visualizzazione se non si prevede di incorporare un report in modalità di modifica.Provide View permissions if you're not intending to embed a report in Edit mode. In questo modo il codice di incorporamento non inizializza i componenti usati per la modalità di modifica.This way embed code doesn't initialize components, which are used for Edit mode.

Filtri, segnalibri e filtri dei datiFilters, bookmarks, and slicers

In genere, gli oggetti visivi del report vengono salvati con i dati memorizzati nella cache.Usually, report visuals are saved with cached data. I dati memorizzati nella cache vengano usati per offrire le prestazioni percepite.The cached data is used to give perceived performance. I report eseguono il rendering dei dati memorizzati nella cache durante l'esecuzione delle query.Reports render cached data while queries are executed. Se sono disponibili filtri, segnalibri o filtri dei dati, i dati memorizzati nella cache non sono rilevanti.If filters, bookmarks or slicers are provided, cached data isn't relevant. Quindi, gli oggetti visivi vengono visualizzati solo dopo aver eseguito la query visiva.Then, the visuals are rendered only after running the visual query.

Se si incorporano report con gli stessi filtri, per evitare di passare un elenco di filtri nella configurazione del carico, salvare il report con i filtri già applicati.If you embed reports with the same filters, to avoid passing a list of filters in the load configuration, save the report with filters already applied.

PrecaricamentoPreload

Usare l'API JavaScript di precaricamento per migliorare le prestazioni per gli utenti finali.Use the preload JavaScript API to improve the end-user performance. Powerbi.preload() scarica JavaScript, file CSS e altri artefatti, che vengono usati successivamente per l'incorporamento in un report.Powerbi.preload() downloads javascript, css files, and other artifacts, which is used later to embed in a report.

Chiamare il precaricamento se non si incorpora il report immediatamente.Call preload if you're not embedding the report immediately. Ad esempio, se si incorpora un report facendo clic su un pulsante, è preferibile chiamare il precaricamento quando viene caricata la pagina precedente.For example, if you embed a report on a button click, it’s better to call preload when the previous page loads. Quando l'utente dell'applicazione fa clic sul pulsante, il rendering sarà più veloce.Then when the application user clicks the button, the rendering is faster.

Misurare le prestazioniMeasure performance

Per misurare le prestazioni, usare:To measure performance, use:

  1. Loaded (Caricato): tempo trascorso fino all'inizializzazione del report (l'utente non vede la rotellina).Loaded: time until report is initialized (user sees no spinny).
  2. Rendered (Con rendering): tempo trascorso finché viene eseguito il rendering completo del report usando dati effettivi.Rendered: time until fully report is rendered using actual data. L'evento con rendering viene generato ogni volta che il report viene di nuovo sottoposto a rendering, vale a dire, dopo l'applicazione di filtri.The rendered event is fired each time the report is re-rendered (that is, after applying filters). Per misurare prima un report, assicurarsi di eseguire i calcoli nel primo evento generato.To measure a report first, make sure you do the calculations in the first raised event.

I dati memorizzati nella cache vengono sottoposti a rendering quando sono disponibili, ma non esiste ancora un evento per questi dati.Cached data is rendered when available, but we don’t have an event for this data yet.

Aggiornare strumenti e pacchetti SDKUpdate tools and SDK packages

Mantenere gli strumenti e i pacchetti SDK aggiornati.Keep tools and SDK packages up-to-date.

  • Usare sempre la versione più recente di Power BI Desktop.Always use the latest version of Power BI Desktop.

  • Installare la versione più recente dell'SDK del client Power BI.Install the latest version of the Power BI client SDK. Vengono continuamente rilasciati altri miglioramenti, quindi è opportuno verificarne regolarmente la disponibilità.We continue to release more enhancements, so make sure to follow up from time to time.

  • Pacchetti da installare:Packages to install:

    • Pacchetto Npm: powerbi-clientNpm package: powerbi-client
    • Pacchetto NuGet: Microsoft.PowerBI.JavaScriptNuGet package: Microsoft.PowerBI.JavaScript

Nota

Tenere presente che il tempo di caricamento dipende principalmente dagli elementi rilevanti per il report e gli stessi dati,Remember that loading time mainly depends on elements relevant to the report and data itself. ad esempio il numero di oggetti visivi, le dimensioni dei dati e la complessità delle query e delle misure calcolate.Such as number of visuals, size of data and complexity of the queries and calculated measures. Attenersi alle procedure consigliate per ottimizzare il tempo di caricamento dei report.Please follow best practices to improve the report’s loading time.

Passaggi successiviNext steps