在 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 語言有一個開放原始碼社群，提供了逾 7000 種的附加元件套件，以及廣為大眾使用的 R 使用者群組。
R 視覺效果建立在 Power BI Desktop 報表中，如下圖顯示的報表。
一旦在 Power BI Desktop 中建立了報表，您就可以將包含一或多個 R 視覺效果的報表發行到 Power BI 服務。
此服務不支援所有的 R 套件。 如需 Power BI 服務目前支援的封裝清單，請在本文結尾參閱支援的封裝。
您可以下載這份範例 Power BI Desktop 檔案 (.pbix 檔案)，其中包含數個 R 視覺效果，以了解它們的運作方式並進行實驗。
在 Power BI Desktop 中建立，然後發佈到 Power BI 服務的 R 視覺效果的運作通常與 Power BI 服務中的任何其他視覺效果類似。 您可以針對它們與其他人進行互動、篩選、切片或共用。 不過，不同於其他視覺效果，R 視覺效果無法顯示工具提示，也無法用於篩選其他視覺效果。
如您可在下圖中看到的，Power BI 服務中的 R 視覺效果的運作在很大程度上與任何其他視覺效果類似。 使用者無需了解建立視覺效果的基礎 R 指令碼。
R 指令碼安全性
R 視覺效果是從 R 指令碼建立，可能包含具有安全性或隱私權風險的程式碼。
這些風險主要存在於指令碼作者在自己的電腦上執行指令碼時的撰寫階段。
Power BI 服務套用「沙箱」技術，保護使用者與服務免於安全性風險。
這種「沙箱」方法會對 Power BI 服務中執行的 R 指令碼施加某些限制，諸如存取網際網路，或存取建立 R 視覺效果時非必要的其他資源。
R 指令碼錯誤體驗
當 R 指令碼發生錯誤時，R 視覺效果不會進行繪製，而且會顯示錯誤訊息。 如需錯誤的詳細資料，請從畫布的 R 視覺效果錯誤中選取 [查看詳細資料]，如下圖所示。
下圖顯示另一例，當 R 指令碼因為 Azure 遺漏 R 封裝而無法正確執行時，會出現錯誤訊息。
授權
R 視覺效果需要 Power BI Pro 或 Premium Per User (PPU) 授權，才能在報表、重新整理、篩選和交叉篩選中呈現。 有關 Power BI Pro 授權及其與免費授權有何不同的詳細資訊，請參閱 Power BI Pro 內容 - 它是什麼？
Power BI 的免費使用者只能取用在 Premium 工作區中與他們共用的磚。 如需 Premium 的詳細資訊，請參閱購買 Power BI Pro 以取得詳細資訊。
下表依授權說明 R 視覺效果的功能。
| 在 Power BI Desktop 中撰寫 R 視覺效果 | 使用 R 視覺效果建立 Power BI 服務報表 | 在報表中檢視 R 視覺效果 | |
|---|---|---|---|
| 來賓 (Power BI Embedded) | 支援 | 不支援 | 僅在 Premium/Azure 容量中支援 |
| 非受控租用戶 (未驗證網域) | 支援 | 不支援 | 不支援 |
| 具有免費授權的受控租用戶 | 支援 | 不支援 | 僅在 Premium 容量中支援 |
| 具有 Pro 或 PPU 授權的受控租用戶 | 支援 | 支援 | 支援 |
R 套件概觀
R 套件是以定義完善的格式所合併的 R 函式、資料和已編譯程式碼集合。 R 在安裝時隨附一組標準套件，並且有其他套件可供下載和安裝。 安裝之後，必須將 R 套件載入要使用的工作階段。 可用 R 套件的主要來源是 CRAN，即 Comprehensive R Archive Network。
Power BI Desktop 可以使用任意類型的 R 套件，沒有任何限制。 您可以自行安裝 R 套件，以用於 Power BI Desktop (例如，使用 RStudio IDE)。
這篇文章中支援的套件一節列出的套件支援 Power BI 服務中的 R 視覺效果。 如果您在支援的套件清單中找不到感興趣的套件，則可以要求支援套件。 如需詳細資訊，請參閱 Power BI 服務中的 R 套件以獲取有關如何要求支援的資訊。
R 套件的需求和限制
有少數 R 套件的需求和限制：
Power BI 服務支援具有 GPL-2、GPL-3、MIT+ 等這類免費和開放原始碼軟體授權的 R 套件。
Power BI 服務支援 CRAN 中所發行的套件。 服務不支援私人或自訂 R 套件。 我們鼓勵使用者在要求 Power BI 服務中可用的套件之前先在 CRAN 上提供其私人套件。
Power BI Desktop 具有 R 套件的兩個變化：
- 針對 R 視覺效果，您可以安裝任何套件 (包含自訂 R 套件)。
- 針對自訂 R 視覺效果，公用 CRAN 套件僅支援自動安裝套件。
基於安全性和隱私權考量，我們目前不支援服務中透過全球資訊網提供用戶端-伺服器查詢的 R 套件 (例如 RgoogleMaps)。 會封鎖這類嘗試的網路功能。 如需詳細資訊，請參閱 Power BI 服務中的 R 套件，以取得支援和不支援的 R 套件的清單。
包含新 R 套件的核准程序具有樹狀結構的相依性；無法支援需要在服務中安裝的一些相依性。
支援的封裝：
如需支援的 R 套件長清單 (及不支援的套件短清單)，請參閱下列文章：
考量與限制
R 視覺效果支援僅限於了解支援哪些 R 套件一文中指出的套件 。 目前不支援自訂封裝。
R 視覺效果用於繪製的資料限制為 150,000 個資料列。 如果選取超過 150,000 個資料列，則只會使用前 150,000 個資料列，而且影像上會顯示訊息。 此外，輸入資料的限制為 250 MB。
如果 R 視覺效果的輸入語意模型有一個包含長度超過 32766 個字元的字串值的資料行，則該值會被截斷。
所有 R 視覺效果都會以每英吋 72 個點顯示。
僅支援繪圖至預設裝置。
如果 R 視覺效果計算超過 60 秒，指令碼就會逾時並顯示錯誤。
R 視覺效果會在資料更新、篩選及反白顯示時進行重新整理。 不過，影像本身不會互動，也不支援工具提示。
R 視覺效果會回應反白顯示的其他視覺效果，但您無法選取 R 視覺效果中的元素來交叉篩選其他視覺效果。
「時間」資料類型目前不支援 R 視覺效果。 改用日期/時間。
使用 [發佈至 Web] 時 R 視覺效果不會顯示。
R 視覺效果不支援重新命名輸入資料行。 在指令碼執行期間，資料行會透過其原始名稱來被參照。
R 視覺效果不會與報表列印一起列印。
Analysis Services 的 DirectQuery 模式不支援 R 視覺效果。
R 視覺效果能夠將文字標籤轉換成圖形元素。 在 Power BI 服務中這麼做需要執行下列額外的步驟：
在 R 指令碼的開頭新增下行：
powerbi_rEnableShowText = 1
中文、日文與韓文字型必須執行下列所有額外的步驟，才能在 Power BI 服務中正常運作：
安裝 R 套件 showtext 及其所有相依性。 您可以執行下列指令碼來安裝它：
install.packages("showtext")在 R 指令碼的開頭新增下行：
powerbi_rEnableShowTextForCJKLanguages = 1