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 언어는 널리 사용되는 R 사용자 그룹과 함께 7000개 이상의 추가 패키지를 제공하는 오픈 소스 커뮤니티를 보유합니다.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.

다음 그림은 고급 분석에 사용되는 R 시각적 개체의 컬렉션과 함께 Power BI 대시보드를 보여 줍니다.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에서 보고서가 만들어지면 하나 이상의 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 시각적 개체 만들기에 대한 자세한 내용은 R(Power BI Desktop)을 사용하여 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.

몇 가지 R 시각적 개체를 포함하는 이 [샘플 Power BI Desktop 파일](http://download.microsoft.com/download/D/9/A/D9A65269-D1FC-49F8-8EC3-1217E3A4390F/RVisual_correlation_plot_sample SL.pbix)(.pbix 파일)을 다운로드하여 작동 방법을 확인하고 실험할 수 있습니다.You can download this [sample Power BI Desktop file](http://download.microsoft.com/download/D/9/A/D9A65269-D1FC-49F8-8EC3-1217E3A4390F/RVisual_correlation_plot_sample SL.pbix) (.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 시각적 개체는 도구 설명을 표시할 수 없고 다른 시각적 개체 필터링에 사용될 수 없다는 것입니다.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 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.

또 다른 예로 다음 그림은 R 스크립트가 Azure에서 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 시각적 개체는 현재 지원되지 않습니다.R visuals are currently not supported for the Time data type. 날짜/시간을 대신 사용하세요.Please use Date/Time instead.
  • 웹에 게시를 사용하는 경우 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. 예를 들어, RStudio IDE를 사용하여 Power BI Desktop에서 사용할 R 패키지를 직접 설치할 수 있습니다.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 서비스에서는 GPL-2, GPL-3, MIT+ 등과 같은 무료 오픈 소스 소프트웨어 라이선스를 포함한 R 패키지를 지원합니다.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 패키지에 대한 두 가지 변형이 있습니다.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(예: RgoogleMaps)에 클라이언트 서버 쿼리를 제공하는 R 패키지를 지원하지 않습니다.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: