Bewährte Methoden für die Leistung von Power BI Embedded AnalyticsPower BI embedded analytics performance best practices

Dieser Artikel enthält Empfehlungen zum schnelleren Rendern von Berichten, Dashboards und Kacheln in Ihrer Anwendung.This article provides recommendations for faster rendering of reports, dashboards, and tiles in your application.

Hinweis

Beachten Sie, dass die Ladezeit in der Hauptsache von Elementen abhängt, die für den eigentlichen Bericht und die Daten relevant sind, einschließlich visueller Elemente, der Größe der Daten und der Komplexität der Abfragen und Measures.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 measures. Weitere Informationen finden Sie im Leitfaden für die Optimierung von Power BI.For more information, see the Power BI optimization guide.

Aktualisieren von Tools und SDK-PaketenUpdate tools and SDK packages

Halten Sie Tools und SDK-Pakete auf dem aktuellen Stand.Keep tools and SDK packages up-to-date.

  • Verwenden Sie immer die aktuellste Version von Power BI Desktop.Always use the latest version of Power BI Desktop.

  • Installieren Sie die aktuellste Version des Power BI-Client-SDKs.Install the latest version of the Power BI client SDK. Wir veröffentlichen fortlaufend weitere Verbesserungen, also sehen Sie von Zeit zu Zeit einmal nach.We continuously release additional enhancements, so make sure to follow up from time to time.

EinbettungsparameterEmbed parameters

Die powerbi.embed(element, config)-Methode erhält ein Element und eine Konfiguration. Der Konfigurationsparameter enthält Felder, die Einfluss auf die Leistung haben.The powerbi.embed(element, config) method receives an element and a config. The config parameter includes fields that have performance implications.

Einbettungs-URLEmbed URL

Vermeiden Sie es, die Einbettungs-URL selbst zu erstellen.Avoid generating the embed URL yourself. Achten Sie stattdessen darauf, die Einbettungs-URL durch einen Aufruf der Get reports-, Get dashboards- oder Get tiles-API abzurufen.Instead, make sure you get the Embed URL by calling Get reports, Get dashboards, or Get tiles API. Wir haben der URL einen neuen Parameter mit der Bezeichnung config hinzugefügt, der für Leistungsverbesserungen verwendet wird.We added a new parameter to the URL called config, which is used for performance improvements.

BerechtigungenPermissions

Erteilen Sie die Berechtigung Ansicht, wenn Sie keinen Bericht im Bearbeitungsmodus einbetten möchten.Provide View permissions if you're not intending to embed a report in edit mode. Auf diese Weise initialisiert der Einbettungscode keine Komponenten, die im Bearbeitungsmodus verwendet werden.This way, embedded code doesn't initialize components, which are used in edit mode.

Filter, Lesezeichen und SlicerFilters, bookmarks, and slicers

Normalerweise werden Visuals für Berichte mit zwischengespeicherten Daten gespeichert.Usually, report visuals are saved with cached data. Aufgrund der zwischengespeicherten Daten verbessert sich die gefühlte Leistung.The cached data is used to give perceived performance. Berichte können zwischengespeicherte Daten rendern, während die Abfragen ausgeführt werden.Reports render cached data while queries are executed. Wenn Filter, Textmarken oder Datenschnitte angegeben werden, sind zwischengespeicherte Daten nicht relevant, und die visuellen Elemente werden erst nach dem Abschluss der Abfrage der visuellen Elemente gerendert.If filters, bookmarks, or slicers are provided, cached data isn't relevant and the visuals are rendered only after the visual query has ended.

Beim Einbinden von Berichten mit den gleichen Filtern, Textmarken und Datenschnitten können Sie die Leistung verbessern, indem Sie den Bericht mit bereits angewendeten Filtern, Textmarken und Datenschnitten speichern.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. Dadurch wird der Bericht mit den zwischengespeicherten Daten gerendert, einschließlich der Filter, Textmarken und Datenschnitte.This renders the report with the cached data which includes the filters, bookmarks, and slicers.

Wechseln zwischen BerichtenSwitching between reports

Generieren Sie beim Einbetten mehrerer Berichte in den gleichen iFrame nicht für jeden Bericht einen neuen iFrame.When embedding multiple reports to the same iframe, don't generate a new iframe for each report. Verwenden Sie stattdessen powerbi.embed(element, config) mit einer anderen Konfiguration, um den neuen Bericht einzubetten.Instead, use powerbi.embed(element, config) with a different config to embed the new report.

Hinweis

Das Umschalten zwischen Berichten beim Szenario „Einbetten für Ihre Kunden“ (auch als Szenario „App besitzt Daten“ bekannt) erfordert die Verwendung eines Einbettungstokens mit Berechtigungen für alle Berichte und Datasets.Switching between reports when embedding for your customers (also known as an 'app owns data' scenario), requires the use of an embed token with permissions to all reports and datasets. Weitere Informationen finden Sie unter API zum Generieren von Token.For more information, see the generate token API.

Zwischenspeicherung von AbfragenQuery caching

Organisationen mit Power BI Premium-Funktionen oder Power BI Embedded-Funktionen können von der Zwischenspeicherung von Abfragen profitieren, um Berichte, die einem Dataset zugeordnet sind, zu beschleunigen.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.

Weitere Informationen zum Zwischenspeichern von Abfragen in Power BI.Learn more about query caching in Power BI.

Vorab LadenPreload

Verwenden Sie powerbi.preload(), um die Leistung für Endbenutzer zu verbessern.Use powerbi.preload() to improve the end-user performance. Die Methode powerbi.preload() lädt JavaScript, CSS-Dateien und andere Artefakte herunter, die später zum Einbetten eines Berichts verwendet werden.The method powerbi.preload() downloads Javascript, css files, and other artifacts, which are used later to embed a report.

Rufen Sie powerbi.preload() auf, wenn Sie den Bericht nicht sofort einbetten.Call powerbi.preload() if you're not embedding the report immediately. Wenn die eingebetteten Power BI-Inhalte beispielsweise nicht auf der Startseite angezeigt werden, verwenden Sie powerbi.preload(), um die Artefakte, die zum Einbetten der Inhalte verwendet werden, herunterzuladen und zwischenzuspeichern.For example, if the embedded Power BI content doesn't appear in the home page, use powerbi.preload() to download and cache the artifacts that are used for embedding the content.

Bootstrapping des iFramesBootstrapping the iframe

Hinweis

Power BI-Client SDK, Version 2.9, ist zum Bootstrappen des iFrames erforderlich.Power BI client SDK version 2.9 is required to bootstrap the iframe.

powerbi.bootstrap(element, config) ermöglicht Ihnen, mit dem Einbetten zu beginnen, bevor alle erforderlichen Parameter verfügbar sind.powerbi.bootstrap(element, config) allows you to start embedding before all required parameters are available. Die Bootstrap-API bereitet den iFrame vor und initialisiert ihn.The bootstrap API prepares and initializes the iframe. Wenn Sie die Bootstrap-API verwenden, ist trotzdem ein Aufruf von powerbi.embed(element, config) für das gleiche HTML-Element erforderlich.When using the bootstrap API, it's still required to call powerbi.embed(element, config) on the same HTML element.

Beispielsweise besteht einer der Anwendungsfälle für diese Funktion in der parallelen Ausführung des iFrame-Bootstraps und der Back-End-Aufrufe zum Einbetten.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.

Tipp

Verwenden Sie die Bootstrap-API, wenn es möglich ist, den iFrame zu generieren, bevor er für den Endbenutzer sichtbar ist.Use the bootstrap API when it's possible to generate the iframe before it's visible to the end user.

Weitere Informationen über iFrame-Bootstrap.Learn more about iframe bootstrap.

Messen der LeistungMeasure performance

LeistungsereignissePerformance events

Zum Messen der eingebetteten Leistung können Sie zwei Ereignisse verwenden:To measure embedded performance, you may use two events:

  1. Ereignis „Geladen“: Die Zeit bis zur Initialisierung des Berichts (das Power BI Logo verschwindet, wenn das Laden abgeschlossen ist).Loaded event: The time until the report is initialized (the Power BI logo will disappear when the load is finished).
  2. Ereignis „Gerendert“: Die Zeit bis zum vollständigen Rendern des Berichts unter Verwendung der tatsächlichen Daten.Rendered event: The time until the report is fully rendered, using the actual data. Das Gerendert-Ereignis wird bei jedem erneuten Rendern des Berichts ausgelöst (beispielsweise nach der Anwendung von Filtern).The rendered event is fired each time the report is re-rendered (for example, after applying filters). Achten Sie bei der Messung eines Berichts darauf, die Berechnungen auf der Grundlage des zuerst ausgelösten Ereignisses durchzuführen.To measure a report, make sure you do the calculations on the first raised event.

Zwischengespeicherte Daten werden gerendert, wenn sie verfügbar sind, es wird aber kein zusätzliches Ereignis generiert.Cached data is rendered when available but no additional event is generated.

Weitere Informationen zum Ereignishandling.Learn more about event handling.

LeistungsanalysePerformance Analyzer

Um die Leistung der Berichtselemente zu untersuchen, können Sie die Leistungsanalyse in Power BI Desktop verwenden.To examine the performance of the report elements, you might use the Performance Analyzer in Power BI Desktop. Mit der Leistungsanalyse können Sie Protokolle aufzeichnen und anzeigen, die die Leistung jedes Ihrer Berichtselemente messen.The Performance Analyzer will allow you to see and record logs that measure how each of your report elements performs.

Weitere Informationen zur LeistungsanalyseLearn more about Performance Analyzer.

Hinweis

Denken Sie immer daran, die Leistung eines eingebetteten Berichts mit der Leistung auf powerbi.com zu vergleichen.Always remember to compare the embedded report performance to the performance on powerbi.com. Dies kann Ihnen dabei helfen, den Ursprung von Leistungsproblemen zu verstehen.This might help you understand the origin of your performance issues

Nächste SchritteNext steps