在 Power BI 中建立和使用 R 視覺效果

適用於:Power BI Desktop Power BI 服務

R 視覺效果目前只能在 Power BI Desktop建立,然後發佈至 Power BI 服務。 如需建立 R 視覺效果的詳細資訊,請參閱 使用 R 建立 Power BI 視覺效果。

在 Power BI 服務 中檢視 R 視覺效果

Power BI 服務 支援檢視及與使用 R 腳本建立的視覺效果互動。 使用 R 腳稿建立的視覺效果,通常稱為 R 視覺效果,可以使用 R 的豐富分析和視覺效果功能呈現進階數據成形和分析,例如預測。

注意

R 程式設計語言是統計人員、數據科學家和商業分析師最常使用的程式設計語言之一。 R 語言具有開放原始碼社群,提供超過 7,000 個附加元件套件,以及廣泛使用的 R 使用者群組。

R 視覺效果是在 Power BI Desktop 報表建立的,如下圖所示的報表。

Desktop report with two visuals.

在 Power BI Desktop建立報表之後,您可以將包含一或多個 R 視覺效果的報表發佈至 Power BI 服務。

在服務中,不支援所有 R 套件。 如需 Power BI 服務 目前支援的套件清單,請參閱本文結尾的支援套件。

您可以下載此 範例 Power BI Desktop 檔案 (.pbix 檔案),其中包含一些 R 視覺效果,以查看其運作方式,以及實驗。

在 Power BI Desktop建立的 R 視覺效果,然後發布至 Power BI 服務,通常會像 Power BI 服務 中的其他任何視覺效果一樣。 您可以與其他人互動、篩選、配量或與其共用。 不過,不同於其他視覺效果,R 視覺效果無法顯示工具提示,而且無法用來篩選其他視覺效果。

如下圖所示,Power BI 服務 中的 R 視覺效果基本上會顯示並像任何其他視覺效果一樣。 使用者不需要注意建立視覺效果的基礎 R 腳本。

Screenshot of the report page in the Power BI service.

R 文稿安全性

R 視覺效果是從 R 腳稿建立的,其中可能包含具有安全性或隱私權風險的程式代碼。

當文稿作者在自己的計算機上執行腳本時,這些風險主要存在於撰寫階段。

Power BI 服務 會套用沙盒技術來保護用戶和服務免於安全性風險。

沙箱方法會對 Power BI 服務 中執行的 R 腳本施加一些限制,例如存取因特網,或存取建立 R 視覺效果所需的其他資源。

R 文稿錯誤體驗

當 R 文稿發生錯誤時,R 視覺效果不會繪製,而且會顯示錯誤訊息。 如需錯誤的詳細數據,請從畫布上的 R 視覺效果錯誤選取 [查看詳細 數據],如下圖所示。

Screenshot showing an R visual error message.

另一個範例顯示當 R 腳本因 Azure 中遺失 R 套件而無法正常執行時,下圖顯示的錯誤訊息。

Screenshot showing a runtime error.

授權

R 視覺效果需要 Power BI Pro 或 進階版 Per User (PPU) 授權,才能在報表、重新整理、篩選和交叉篩選中轉譯。 如需 Power BI Pro 授權及其與免費授權有何不同的詳細資訊,請參閱 Power BI Pro 內容 - 何謂?

Power BI 的免費使用者只能在工作區 進階版 取與他們共用的磚。 如需 進階版 的詳細資訊,請參閱購買 Power BI Pro 以取得詳細資訊。

下表說明以授權為基礎的 R 視覺效果功能。

在Power BI Desktop 撰寫 R 視覺效果 使用 R 視覺效果建立 Power BI 服務 報表 在報表中檢視 R 視覺效果
來賓 (Power BI Embedded) 支援 不支援 僅支援 進階版/Azure 容量
非受控租使用者 (未驗證網域) 支援 不支援 不支援
具有免費授權的受控租使用者 支援 不支援 僅 進階版容量支援
具有 Pro 或 PPU 授權的受控租使用者 支援 支援 支援

R 套件概觀

R 套件是 R 函式、數據和已編譯程式代碼的集合,這些程式代碼會以定義完善的格式結合。 安裝 R 時,隨附一組標準套件,而其他套件則可供下載和安裝。 安裝之後,必須將 R 套件載入至要使用的工作階段。 免費 R 套件的主要來源是 CRAN,這是 完整的 R 封存網路

Power BI Desktop 可以無限制地使用任何類型的 R 套件。 您可以自行安裝 R 套件以用於 Power BI Desktop (例如使用 RStudio IDE)。

Power BI 服務 中的 R 視覺效果是由本文中找到的支援套件一節中找到的套件支援。 如果您在支援的套件清單中找不到您感興趣的套件,您可以要求套件的支援。 如需詳細資訊,請參閱 Power BI 服務 中的 R 套件,以取得如何要求支持的資訊。

R 套件的需求和限制

R 套件有幾個需求和限制:

  • Power BI 服務 支援具有免費和開放原始碼軟體授權的 R 套件,例如 GPL-2、GPL-3、MIT+等等。

  • Power BI 服務 支援在CRAN中發佈的套件。 服務不支援私人或自定義 R 套件。 我們鼓勵使用者在要求 Power BI 服務 中提供套件之前,先在CRAN上提供其私人套件。

  • 針對 Power BI Desktop,R 套件有兩種變化:

    • 針對 R 視覺效果,您可以安裝任何套件,包括自訂 R 套件。
    • 針對自定義 R 視覺效果,只有公用 CRAN 套件支援自動安裝套件。
  • 基於安全性和隱私權考慮,我們目前不支援在服務中透過萬維網提供用戶端伺服器查詢的 R 套件(例如 Rgoogle 地圖)。 這類嘗試會封鎖網路功能。 如需詳細資訊,請參閱 Power BI 服務 中的 R 套件,以取得支援和不支援的 R 套件清單。

  • 包含新 R 套件的核准程式具有相依性的樹狀結構;不支援在服務中安裝某些相依性。

支援的套件:

如需支援的 R 套件完整清單(以及不支援套件的簡短清單),請參閱下列文章:

考量與限制

  • R 視覺效果支援僅限於瞭解所支援 R 套件中所識別 套件。 目前不支援自定義套件。

  • R 視覺效果用於繪製的數據限製為 150,000 個數據列。 如果選取超過 150,000 個數據列,則只會使用前 150,000 個數據列,而且影像上會顯示訊息。 此外,輸入數據的限制為 250 MB。

  • 如果 R Visual 的輸入語意模型具有包含超過 32766 個字元之字串值的數據行,則會截斷該值。

  • 所有 R 視覺效果都會以每英吋 72 個點顯示。

  • 僅支援繪製至預設裝置。

  • 如果 R 視覺效果計算超過 60 秒,腳稿就會逾時並顯示錯誤。

  • R 視覺效果會在數據更新、篩選和醒目提示時重新整理。 不過,影像本身不是互動式的,而且不支援工具提示。

  • R 視覺效果會回應反白顯示其他視覺效果,但您無法選取 R 視覺效果中的元素,以交叉篩選其他視覺效果。

  • Time 數據類型目前不支援 R 視覺效果。 請改用日期/時間。

  • 使用 [發佈至 Web] 時,R 視覺效果不會顯示。

  • R 視覺效果不支援重新命名輸入數據行。 在文稿執行期間,數據行會以其原始名稱參照。

  • R 視覺效果不會列印報表。

  • Analysis Services 的 DirectQuery 模式不支援 R 視覺效果。

  • R 視覺效果能夠將文字標籤轉換成圖形元素。 在 Power BI 服務 中這樣做需要下列額外步驟:

    • 在 R 文稿開頭新增下列這一行:

      powerbi_rEnableShowText = 1

  • 中文、日文和韓文字型需要下列步驟,才能在 Power BI 服務 中正常運作:

    1. 安裝 R 套件 showtext 及其所有相依性。 您可以執行下列腳本來安裝它:

      install.packages("showtext")

    2. 在 R 文稿開頭新增下列這一行:

      powerbi_rEnableShowTextForCJKLanguages =  1