共用方式為


Power BI 嵌入式分析中提升執行效能的最佳實務

本文提供建議,幫助你在應用程式中更快呈現報表、儀表板和磁貼。

備註

請記得載入時間主要取決於與報告和資料本身相關的元素,包括視覺化、資料大小,以及查詢和衡量的複雜度。 更多資訊請參閱 Power BI 優化指南

更新工具與 SDK 套件

保持工具和 SDK 套件保持最新。

初始化嵌入

預載

powerbi.preload() 來提升終端使用者的效能。 此方法 powerbi.preload() 會下載 JavaScript、css 檔案及其他 項目,後續用於嵌入報告。

如果您尚未立即嵌入報告,請撥打 powerbi.preload()。 例如,如果嵌入的 Power BI 內容不會出現在首頁,請使用 powerbi.preload() 來下載並快取用於嵌入內容的項目。

初始化 iFrame

備註

啟動 iFrame 需要 Power BI 用戶端 SDK 2.9 版。

powerbi.bootstrap(element, config) 允許你在所有必要參數尚未可用前就開始嵌入。 Bootstrap API 負責準備並初始化 iFrame。 使用 Bootstrap API 時,仍然需要在同一個 HTML 元素上呼叫 powerbi.embed(element, config)

例如,此功能的一個使用情境是同時執行 iFrame 導舉與後端的嵌入呼叫。

小提示

如果可能,請使用 bootstrap API ,在 iFrame 尚未被最終使用者看到前就產生。

在嵌入報表或其他 Power BI 項目時,請確保嵌入容器是 DOM 的一部分,且顯示 CSS 屬性不要設為 non ,否則可能會產生意外行為。 如果你想隱藏嵌入容器,可以考慮使用 visibility CSS 屬性。

嵌入參數

powerbi.embed(element, config) 方法接收一個元素和一個設定參數。 設定參數包含會影響效能的欄位。

內嵌網址

避免自己產生嵌入網址。 相反地,請透過呼叫 Get reportsGet dashboardsGet tiles API 來取得 Embed URL。 URL 中的 設定 參數用於效能提升。

權限

如果你不打算在編輯模式嵌入報告,請提供 檢視 權限。 這樣一來,就不用花時間初始化那些只在編輯模式下使用的元件。

篩選器、書籤與切片器

通常,報告視覺化會與快取資料一起儲存。 報告在查詢執行時渲染快取資料。 如果提供篩選器、書籤或切片軟體,則不會使用快取資料,視覺化資料僅在視覺查詢結束後才會呈現。

如果你在嵌入報表時已經套用相同的篩選器、書籤和切片器,請先儲存已套用這些項目的報表。 當你用這種方式儲存報告時,它會使用快取資料來渲染,此資料包含過濾器、書籤和分片器,這會提升效能。

在報告間切換

當將多個報告嵌入同一空間時,不要為每個報告產生新的 iFrame 。 相反地,將新報告嵌入同一個 iFrame 中,覆蓋先前的報告。 powerbi.embed(element, config)用不同的設定來嵌入新的報告。

備註

為客戶嵌入報告(也稱為「應用程式擁有資料」情境)需要使用包含所有報告與語意模型權限的嵌入令牌。 欲了解更多資訊,請參閱 產生代幣 API

多重視覺效果

當從同一報告嵌入多個視覺化時,不要為每個視覺化產生新的 iFrame 。 使用單一 iFrame 來渲染符合指定視覺效果報告

在將多個視覺化嵌入單一 iFrame 時,請考慮以下幾點:

  • Power BI 使用 iFrames 來嵌入報告。 有時候你可能想在視覺元素之間加入更多內容(例如,報告中不包含的文字或圖形)。 在這種情況下,你可能需要不同的 iFrame 來渲染不同的視覺效果。 為了達到最佳效能,請設法安排視覺配置以減少使用 iFrame。 為了減少 iFrame 數量,可以考慮使用 自訂版面配置功能

  • 如果你有來自不同報告或不同語意模型的視覺化,可以考慮加入語意模型並建立新報告,這樣你就能在同一個 iFrame 中包含所有視覺化。

  • 另一個選擇是,如果你有非連續的區域或來自多個語意模型的資料,可以建立一個 儀表板,並將視覺效果固定在上面。 這讓您能夠:

    • 將各個 圖塊 嵌入非連續的 iFrame 中。 儀表板圖塊比報表輕且載入更快。
    • 把整個儀表板嵌入一個 iFrame。 這讓你能在一個 iFrame 中看到不同報告或語意模型的視覺化,而不必建立新的報告。

    不過要注意,儀表板磚塊不是互動式的, 刷新頻率也 不如視覺圖塊。

查詢快取

擁有 Power BI Premium 或 Power BI Embedded 容量的組織,可以利用查詢快取來加速與語意模型相關的報告。

了解更多關於 Power BI 查詢快取的資訊。

績效衡量

表演活動

要衡量內嵌效能,你可以使用兩個事件:

  1. 載入事件:報表初始化的時間(載入完成後 Power BI 標誌消失)。
  2. 渲染事件:指使用實際資料將報告完全渲染所需的時間。 每次重新渲染報告時(例如套用過濾器後)都會觸發渲染事件。 為了評估報告,務必對第一個觸發事件進行計算。

當快取資料可用時會進行渲染,但不會觸發其他事件。

了解更多關於事件處理的資訊

效能分析器

要檢查報告元素的效能,你可以使用 Power BI Desktop 中的效能分析器。 效能分析器讓你能看到並記錄日誌,衡量每個報告元素的表現。

了解更多關於效能分析器的資訊

備註

務必記得將內嵌報告的效能與 powerbi.com 上的表現做比較。 這或許能幫助你了解表現問題的根源