共用方式為

Power BI 內嵌式分析中更快速效能的最佳做法

  • 發行項

本文提供能更快速轉譯應用程式中的報表、儀表板及磚的建議。

注意

請記住，載入時間主要取決於與報表相關聯的元素和資料本身，包括視覺效果、資料大小，以及查詢及量值的複雜度。 如需詳細資訊，請參閱 Power BI 最佳化指南。

更新工具和 SDK 套件

保持工具和 SDK 套件的最新狀態。

初始化內嵌

預先載入

使用 powerbi.preload() 來改善終端使用者效能。 powerbi.preload() 方法會下載 JavaScript、css 檔案和其他項目，其稍後會用來內嵌報表。

如果不想立即內嵌報表，請呼叫 powerbi.preload()。 例如，如果內嵌的 Power BI 內容未顯示在首頁，請使用 powerbi.preload() 下載並快取用於內嵌內容的項目。

啟動載入 iFrame

注意

Power BI 用戶端 SDK 2.9 版是啟動 iFrame 的必要項目。

powerbi.bootstrap(element, config) 可讓您在所有必要參數可用前開始內嵌。 啟動程序 API 會準備及初始化 iFrame。 使用啟動程序 API 時，仍需在相同的 HTML 元素上呼叫 powerbi.embed(element, config)。

舉例來說，此功能的其中一個使用案例，就是同時執行 iFrame 啟動程序和後端呼叫來進行內嵌。

提示

盡可能使用啟動程序 API 以在 iFrame 對終端使用者可見之前產生它。

​在內嵌報表或其他 Power BI 項目時，請確定內嵌容器是 DOM 的一部分，而且顯示 CSS 屬性未設定為 none，因為這可能會造成非預期的行為。 如果您想要隱藏內嵌容器，請考慮使用 CSS 屬性 visibility。

內嵌參數

powerbi.embed(element, config) 方法會接收元素和 config 參數。 config 參數包括可能影響效能的欄位。

內嵌 URL

請勿自行產生內嵌 URL。 反之，請務必透過呼叫取得報表、取得儀表板，或取得磚 API 來取得內嵌 URL。 URL 中的 config 參數用於效能改善。

權限

如果您不想在編輯模式中內嵌報表，請提供檢視權限。 這樣，就不必花費時間來初始化僅在編輯模式下使用的元件。

篩選條件、書籤和交叉分析篩選器

通常，報表視覺效果會與快取資料一起儲存。 報表會在執行查詢時轉譯快取的資料。 若提供了篩選條件、書籤或交叉分析篩選器，則不會使用快取資料，且視覺效果只會在視覺效果查詢結束後轉譯。

若您使用相同的篩選條件、書籤和交叉分析篩選器來內嵌報表，請儲存已套用篩選條件、書籤和交叉分析篩選器的報表。 當您以這種方式儲存報表時，它會使用包含篩選條件、書籤和交叉分析篩選器的快取資料來進行轉譯，以提高效能。

在報表之間切換

將多個報表內嵌至相同的空間時，請勿為每個報表產生新的 iFrame。 請改為將新報表內嵌在相同的 iFrame 中以覆寫先前的報表。 使用具有不同設定的 powerbi.embed(element, config) 來內嵌新報表。

注意

使用「為您的客戶內嵌」(也稱為「應用程式擁有資料」案例) 來內嵌報表，需要使用具有所有報表和語意模型權限的內嵌權杖。 如需詳細資訊，請參閱產生權杖 API \(英文\)。

多個視覺效果

內嵌同一個報表中的多個視覺效果時，請勿為每個視覺效果產生新的 iFrame。 使用單一 iFrame 以透過指定的視覺效果來轉譯報表。

將多個視覺效果內嵌至單一 iFrame 時，請考慮以下幾點：

  • Power BI 會使用 iFrame 來內嵌報表。 有時候，您可能會想要在視覺效果之間新增更多的內容 (例如，不是來自報表的文字或圖形)。 在此情況下，您可能需要不同的 iFrame 來轉譯不同的視覺效果。 為了獲得最佳效能，請嘗試並排列視覺效果，以便使用盡可能最少的 iFrame。 若要減少 iFrame 的數目，請考慮使用自訂版面配置功能。

  • 如果您有來自不同報表或不同語意模型的視覺效果，請考慮加入語意模型並建立新報表，以便可以將所有視覺效果包含在同一個 iFrame 中。

  • 如果您有不連續的區域或來自多個語意模型的資料，另一個替代方法是建立一個儀表板並將視覺效果釘選到其中。 這可讓您：

    • 將各個磚內嵌到不連續的 iFrame 中。 儀表板磚比報表更輕且載入速度更快。
    • 將整個儀表板內嵌到一個 iFrame 中。 這可讓您在一個 iFrame 中擁有來自不同報表或語意模型的視覺效果，而無需建立新的報表。

    不過，請記住，儀表板磚不是互動式的，並不會以與視覺效果相同的頻率來重新整理。

查詢快取

具備 Power BI Premium 容量或 Power BI Embedded 容量的組織，可以利用查詢快取，加速與語意模型建立關聯的報表。

深入了解 Power BI 中的查詢快取。

測量效能

效能事件

若要測量內嵌效能，您可以使用兩個事件：

  1. 載入事件：直到報表初始化完成前的時間 (Power BI 標誌會在載入完成時消失)。
  2. 轉譯的事件：直到報表使用實際資料完全轉譯前的時間。 轉譯事件會在每次報表重新轉譯時發出 (例如在套用篩選條件後)。 若要測量報表，請務必在第一個引發的事件中執行計算。

快取資料會在可用且並未產生其他事件時轉譯。

深入了解事件處理。

效能分析器

若要檢查報表元素的效能，您可以使用 Power BI Desktop 中的效能分析器。 效能分析器可讓您查看和記錄測量每個報表元素執行情況的記錄。

深入了解效能分析器。

注意

請務必記得將內嵌報表效能與 powerbi.com 上的效能進行比較。 這有助您了解效能問題的來源

相關內容