R を使用した Power BI ビジュアルの作成Create Power BI visuals using R

Power BI Desktop では、R を使用してデータを視覚化できます。With Power BI Desktop, you can use R to visualize your data. R は、統計コンピューティングおよびグラフィックス用の言語であり環境です。R is a language and environment for statistical computing and graphics.

R をインストールするInstall R

既定では、Power BI Desktop には、R エンジンは含まれておらず、展開、インストールも行われません。By default, Power BI Desktop doesn't include, deploy, or install the R engine. Power BI Desktop で R スクリプトを実行するには、ご利用のローカル コンピューター上に R を別個にインストールする必要があります。To run R scripts in Power BI Desktop, you must separately install R on your local computer. R はさまざまな場所から無料でダウンロードし、インストールできます。たとえば、Revolution Open ダウンロード ページCRAN Repository があります。You can download and install R for free from many locations, including the Revolution Open download page, and the CRAN Repository. Power BI Desktop での R スクリプトの現在のリリースでは、インストール パスで Unicode 文字と空白 (空の文字) がサポートされています。The current release of R scripting in Power BI Desktop supports Unicode characters as well as spaces (empty characters) in the installation path.

Power BI Desktop で R ビジュアルを有効にするEnable R visuals in Power BI Desktop

R をインストールすると、Power BI Desktop によって自動的に有効にされます。After you've installed R, Power BI Desktop enables it automatically. Power BI Desktop によって R が正しい場所で有効にされていることを確認するには、次の手順を行います。To verify that Power BI Desktop has enabled R in the correct location, follow these steps:

  1. Power BI Desktop メニューで、 [ファイル] > [オプションと設定] > [オプション] の順に選択します。From the Power BI Desktop menu, select File > Options and settings > Options.

  2. [オプション] ページの左側にある [グローバル] で、 [R スクリプト] を選択します。On the left side of the Options page, under Global, select R scripting.

  3. [R スクリプトのオプション] で、ご利用のローカル R インストールが [検出された R ホーム ディレクトリ] に指定されていること、および Power BI Desktop で使用するローカル R インストールが正しく反映されていることを確認します。Under R script options, verify that your local R installation is specified in Detected R home directories and that it properly reflects the local R installation you want Power BI Desktop to use. 次のイメージで、R のローカル インストールへのパスは C:\Program Files\R Open\R-3.5.3\ です。In the following image, the path to the local installation of R is C:\Program Files\R Open\R-3.5.3\.

    [R スクリプトのオプション] ページ

ご利用の R のインストールを確認したら、R ビジュアルの作成をいつでも開始できます。After you've verified your R installation, you’re ready to begin creating R visuals.

Power BI Desktop で R ビジュアルを作成するCreate R visuals in Power BI Desktop

  1. [視覚エフェクト] ペインにある [R ビジュアル] アイコンを選択して、R ビジュアルを追加します。Select the R Visual icon in the Visualization pane to add an R visual.

    [視覚エフェクト] ペイン内の [R ビジュアル] アイコン

  2. 表示される [スクリプト ビジュアルを有効にする] ウィンドウで、 [有効] を選択します。In the Enable script visuals window that appears, select Enable.

    スクリプト ビジュアルを有効にする

    レポートに R ビジュアルを追加すると、Power BI Desktop によって以下の変更が行われます。When you add an R visual to a report, Power BI Desktop makes the following changes:

    • プレース ホルダーの R ビジュアル イメージが、レポート キャンバスに表示されます。A placeholder R visual image appears on the report canvas.

    • [R スクリプト エディター] が中央ペインの下部に表示されます。The R script editor appears along the bottom of the center pane.

    R スクリプト エディター

  3. [視覚エフェクト] ペインの [値] セクションで、他の Power BI Desktop ビジュアルの場合と同様に、ご自分の R スクリプトで使用する [フィールド] ペインからフィールドをドラッグします。In the Values section of the Visualization pane, drag fields from the Fields pane that you want to consume in your R script, just as you would with any other Power BI Desktop visual. あるいは、 [フィールド] ペインでフィールドを直接選択することもできます。Alternatively, you can also select the fields directly in the Fields pane.

    ご自分の R スクリプトで使用できるのは、 [値] セクションに追加したフィールドだけです。Only fields that you've added to the Values section are available to your R script. R スクリプト エディターで R スクリプトを処理しているときに、新しいフィールドを追加したり、 [値] セクションから不要なフィールドを削除したりできます。You can add new fields or remove unneeded fields from the Values section while working on your R script in the R script editor. Power BI Desktop では、追加または削除したフィールドが自動的に検出されます。Power BI Desktop automatically detects which fields you've added or removed.

    注意

    R ビジュアルの既定の集計タイプは、 [集計しない] です。The default aggregation type for R visuals is do not summarize.

  4. これで、選択したデータを使用して、プロットを作成できます。Now you can use the data you selected to create a plot:

    • フィールドを選択すると、R スクリプト エディター によって、エディター ペインの上部にあるグレー表示のセクション内の該当するフィールドに対してサポート R スクリプトのバインド コードが生成されます。As you select fields, the R script editor generates supporting R script binding code for those fields in the gray section along the top of the editor pane.
    • フィールドを削除すると、R スクリプト エディターによってそのフィールドのサポート コードが自動的に削除されます。If you remove a field, the R script editor automatically removes the supporting code for that field.

    次のイメージに示される例では、HP、gear、および drat の 3 つのフィールドが選択されました。In the example shown in the following image, three fields are selected: hp, gear, and drat. これらの選択の結果として、R スクリプト エディターでは、次のようにまとめられたバインド コードが生成されます。As a result of those selections, the R script editor generates binding code, which is summarized as follows:

    • データセットと呼ばれるデータフレームを作成します。これは、ユーザーが選択したさまざまなフィールドで構成されます。Create a dataframe called dataset, which is comprised of the different fields selected by the user.
    • 既定の集計は、 [集計しない] です。The default aggregation is: do not summarize.
    • テーブル ビジュアルと同様、フィールドはグループ化され、重複する行は一度だけ表示されます。Similar to table visuals, fields are grouped and duplicate rows appear only once.

    R スクリプト エディター コード

    ヒント

    自動グループ化を行いたくない場合や、重複を含めたすべての行を表示させたい場合があります。In certain cases, you may not want automatic grouping to occur, or you may want all rows to appear, including duplicates. その場合は、データセットにインデックス フィールドを追加します。これにより、すべての行が一意と見なされ、グループ化が防止されます。In that case, add an index field to your dataset, which causes all rows to be considered unique and prevents grouping.

    生成されたデータフレームには dataset という名前が付けられ、選択した列にはそれぞれの名前でアクセスします。The generated dataframe is named dataset, and you access selected columns by their respective names. たとえば、R スクリプトに dataset$gear を追加して、gear フィールドにアクセスします。For example, access the gear field by adding dataset$gear to your R script. スペースや特殊文字を使うフィールドでは、単一引用符を使用します。For fields with spaces or special characters, use single quotes.

  5. 選択したフィールドによってデータ フレームが自動的に生成されると、Power BI Desktop が R の既定デバイスにプロットする R スクリプトを記述する準備は完了です。With the dataframe automatically generated by the fields you selected, you’re ready to write an R script, which Power BI Desktop plots to the R default device. スクリプトが完了したら、 [R スクリプト エディター] タイトル バーの右側にある [スクリプトの実行] を選択します。After you've completed the script, select Run script on the right side of the R script editor title bar.

    [スクリプトの実行] を選択すると、Power BI Desktop によってプロットが識別され、キャンバス上に表現されます。When you select Run script, Power BI Desktop identifies the plot and presents it on the canvas. プロセスはローカルの R インストールで実行されるため、必要な R パッケージがインストールされていることをご確認ください。Because the process is executed on your local R installation, make sure the required R packages are installed.

    Power BI Desktop は、次のイベントのいずれかが発生したときにビジュアルを再度プロットします:Power BI Desktop replots the visual when any of the following events occur:

    • [R スクリプト エディター] タイトル バーから [スクリプトの実行] が選択された。You select Run script from the R script editor title bar.

    • データの更新、フィルター処理、または強調表示が行われたためにデータの変更が発生した。A data change occurs because of data refreshing, filtering, or highlighting.

      次のイメージは、相関プロット コードの例を示し、異なる種類の自動車の属性間の相関関係をプロットします。The following image shows an example of the correlation plot code, which plots the correlations between attributes of different types of cars.

      相関プロット コードの例

  6. 視覚エフェクトのより大きなビューを取得するには、 [R スクリプト エディター] を最小化します。To get a larger view of the visualizations, minimize the R script editor. Power BI Desktop での他のビジュアルのように、ドーナツ型のビジュアル (右側の丸いビジュアル) で特定のセクション (スポーツ カーなど) を選択することで、相関プロットをクロスフィルター処理できます。Like other visuals in Power BI Desktop, you can cross filter the correlation plot by selecting a specific section (such as sports cars) in the donut-shaped visual (the round visual on the right).

    より大きな視覚エフェクト ビュー

  7. R スクリプトを変更してビジュアルをカスタマイズしたり、パラメーターをプロット コマンドに追加して R の機能を活用したりできます。Modify the R script to customize the visual, and take advantage of the power of R by adding parameters to the plotting command.

    元のプロット コマンドは次のとおりです。The original plotting command is:

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

    プロット コマンドが次のようになるように、R スクリプトを変更します。Change the R script so that the plotting command is as follows:

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

    その結果、R ビジュアルでは、円がプロットされ、上半分のみが考慮に入れられ、クラスター相関属性のマトリックスの順序が変更されます。As a result, the R visual now plots circles, only considers the upper half, and reorders the matrix to cluster correlated attributes.

    R ビジュアルの円プロット

    R スクリプトを実行してエラーが発生すると、R ビジュアル プロットではなく、キャンバスにエラー メッセージが表示されます。When you execute an R script that results in an error, an error message displays on the canvas instead of the R visual plot. エラーの詳細については、R ビジュアル エラーから [詳細を確認する] を選択します。For details on the error, select See details from the R visual error.

    R ビジュアル エラー

R スクリプトのセキュリティR scripts security

R ビジュアルは R スクリプトから作成されますが、R スクリプトにはセキュリティやプライバシーのリスクがあるコードが含まれる場合があります。R visuals are created from R scripts, which might contain code with security or privacy risks. 初めて R ビジュアルを表示または R ビジュアルと対話しようとすると、ユーザーに対してセキュリティ警告メッセージが表示されます。When attempting to view or interact with an R visual for the first time, a user is presented with a security warning message. 作成者とソースを信頼する場合、または R スクリプトを確認して理解した場合にのみ、R ビジュアルを有効にします。Only enable R visuals if you trust the author and source, or after you review and understand the R script.

既知の制限事項Known limitations

Power BI Desktop での R ビジュアルには、以下の制限があります。R visuals in Power BI Desktop have the following limitations:

  • データ サイズ: プロット作成で R ビジュアルが使用するデータは、150,000 行に制限されています。Data sizes: Data used by an R visual for plotting is limited to 150,000 rows. 150,000 を超える行が選択されている場合は、上位の 150,000 の行のみが使用され、メッセージがイメージに表示されます。If more than 150,000 rows are selected, only the top 150,000 rows are used and a message is displayed on the image.

  • 解決方法: R ビジュアルはすべて 72 DPI で表示されます。Resolution: All R visuals are displayed at 72 DPI.

  • デバイスのプロット:既定のデバイスへのプロットのみがサポートされています。Plotting device: Only plotting to the default device is supported.

  • 計算時間: R ビジュアルの計算が 5 分を超えると、タイムアウト エラーが発生します。Calculation times: If an R visual calculation exceeds five minutes, it causes a time-out error.

  • リレーションシップ: 他の Power BI Desktop ビジュアルと同様、定義されたリレーションシップを持たない異なるテーブルからデータ フィールドが選択されている場合、エラーが発生します。Relationships: As with other Power BI Desktop visuals, if data fields from different tables with no defined relationship between them are selected, an error occurs.

  • 更新: R ビジュアルは、データ更新、フィルター処理、および強調表示の際に更新されます。Refreshes: R visuals are refreshed upon data updates, filtering, and highlighting. しかし、イメージ自体は対話型ではなく、クロス フィルター処理のソースにすることはできません。However, the image itself isn't interactive and can't be the source of cross-filtering.

  • 特長: 他のビジュアルを強調表示した場合、R ビジュアルからの応答はありますが、他の要素をクロス フィルター処理するために、R ビジュアル内の要素を選択することはできません。Highlights: R visuals respond if you highlight other visuals, but you can't select elements in the R visual to cross filter other elements.

  • ディスプレイ デバイス: R の既定のディスプレイ デバイスにプロットされるプロットだけが、キャンバス上に正しく表示されます。Display devices: Only plots that are plotted to the R default display device are displayed correctly on the canvas. 異なる R ディスプレイ デバイスを明示的に使用することは避けてください。Avoid explicitly using a different R display device.

  • 列の名前変更: R ビジュアルでは、入力列の名前変更はサポートされていません。Column renaming: R visuals do not support renaming input columns. 列は、スクリプトの実行時に元の名前で参照されます。Columns will be referred to by their original name during script execution.

  • RRO インストール: このリリースでは、32 ビット版の Power BI Desktop によって RRO インストールが自動的に識別されません。 [オプションと設定] > [オプション] > [R スクリプト] の順に選択して、R インストール ディレクトリへのパスを手動で入力する必要があります。RRO installations: In this release, the 32-bit version of Power BI Desktop doesn't automatically identify RRO installations; you must manually provide the path to the R installation directory in Options and settings > Options > R Scripting.

次の手順Next steps

Power BI での R の詳細については、次の記事を参照してください。For more information about R in Power BI, see the following articles: