Power BI サービスで R ビジュアルを作成するCreating R visuals in the Power BI service

Power BI サービスでは、R スクリプトで作成したビジュアルの表示と操作がサポートされています。The Power BI service supports viewing and interacting with visuals created with R scripts. R スクリプトで作成したビジュアルは一般的に R ビジュアルと呼ばれ、R の豊富な分析と視覚化の機能を使用した高度なデータ整形と予測などの分析に使用できます。Visuals created with R scripts, commonly called R visuals, can present advanced data shaping and analytics such as forecasting, using the rich analytics and visualization power of R.

注意

R プログラミング言語は、統計学者、データ科学者、ビジネス アナリストの間で最も広く使用されているプログラミング言語です。The R programming language is among the most widely used programming languages by statisticians, data scientists, and business analysts. R 言語には、7,000 を超えるアドオン パッケージを提供しているオープン ソース コミュニティや、広く利用されている R ユーザー グループがあります。The R language has an open source community that offers over 7,000 add-on packages, as well as widely used R User Groups. Power BI サービスに展開されている R のバージョンは Revolution R Open 3.2.2 です。The version of R deployed in the Power BI service is Revolution R Open 3.2.2.

次の図は、高度な分析に使用される Power BI ダッシュボードと R ビジュアルのコレクションを示しています。The following image shows a Power BI dashboard with a collection of R visuals used for advanced analytics.

R ビジュアルは、次の図に示すレポートのような Power BI Desktop レポート内に作成します。R visuals are created in a Power BI Desktop report, like the report shown in the following image.

Power BI Desktop でレポートを作成すると、1 つ以上の R ビジュアルを含むレポートを Power BI サービスに発行できます。Once the report is created in Power BI Desktop, you can publish the report containing one or more R visuals to the Power BI service. R ビジュアルは現在、Power BI Desktop でのみ作成でき、その後 Power BI サービスに発行できます。R visuals currently can only be created in Power BI Desktop, and then published to the Power BI service. R ビジュアルの作成の詳細については、Power BI Desktop での「R を使用した Power BI ビジュアルの作成 」を参照してください。For more information on creating R visuals, see Create Power BI visuals using R (Power BI Desktop).

サービスでサポートされていない R パッケージもあることに注意してください。Note that in the service not all of the R packages are supported. Power BI サービスで現在サポートされているパッケージを確認するには、この記事の最後にあるサポート対象パッケージの一覧を参照してください。See supported packages at the end of this article for the list of packages currently supported in the Power BI service.

Power BI Desktop サンプル ファイル (.pbix ファイル) をダウンロードして、いくつかの R ビジュアルの動作を確認し、さまざまな使い方を試すことができます。You can download this sample Power BI Desktop file (.pbix file) that contains a few R visuals to see how this works, and to experiment.

Power BI Desktop で作成し、Power BI サービスに発行した R ビジュアルは、ほとんどの部分で Power BI サービスの他のビジュアルと同様に動作し、対話的な操作、フィルター処理、スライス、ダッシュボードへの固定、他のユーザーとの共有ができます。R visuals that are created in Power BI Desktop, and then published to the Power BI service, for the most part behave like any other visual in the Power BI service; you can interact, filter, slice, and pin them to a dashboard, or share them with others. ダッシュボードとビジュアルの共有の詳細については、「同僚や他のユーザーとのダッシュボードの共有」を参照してください。For more information about sharing dashboards and visuals, see share a dashboard with colleagues and others. 他のビジュアルとの違いとして、R ビジュアルにはツール ヒントを表示できません。また、R ビジュアルを使って他のビジュアルをフィルター処理することはできません。One difference from other visuals is that R visuals cannot show tool tips and cannot be used to filter other visuals.

次の図に示すように、Power BI サービスの R ビジュアルは、ダッシュボードとレポートのどちらに表示されるかにかかわらず、ほとんど他のビジュアルと同様に表示され、動作します。ユーザーは基になる R スクリプトを意識する必要がありません。As you can see in the following image, R visuals in the Power BI service, either in dashboards or reports, largely appear and behave like any other visual, and users don't need to be aware of the underlying R script that created the visual.

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

R ビジュアルは R スクリプトから作成されますが、R スクリプトにはセキュリティやプライバシーのリスクとなる可能性のあるコードが含まれる場合があります。R visuals are created from R scripts, which could potentially contain code with security or privacy risks.

このようなリスクが存在するのは主に作成の段階です。作成の段階では、スクリプトの作成者が自身のコンピューターでスクリプトを実行します。These risks mainly exist in the authoring phase when the script author run the script on their own computer.

Power BI サービスには、ユーザーとサービスをセキュリティのリスクから保護するためにサンドボックス技術が適用されます。The Power BI service applies a sandbox technology to protect users and the service from security risks.

このサンドボックス アプローチでは、Power BI サービスで実行する R スクリプトに一定の制限が適用され、インターネットへのアクセスや、R ビジュアルの作成に不要な他のリソースへのアクセスなどが制限されます。This sandbox approach imposes some restrictions on the R scripts running in the Power BI service, such as accessing the Internet, or accessing to other resources that are not required to create the R visual.

R スクリプトのエラー エクスペリエンスR scripts error experience

R スクリプトでエラーが発生した場合、R ビジュアルはプロットされず、エラー メッセージが表示されます。When an R script encounters an error, the R visual is not plotted and an error message is displayed. エラーの詳細については、次の図に示すように、キャンバス上の R ビジュアル エラーから [詳細を確認する] を選択します。For details on the error, select See details from the R visual error on the canvas, as shown in the following image.

もう 1 つの例として、Azure に R パッケージがないために R スクリプトを正常に実行できなかった場合、次の図のようなエラー メッセージが表示されます。As another example, the following image shows the error message that appears when an R script failed to run properly due to a missing R package in Azure.

ライセンスLicensing

R ビジュアルのレポートでの表示、更新、フィルター、クロス フィルターには、Power BI Pro のライセンスが必要です。R visuals require a Power BI Pro license to render in reports, refresh, filter and cross-filter. Power BI Pro のライセンスの詳細および無料ライセンスとの違いについては、「Power BI Pro コンテンツとは」を参照してください。For more information about Power BI Pro licenses, and how they differ from free licenses, see Power BI Pro content - what is it?

Power BI 無料版のユーザーは、共有されたタイルのみを使用できます。Free users of Power BI can only consume tiles shared with them. 詳細については、「Power BI Pro を購入する」を参照してください。See purchasing Power BI Pro for more information.

次の表に、R ビジュアルの機能をライセンス別に示します。The following table describes R visuals capabilities based on licensing.

既知の制限事項Known Limitations

Power BI サービスの R ビジュアルには、一定の制限があります。R visuals in the Power BI service have a few limitations:

  • R ビジュアルのサポートは次のページに示すパッケージに限定されています。R visuals support is limited to the packages identified on the following page . 現在のところ、カスタム パッケージはサポートされていません。There currently is no support for custom packages.
  • データ サイズの制限 – プロット作成で R ビジュアルが使用するデータは、150,000 行に制限されています。Data size limitations – data used by the 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 ビジュアル計算で実行時間が 60 秒を超えると、エラーが発生します。Calculation time limitation – if an R visual calculation exceeds 60 seconds the script times out, resulting in an error.
  • R ビジュアルは、データ更新、フィルター処理、および強調表示の際に更新されます。R visuals are refreshed upon data updates, filtering, and highlighting. ただし、イメージ自体は対話に対応しておらず、ツール ヒントはサポートされていません。However, the image itself is not interactive and does not support tool tips.
  • R ビジュアルは他のビジュアルの強調表示に応答しますが、他の要素をクロス フィルター処理するために R ビジュアルの要素をクリックすることはできません。R visuals respond to highlighting other visuals, but you cannot click on elements in the R visual in order to cross filter other elements.
  • 現在のところ、R ビジュアルで Time データ型はサポートされていません。R visuals are currently not supported for the Time data type. 代わりに Date/Time を使用してください。Please use Date/Time instead.
  • [Web に公開] を使用するとき、R ビジュアルは表示されません。R Visuals do not display when using Publish to web.
  • 現在のところ、R ビジュアルはダッシュボードとレポートの印刷機能では印刷されません。R visuals currently do not print with dashboard and reports printing
  • 現在のところ、R ビジュアルは Analysis Services の DirectQuery モードでサポートされていません。R visuals are currently not supported in the DirectQuery mode of Analysis Services
  • 中国語、日本語、韓国語のフォントを Power BI サービスで正しく表示するには、次の追加手順をすべて実行する必要があります。Chinese, Japanese and Korean fonts require all of the additional following steps to work properly in the Power BI service:

    • 最初に、R パッケージ showtext とそのすべての依存関係をインストールします。First, install the R package showtext and all of its dependencies. このインストールは、次のスクリプトで実行できます。You can do this by running the following script:

      *install.packages("showtext")*
      
    • 次に、R スクリプトの先頭に次の行を追加します。Next, add the following line at the beginning of the R script:

      powerbi_rEnableShowTextForCJKLanguages =  1
      

R パッケージの概要Overview of R packages

R パッケージは、適切に定義された形式で結合された R 関数、データ、およびコンパイル済みコードのコレクションです。R packages are collections of R functions, data, and compiled code that are combined in a well-defined format. R のインストールには標準のパッケージ セットが付属しており、他のパッケージはダウンロードしてインストールできます。When R is installed, it comes with a standard set of packages, and other packages are available for download and installation. インストールした R パッケージを使うには、セッションに読み込む必要があります。Once installed, an R packages must be loaded into the session to be used. 無料の R パッケージの主要なソースは、CRAN (Comprehensive R Archive Network) です。The primary source of free R packages is CRAN, the Comprehensive R Archive Network.

Power BI Desktop では、どのような種類の R パッケージでも制限なく使うことができます。Power BI Desktop can use any type of R packages without limitation. Power BI Desktop で使う R パッケージをユーザー自身がインストールできます (たとえば、RStudio IDE を使って)。You can install R packages for use in Power BI Desktop on your own (using the RStudio IDE, for example).

Power BI サービスの R ビジュアルは、この記事の「サポートされるパッケージ」セクションで示されているパッケージによってサポートされます。R visuals in the Power BI service are supported by the packages found in the Supported Packages section found in this article. サポートされるパッケージの一覧に目的のパッケージがない場合は、パッケージのサポートを要求できます。If you don't find a package you're interested in among the supported packages list, you can request the support of the package. サポートを要求する方法については、「Power BI サービスの R パッケージ」を参照してください。See R packages in the Power BI service for information on how to request support.

R パッケージの要件と制限事項Requirements and Limitations of R packages

R パッケージにはいくつかの要件と制限があります。There are a handful of requirements and limitations for R packages:

  • Power BI サービスは、ほとんどの場合、無料の R パッケージと、GPL-2、GPL-3、MIT+ などのオープン ソース ソフトウェア ライセンスをサポートします。The Power BI service, for the most part, supports R packages with free and open-source software licenses such as GPL-2, GPL-3, MIT+, and so on.
  • Power BI サービスは、CRAN で公開されているパッケージをサポートします。The Power BI service supports packages published in CRAN. サービスは、プライベートまたはカスタムの R パッケージをサポートしません。The service does not support private or custom R packages. ユーザーには、Power BI サービスでパッケージを使用できるようにすることを要求する前に、プライベート パッケージを CRAN で使用できるようにすることをお勧めします。We encourage users to make their private packages available on CRAN prior to requesting the package be available in the Power BI service.
  • Power BI Desktop には、R パッケージの 2 つのバリエーションがあります。For Power BI Desktop has two variations for R packages:

    • R ビジュアルの場合は、カスタム R パッケージを含むすべてのパッケージをインストールできます。For R visuals, you can install any package, including custom R packages
    • カスタム R ビジュアルの場合は、パブリック CRAN パッケージのみがパッケージの自動インストールに対してサポートされます。For Custom R visuals, only public CRAN packages are supported for auto-installation of the packages
  • セキュリティおよびプライバシー上の理由から、World Wide Web 経由でクライアント サーバー クエリを提供する R パッケージ (RgoogleMaps など) は、現在はサービスでサポートされていません。For security and privacy reasons, we currently don't support R packages that provide client-server queries over the World-Wide Web (such as RgoogleMaps) in the service. このような試みに対してはネットワークがブロックされます。Networking is blocked for such attempts. サポート対象およびサポート非対象の R パッケージの一覧は、「Power BI サービスの R パッケージ」を参照してください。See R packages in the Power BI service for a list of supported and unsupported R packages.
  • 新しい R パッケージの組み込みに関する承認プロセスには、依存関係のツリーがあります。サービスにインストールするために必要な一部の依存関係はサポートできません。The approval process for including a new R package has a tree of dependencies; some dependencies required to be installed in the service cannot be supported.

サポートされているパッケージ:Supported Packages:

サポート対象の R パッケージの長い一覧 (およびサポート非対象のパッケージの短い一覧) は、次の記事を参照してください。For a long list of supported R packages (and the short list of unsupported packages) please see the following article: