使用 R 建立 Power BI 視覺效果

  • 發行項

適用於：Power BI Desktop Power BI 服務

透過 Power BI Desktop，您可以使用 R 將資料可視化。 R 是統計運算和圖形的語言和環境。

安裝 R

根據預設，Power BI Desktop 不包含、部署或安裝 R 引擎。 若要在 Power BI Desktop 中執行 R 文稿，您必須在本機電腦上安裝 R。 您可以從許多位置免費下載並安裝 R，包括來自 CRAN 存放 庫。 Power BI Desktop 中目前的 R 腳稿版本支援安裝路徑中的 Unicode 字元和空格（空白字元）。

在 Power BI Desktop 中啟用 R 視覺效果

安裝 R 之後，Power BI Desktop 會自動啟用它。 若要確認 Power BI Desktop 已在正確的位置啟用 R，請遵循下列步驟：

  1. 從 Power BI Desktop 功能表中，選取 [檔案>選項和設定>選項]。

  2. 在 [選項] 頁面左側的 [全域] 底下，選取 [R 腳本]。

  3. 在 [R 文稿選項] 底下，確認您的本機 R 安裝已在 [偵測到的 R 主目錄] 中指定，且它正確地反映您想要 Power BI Desktop 使用的本機 R 安裝。 在下圖中，R 本機安裝的路徑為 C：\Program Files\R Open\R-3.4.4\。

    Screenshot of the R script options page, highlighting Detected R home directories.

重要

Power BI Desktop 和 Power BI 服務 目前支援的 R 版本為 3.4.4 版。

驗證 R 安裝之後，即可開始建立 R 視覺效果。

在 Power BI Desktop 中建立 R 視覺效果

  1. 選取 [視覺效果] 窗格中的 [R 視覺效果] 圖示，以新增 R 視覺效果。

    Screenshot of the Visualization pane, highlighting the R Visual icon.

  2. 在出現的 [ 啟用腳本視覺效果] 視窗中，選取 [ 啟用]。

    Screenshot of the Enable script visuals dialog, highlighting Enable.

    當您將 R 視覺效果新增至報表時，Power BI Desktop 會進行下列變更：

    • 佔位元 R 視覺效果影像會出現在報表畫布上。

    • R 文稿編輯器會出現在中央窗格底部。

    Screenshot of the Power BI R script editor.

  3. 在 [視覺效果] 窗格的 [值] 區段中，從您想要在 R 腳本中取用的 [字段] 窗格中拖曳字段，就像使用任何其他 Power BI Desktop 視覺效果一樣。 或者，您也可以直接在 [欄位 ] 窗格中選取欄位。

    只有您新增至 [值 ] 區段的欄位可供 R 文稿使用。 您可以在 R 文稿編輯器中處理 R 文稿時，從 [值] 區段新增欄位或移除不需要的欄位。 Power BI Desktop 會自動偵測您已新增或移除的欄位。

    注意

    R 視覺效果 的預設匯總類型不摘要。

  4. 現在您可以使用您選取的數據來建立繪圖：

    • 當您選取欄位時 ，R 腳稿編輯器 會在編輯器窗格頂端的灰色區段中，為這些欄位產生支援的 R 文稿系結程式代碼。
    • 如果您移除欄位， R 文稿編輯器 會自動移除該欄位的支援程式代碼。

    在下圖所示的範例中，會選取三個字段：馬力、齒輪和drat。 由於這些選取專案，R 腳本編輯器會產生系結程式代碼，其摘要如下：

    • 建立名為 語意模型的數據框架，此模型是由用戶選取的不同欄位所組成。
    • 默認匯總為： 不要摘要。
    • 類似於資料表視覺效果，欄位會進行分組，且重複列只會出現一次。

    Screenshot of the R script editor, highlighting the script code.

    提示

    在某些情況下，您可能不想要自動分組，或者您可能想要顯示所有數據列，包括重複專案。 在此情況下，請將索引字段新增至您的語意模型，這會導致所有數據列視為唯一且防止分組。

    產生的數據框架命名為 語意模型，您可以依其各自的名稱存取選取的數據行。 例如，藉由新增dataset$gear至 R 腳本來存取gear欄位。 對於空格或特殊字元的欄位，請使用單引號。

  5. 當您選取的欄位自動產生資料框架時，您就可以開始撰寫 R 腳稿，Power BI Desktop 會繪製至 R 預設裝置。 完成文稿之後，請選取 R 腳稿編輯器標題列右側的 [執行腳本] 圖示。

    當您選取 [ 執行腳本 ] 圖示時，Power BI Desktop 會識別繪圖並將它呈現在畫布上。 由於程式是在本機 R 安裝上執行，因此請確定已安裝必要的 R 套件。

    當發生下列任何事件時，Power BI Desktop 會重繪視覺效果：

    • 您可以從 R 文稿編輯器標題列選取 [執行文稿] 圖示。

    • 因為數據重新整理、篩選或醒目提示，因此會發生數據變更。

      下圖顯示相互關聯繪圖程式代碼的範例，其繪製不同汽車類型屬性之間的相互關聯。

      Screenshot of the Correlation plot code example.

  6. 若要取得視覺效果的較大檢視，請取消選取 R 視覺效果或最小化 R 腳本編輯器。 如同 Power BI Desktop 中的其他視覺效果，您可以在右側環圈圖視覺效果中選取特定值，例如自動或手動，以交叉篩選相互關聯繪圖。

    Screenshot of the Correlation plot code example in the Larger visualization view.

  7. 修改 R 文稿以自訂視覺效果，並將參數新增至繪圖命令，以利用 R 的強大功能。

    原始繪圖命令為：

    corrplot(M, method = "color",  tl.cex=0.6, tl.srt = 45, tl.col = "black")

    變更 R 文稿，讓繪圖命令如下所示：

    corrplot(M, method = "circle", tl.cex=0.6, tl.srt = 45, tl.col = "black", type= "upper", order="hclust")

    因此，R 視覺效果現在會繪製圓形，只考慮上半部，並將矩陣重新排序為叢集相互關聯的屬性。

    Screenshot of the R visual circle plot example.

    當您執行會導致錯誤的 R 腳稿時，畫布上會顯示錯誤訊息，而不是 R 視覺效果繪圖。 如需錯誤的詳細數據，請從 R 視覺效果錯誤中選取 [查看詳細資料 ]。

    Screenshot of the error message displayed on the canvas.

R 文稿安全性

R 視覺效果是從 R 腳稿建立的，其中可能包含具有安全性或隱私權風險的程式代碼。 第一次嘗試檢視或與 R 視覺效果互動時，使用者會看到安全性警告訊息。 只有在信任作者和來源，或檢閱並瞭解 R 腳本之後，才啟用 R 視覺效果。

已知的限制

Power BI Desktop 中的 R 視覺效果有下列限制：

  • 數據大小：R 視覺效果用於繪製的數據限製為150,000個數據列。 如果選取超過 150,000 個數據列，則只會使用前 150,000 個數據列，而且影像上會顯示訊息。

  • 輸出大小：R 視覺效果的輸出大小限制為 2 MB。

  • 解析度：所有 R 視覺效果都會以 72 DPI 顯示。

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

  • 計算時間：如果 R 視覺效果計算超過五分鐘，則會導致逾時錯誤。

  • 關聯性：如同其他 Power BI Desktop 視覺效果，如果選取了不同數據表的數據欄位，且它們之間沒有定義關聯性，就會發生錯誤。

  • 重新整理：R 視覺效果會在數據更新、篩選和醒目提示時重新整理。 不過，影像本身不是互動式的，而且不能是交叉篩選的來源。

  • 醒目提示：如果您反白顯示其他視覺效果，R 視覺效果會回應，但您無法選取 R 視覺效果中的元素來交叉篩選其他元素。

  • 顯示裝置：畫布上只會正確顯示繪製至 R 預設顯示裝置的繪圖。 請避免明確地使用不同的 R 顯示裝置。

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

  • RRO 安裝：在此版本中，32 位版本的 Power BI Desktop 不會自動識別 RRO 安裝;您必須在 [選項] 和 [>選項>R 文稿] 設定中手動提供 R 安裝目錄的路徑。

相關內容

如需 Power BI 中 R 的詳細資訊，請參閱下列文章：