Bedste praksis for ydeevnen i Power BI EmbeddedPower BI Embedded performance best practices

Denne artikel indeholder anbefalinger til hurtigere gengivelse af rapporter, dashboards og felter i dit program.This article provides recommendations for faster rendering of reports, dashboards, and tiles in your application.

Bemærk

Husk, at indlæsningstiden hovedsageligt afhænger af de elementer, der er relevante for selve rapporten og dataene, herunder visualiseringer, størrelsen af dataene og kompleksiteten af forespørgslerne og de beregnede mål.Remember that loading time mainly depends on elements relevant to the report and data itself, including visuals, the size of the data, and the complexity of the queries and calculated measures. Du kan finde flere oplysninger under Bedste praksis for ydeevnen i Power BI.For more information, see Power BI performance best practices.

Opdater værktøjer og SDK-pakkerUpdate tools and SDK packages

Hold værktøjer og SDK-pakker opdateret.Keep tools and SDK packages up-to-date.

Integrer parametreEmbed parameters

Metoden powerbi.embed(element, config) modtager et element og en konfiguration. Konfigurationsparameteren indeholder felter, der har konsekvenser for ydeevnen.The powerbi.embed(element, config) method receives an element and a config. The config parameter includes fields that have performance implications.

Integreret URL-adresseEmbed URL

Undgå at generere den integrerede URL-adresse selv.Avoid generating the embed URL yourself. Sørg i stedet for at få den integrerede URL-adresse ved at kalde API'en for Hent rapporter, Hent dashboards eller Hent felter.Instead, make sure you get the Embed URL by calling Get reports, Get dashboards, or Get tiles API. Vi har føjet en ny parameter til URL-adressen kaldet config , som bruges til forbedringer af ydeevnen.We added a new parameter to the URL called config, which is used for performance improvements.

TilladelserPermissions

Angiv tilladelsen Vis, hvis du ikke har til hensigt at integrere en rapport i Redigeringstilstand.Provide View permissions if you're not intending to embed a report in edit mode. På den måde initialiserer integreringskoden ikke komponenter, der bruges i Redigeringstilstand.This way, embedded code doesn't initialize components, which are used in edit mode.

Filtre, bogmærker og udsnitFilters, bookmarks, and slicers

Visualiseringer i rapporter gemmes ofte med cachelagrede data.Usually, report visuals are saved with cached data. De cachelagrede data bruges til at levere den opfattede ydeevne.The cached data is used to give perceived performance. Rapporter gengiver cachelagrede data, mens forespørgslerne udføres.Reports render cached data while queries are executed. Hvis filtre, bogmærker eller udsnit er angivet, er cachelagrede data ikke relevante, og visualiseringerne gengives først, når den visuelle forespørgsel er afsluttet.If filters, bookmarks, or slicers are provided, cached data isn't relevant and the visuals are rendered only after the visual query has ended.

Hvis du integrerer rapporter med de samme filtre, bogmærker og udsnit for at forbedre ydeevnen, skal du gemme rapporten med de filtre, bogmærker og udsnit, der allerede er anvendt.If you embed reports with the same filters, bookmarks, and slicers, to improve your performance, save the report with the filters, bookmarks, and slicers already applied. Dermed gengives rapporten med de cachelagrede data, hvilket omfatter de pågældende filtre, bogmærker og udsnit.This renders the report with the cached data which includes the filters, bookmarks, and slicers.

Skift mellem rapporterSwitching between reports

Når du integrerer flere rapporter i den samme iframe, skal du ikke generere en ny iframe for hver rapport.When embedding multiple reports to the same iframe, don't generate a new iframe for each report. Brug i stedet powerbi.embed(element, config) med en anden konfiguration for at integrere den nye rapport.Instead, use powerbi.embed(element, config) with a different config to embed the new report.

Bemærk

Det er muligvis ikke særligt effektivt at skifte mellem rapporter for et scenarie af typen "Appen ejer data", da det er nødvendigt at generere et nyt integreringstoken.Switching between reports for an 'App owns data' scenario might not be very effective due to the necessity of generating a new embed token.

Cachelagring af forespørgselQuery caching

Organisationer med Power BI Premium-kapacitet eller Power BI Embedded-kapacitet kan drage fordel af cachelagring af forespørgsler for at fremskynde rapporter, der er knyttet til et datasæt.Organizations with Power BI Premium capacity or Power BI Embedded capacity can take advantage of query caching to speed up reports associated with a dataset.

Få mere at vide om cachelagring af forespørgsler i Power BI.Learn more about query caching in Power BI.

ForudindlæsPreload

Brug powerbi.preload() til at forbedre ydeevnen for slutbrugeren.Use powerbi.preload() to improve the end-user performance. Metoden powerbi.preload() downloader javascript, css-filer og andre artefakter, der senere bruges til at integrere en rapport.The method powerbi.preload() downloads javascript, css files, and other artifacts, which are used later to embed a report.

Kald powerbi.preload(), hvis du ikke integrerer rapporten med det samme.Call powerbi.preload() if you're not embedding the report immediately. Hvis det Power BI-integrerede indhold f.eks. ikke vises på startsiden, skal du bruge powerbi.preload() til at downloade og cachelagre de artefakter, der bruges til at integrere indholdet.For example, if the Power BI embedded content doesn't appear in the home page, use powerbi.preload() to download and cache the artifacts that are used for embedding the content.

Bootstrap af iframeBootstrapping the iframe

Bemærk

Version 2.9 af klient-SDK'en til Power BI er påkrævet for at udføre bootstrap af denne iframe.Power BI client SDK version 2.9 is required to bootstrap the iframe.

powerbi.bootstrap(element, config) tillader, at du begynder at integrere, før alle påkrævede parametre er tilgængelige.powerbi.bootstrap(element, config) allows you to start embedding before all required parameters are available. Bootstrap-API'en forbereder og initialiserer din iframe.The bootstrap API prepares and initializes the iframe. Når du bruger bootstrap-API'en, skal du stadig kalde powerbi.embed(element, config) på det samme HTML-element.When using the bootstrap API, it's still required to call powerbi.embed(element, config) on the same HTML element.

En af denne funktions use cases er f.eks. at køre iframe bootstrap og back-end-kald til parallel integration.For example, one of the use cases for this feature, is to run the iframe bootstrap and the back-end calls for embedding, in parallel.

Tip

Brug bootstrap-API'en, når det er muligt at oprette en iframe, før den er synlig for slutbrugeren.Use the bootstrap API when it's possible to generate the iframe before it's visible to the end user.

Få mere at vide om iframe bootstrap.Learn more about iframe bootstrap.

Mål ydeevneMeasure performance

Hændelser i forbindelse med ydeevnePerformance events

Hvis du vil måle den integrerede ydeevne, kan du bruge to hændelser:To measure embedded performance, you may use two events:

  1. Indlæst hændelse: Tiden, indtil rapporten er initialiseret (Power BI-logoet forsvinder, når indlæsningen er fuldført).Loaded event: The time until the report is initialized (the Power BI logo will disappear when the load is finished).
  2. Gengivet hændelse: Tiden, indtil rapporten er fuldt gengivet med de faktiske data.Rendered event: The time until the report is fully rendered, using the actual data. Den gengivne hændelse vises, hver gang rapporten gengives igen (f.eks. efter der er anvendt filtre).The rendered event is fired each time the report is re-rendered (for example, after applying filters). Hvis du vil måle en rapport, skal du sørge for at foretage beregningerne for den første fremhævede hændelse.To measure a report, make sure you do the calculations on the first raised event.

Cachelagrede data gengives, når de er tilgængelige, men der genereres ingen yderligere hændelse.Cached data is rendered when available but no additional event is generated.

Få mere at vide om håndtering af hændelser.Learn more about event handling.

EffektivitetsanalysePerformance Analyzer

Hvis du vil undersøge ydeevnen af rapportelementerne, kan du bruge Effektivitetsanalyse i Power BI Desktop.To examine the performance of the report elements, you might use the Performance Analyzer in Power BI Desktop. Med Effektivitetsanalyse kan du se og registrere logge, der måler, hvordan hver af dine rapportelementer klarer sig.The Performance Analyzer will allow you to see and record logs that measure how each of your report elements performs.

Få mere at vide om Effektivitetsanalyse.Learn more about Performance Analyzer.

Bemærk

Husk altid at sammenligne ydeevnen af den integrerede rapport med ydeevnen på powerbi.com.Always remember to compare the embedded report performance to the performance on powerbi.com. Det kan muligvis hjælpe dig med at forstå, hvor dine problemer med ydeevnen opstodThis might help you understand the origin of your performance issues

Næste trinNext steps