Performans açısından en iyi Power BI Embedded yöntemleriPower BI Embedded performance best practices

Bu makalede uygulamanızdaki raporları, panoları ve kutucukları daha hızlı işlemeye yönelik öneriler sağlanır.This article provides recommendations for faster rendering of reports, dashboards, and tiles in your application.

Not

Yükleme süresinin temel olarak raporla ilgili öğelere ve görsellerin hem verilerin boyutuna hem de sorgu ve ölçülere ilişkin karmaşıklığa bağlı olduğunu unutmayın.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. Daha fazla bilgi için bkz. Power BI iyileştirme kılavuzu.For more information, see the Power BI optimization guide.

Araçları ve SDK paketlerini güncelleştirmeUpdate tools and SDK packages

Araçların ve SDK paketlerinin güncel kalmasını sağlayın.Keep tools and SDK packages up-to-date.

  • Her zaman Power BI Desktop'ın en son sürümünü kullanın.Always use the latest version of Power BI Desktop.

  • Power BI istemci SDK'sının en son sürümünü yükleyin.Install the latest version of the Power BI client SDK. Sürekli başka iyileştirmeler yayınlama devam ediyoruz, bu nedenle zaman zaman takip etmeyi unutmayın.We continuously release additional enhancements, so make sure to follow up from time to time.

Ekleme parametreleriEmbed parameters

powerbi.embed(element, config) yöntemi bir öğe ve bir yapılandırma alır. Yapılandırma parametresi, performans etkilerine sahip alanlar içerir.The powerbi.embed(element, config) method receives an element and a config. The config parameter includes fields that have performance implications.

Ekleme URL'siEmbed URL

Ekleme URL'sini kendiniz oluşturmaktan kaçının.Avoid generating the embed URL yourself. Bunun yerine, Get reports, Get dashboards veya Get tiles API'sini çağırarak Ekleme URL'sini aldığınızdan emin olun.Instead, make sure you get the Embed URL by calling Get reports, Get dashboards, or Get tiles API. Performans geliştirmeleri için kullanmak üzere URL'ye config adlı yeni bir parametre ekledik.We added a new parameter to the URL called config, which is used for performance improvements.

İzinlerPermissions

Raporu Düzenleme modunda eklemeyi düşünmüyorsanız, Görüntüleme izinleri sağlayın.Provide View permissions if you're not intending to embed a report in edit mode. Bu şekilde, ekleme kodu düzenleme modunda kullanılan bileşenleri başlatmaz.This way, embedded code doesn't initialize components, which are used in edit mode.

Filtreler, yer işaretleri ve dilimleyicilerFilters, bookmarks, and slicers

Genellikle, rapor görselleri önbelleğe alınmış verilerle birlikte kaydedilir.Usually, report visuals are saved with cached data. Önbelleğe alınmış veriler, algılanan performansı vermek için kullanılır.The cached data is used to give perceived performance. Sorgular yürütülürken raporlar önbelleğe alınmış verileri işler.Reports render cached data while queries are executed. Filtreler, yer işaretleri veya dilimleyiciler sağlanmışsa, önbelleğe alınmış veriler ilgili değildir ve görseller yalnızca görsel sorgusu sona erdikten sonra işlenir.If filters, bookmarks, or slicers are provided, cached data isn't relevant and the visuals are rendered only after the visual query has ended.

Aynı filtre, yer işareti ve dilimleyicilerle rapor eklerseniz, performansı artırmak için raporu daha önce uygulanan filtre, yer işareti ve dilimleyicilerle kaydedin.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. Bunun yapılması, raporu filtreler, yer işaretleri ve dilimleyicileri içeren önbelleğe alınmış verilerle birlikte oluşturur.This renders the report with the cached data which includes the filters, bookmarks, and slicers.

Raporlar arasında geçiş yapmaSwitching between reports

Aynı iframe’e birden fazla rapor eklerken her rapor için yeni bir iframe oluşturmayın.When embedding multiple reports to the same iframe, don't generate a new iframe for each report. Bunun yerine, yeni raporu eklemek için farklı bir yapılandırmaya sahip olan powerbi.embed(element, config) kullanın.Instead, use powerbi.embed(element, config) with a different config to embed the new report.

Not

Müşterileriniz için içerik eklerken raporlar arasında geçiş yapma işlemi (“uygulama verilere sahiptir” senaryosu olarak da bilinir), tüm raporlara ve veri kümelerine yönelik izinler içeren ekli bir belirtecin kullanılmasını gerektirir.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. Daha fazla bilgi için bkz. belirteç API’si oluşturma.For more information, see the generate token API.

Sorgu önbelleğe almaQuery caching

Power BI Premium kapasitesi veya Power BI Embedded kapasitesi ile kuruluşlar bir veri kümesiyle ilişkili raporları hızlandırmak için sorguları önbelleğe alma özelliğinden yararlanabilir.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.

Power BI’da sorgu önbelleğe alma hakkında daha fazla bilgi edinin.Learn more about query caching in Power BI.

Önceden yüklemePreload

Son kullanıcı performansını iyileştirmek için powerbi.preload() kullanın.Use powerbi.preload() to improve the end-user performance. powerbi.preload() yöntemi, daha sonra raporu ekleme amacıyla kullanılacak JavaScript kodlarını, css dosyalarını ve diğer yapıtları indirir.The method powerbi.preload() downloads Javascript, css files, and other artifacts, which are used later to embed a report.

Raporu hemen eklemiyorsanız powerbi.preload() çağrısı yapın.Call powerbi.preload() if you're not embedding the report immediately. Örneğin, Power BI Embedded içeriği giriş sayfasında görünmezse, içeriği eklemek için kullanılan yapıtları indirmek ve önbelleğe almak için powerbi.preload() kullanın.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.

Iframe'i önyüklemeBootstrapping the iframe

Not

Iframe’i önyüklemek için Power BI istemci SDK’sı sürüm 2.9 gereklidir.Power BI client SDK version 2.9 is required to bootstrap the iframe.

powerbi.bootstrap(element, config), gerekli tüm parametreler kullanılabilir olmadan önce eklemeye başlamanızı sağlar.powerbi.bootstrap(element, config) allows you to start embedding before all required parameters are available. Önyükleme API’si, iframe’i hazırlar ve başlatır.The bootstrap API prepares and initializes the iframe. Önyükleme API’sini kullanırken, aynı HTML öğesinde powerbi.embed(element, config) çağrısı yapılması yine de gereklidir.When using the bootstrap API, it's still required to call powerbi.embed(element, config) on the same HTML element.

Örneğin, bu özelliğin kullanım örneklerinden birinde, iframe önyüklemesi ve ekleme için arka uç çağrıları paralel olarak çalıştırılır.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.

İpucu

Iframe’i son kullanıcıya görüntülenmeden önce oluşturmanızın mümkün olduğu durumlarda önyükleme API’sini kullanın.Use the bootstrap API when it's possible to generate the iframe before it's visible to the end user.

Iframe önyüklemesi hakkında daha fazla bilgi edinin.Learn more about iframe bootstrap.

Performansı ölçmeMeasure performance

Performans olaylarıPerformance events

Gömülü performansı ölçmek için iki olayı kullanabilirsiniz:To measure embedded performance, you may use two events:

  1. Yüklendi olayı: Rapor başlatılmadan önce geçen süre (yükleme tamamlandığında Power BI logosu kaybolur).Loaded event: The time until the report is initialized (the Power BI logo will disappear when the load is finished).
  2. İşlendi olayı: Rapor gerçek veriler kullanılarak tamamen işlenene kadar geçen süre.Rendered event: The time until the report is fully rendered, using the actual data. Rapor yeniden her işlendiğinde (örneğin, filtreler uygulandıktan sonra), İşlendi olayı tetiklenir.The rendered event is fired each time the report is re-rendered (for example, after applying filters). Raporu ölçmek için, hesaplamaları ilk tetiklenen olayda yaptığınızdan emin olun.To measure a report, make sure you do the calculations on the first raised event.

Önbelleğe alınmış veriler kullanılabilir olduğunda işlenir ancak başka bir olay oluşturulmaz.Cached data is rendered when available but no additional event is generated.

Olay işleme hakkında daha fazla bilgi edinin.Learn more about event handling.

Performans AnaliziPerformance Analyzer

Rapor öğelerinin performansını incelemek için Power BI Desktop'ta Performans Analizi'ni kullanabilirsiniz.To examine the performance of the report elements, you might use the Performance Analyzer in Power BI Desktop. Performans Analizi, rapor öğelerinizin her birinin nasıl performans gösterdiğini ölçen günlükleri görüp kaydetmenize izin verir.The Performance Analyzer will allow you to see and record logs that measure how each of your report elements performs.

Performans Analizi hakkında daha fazla bilgi edinin.Learn more about Performance Analyzer.

Not

Her zaman ekli rapor performansını powerbi.com üzerindeki performansla karşılaştırmayı unutmayın.Always remember to compare the embedded report performance to the performance on powerbi.com. Bunun yapılması, performans sorunlarınızın kaynağını anlamanıza yardımcı olurThis might help you understand the origin of your performance issues

Sonraki adımlarNext steps