Создание визуальных элементов R в службе Power BICreating 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.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 используется версия языка 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 отчет с одним визуальным элементом 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 можно создавать только в приложении Power BI Desktop.R visuals currently can only be created in Power BI Desktop, and then published to the Power BI service. Дополнительные сведения о создании элементов R см. в статье Создание визуальных элементов Power BI с помощью языка R (Power BI Desktop).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.

Визуальные элементы R, создаваемые в приложении Power BI Desktop и публикуемые в службе 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.

Как видно на изображении ниже, визуальные элементы R в службе Power BI — как на панелях мониторинга, так и на отчетах — выглядят и работают в основном так же, как и любые другие визуальные элементы, и пользователям не нужно знать о том, что они созданы на базе 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.

Технология песочницы устанавливает ряд ограничений в отношении R-скриптов, запускаемых в службе Power BI. Они связаны, в частности, с доступом в Интернет и к другим ресурсам, которые не нужны для создания визуального элемента 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. Чтобы просмотреть подробные сведения о ней, выберите соответствующую командув сообщении на холсте, как показано на изображении ниже).For details on the error, select See details from the R visual error on the canvas, as shown in the following image.

В качестве еще одного примера на приведенном ниже изображении показано сообщение об ошибке, которое появляется, когда R-скрипту не удается запуститься из-за отсутствия пакета R в Azure.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

Для визуальных элементов R в службе Power BI действует ряд ограничений.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 из них; при этом на изображении появляется соответствующее сообщение.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 не поддерживаются в режиме DirectQuery работы со службами Analysis Services.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
      

Обзор пакетов ROverview 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. Вы можете установить пакеты R для использования в Power BI Desktop самостоятельно (например, с помощью интегрированной среды разработки RStudio).You can install R packages for use in Power BI Desktop on your own (using the RStudio IDE, for example).

Визуальные элементы R в службе Power BI поддерживают пакеты, которые описываются дальше в этой статье.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. Дополнительные сведения о запросе поддержки см. в статье Пакеты R в службе Power BI.See R packages in the Power BI service for information on how to request support.

Требования и ограничения для пакетов RRequirements 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. Мы рекомендуем пользователям сделать свои закрытые пакеты доступными в CRAN, прежде чем запрашивать доступность пакета в службе Power BI.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
  • Из соображений конфиденциальности и безопасности пакеты 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 см. в статье Пакеты R в службе Power BI.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: