Выполнение скриптов R в Power BI DesktopRun R scripts in Power BI Desktop

Вы можете выполнять сценарии R непосредственно в Power BI Desktop и импортировать полученные наборы данных в модели данных Power BI Desktop.You can run R scripts directly in Power BI Desktop, and import the resulting datasets into a Power BI Desktop data model.

Установка скрипта RInstall R

Для запуска сценариев R в Power BI Desktop необходимо установить R на локальном компьютере.To run R scripts in Power BI Desktop, you need to install R on your local machine. Вы можете скачать и установить R бесплатно из различных расположений, включая страницу скачивания Revolution Open и репозиторий CRAN.You can download and install R for free from many locations, including the Revolution Open download page, and the CRAN Repository. В текущем выпуске R-скриптов в Power BI Desktop в пути установки поддерживаются символы Юникода, а также пробелы (пустые символы).The current release of R scripting in Power BI Desktop supports Unicode characters as well as spaces (empty characters) in the installation path.

Выполнение скрипта RRun R scripts

С помощью всего нескольких действий в Power BI Desktop вы можете выполнять сценарии R и создать модель данных, из которой можно создавать отчеты и совместно использовать их в службе Power BI.With just a few steps in Power BI Desktop, you can run R scripts and create a data model, from which you can create reports, and share them on the Power BI service. Теперь R-скрипты в Power BI Desktop поддерживают числовые форматы, которые содержат десятичные знаки (.) и запятые (,).R scripting in Power BI Desktop now supports number formats that contain decimals (.) and commas (,).

Подготовка скрипта RPrepare an R script

Чтобы запустить сценарий R в Power BI Desktop, создайте этот сценарий в локальной среде разработки R и убедитесь, что он выполняется успешно.To run an R script in Power BI Desktop, create the script in your local R development environment, and make sure it runs successfully.

Чтобы запустить сценарий в Power BI Desktop, убедитесь, что этот сценарий успешно выполняется в новой и неизмененной рабочей области.To run the script in Power BI Desktop, make sure the script runs successfully in a new and unmodified workspace. Это означает, что все пакеты и зависимости должны загружаться и выполняться явным образом.This means that all packages and dependencies must be explicitly loaded and run. Вы можете использовать source() для запуска зависимых сценариев.You can use source() to run dependent scripts.

При подготовке и выполнении сценария R в Power BI Desktop действуют некоторые ограничения.When preparing and running an R script in Power BI Desktop, there are a few limitations:

  • Импортируются только кадры данных, поэтому убедитесь, что импортируемые в Power BI данные представлены в кадре.Only data frames are imported, so make sure the data you want to import to Power BI is represented in a data frame
  • Комплексные и векторные столбцы не импортируются, а в созданной таблице заменяются значениями ошибки.Columns that are typed as Complex and Vector are not imported, and are replaced with error values in the created table
  • Значения Н/Д преобразуются в значения NULL в Power BI Desktop.Values that are N/A are translated to NULL values in Power BI Desktop
  • Любой сценарий R, который выполняется дольше 30 минут, завершается по истечении времени ожидания.Any R script that runs longer than 30 minutes times out
  • Интерактивные вызовы в сценарии R, например ожидание ввода данных пользователем, прерывают выполнение сценария.Interactive calls in the R script, such as waiting for user input, halts the script’s execution
  • При настройке рабочего каталога в сценарии R необходимо задать полный, а не относительный путь каталога.When setting the working directory within the R script, you must define a full path to the working directory, rather than a relative path

Выполнение скрипта R и импорт данныхRun your R script and import data

  1. Соединитель данных скрипта R в Power BI Desktop находится в области Получить данные.In Power BI Desktop, the R Script data connector is found in Get Data. Чтобы выполнить сценарий R, выберите Получить данные > Подробнее…, а затем выберите Другие > R-скрипт, как показано на следующем рисунке:To run your R Script, select Get Data > More..., then select Other > R script as shown in the following image:

  2. Если R установлен на локальном компьютере, в качестве подсистемы R выбирается самая новая установленная версия.If R is installed on your local machine, the latest installed version is selected as your R engine. Просто скопируйте сценарий в окне сценария и нажмите кнопку ОК.Simply copy your script into the script window and select OK.

  3. Если R не установлен, не определен или представлен несколькими разными установками на локальном компьютере, разверните R Installation Settings (Параметры установки R) для отображения параметров установки или выберите установку, в которой хотите запустить сценарий R.If R is not installed, is not identified, or if there are multiple installations on your local machine, expand R Installation Settings to display installation options, or to select which installation you want to run the R script.

    Если R установлен, но не определен, можно явно указать его расположение в текстовом поле, отображаемом при развертывании области Параметры установки R.If R is installed and is not identified, you can explicitly provide its location in the text box provided when you expand R Installation Settings. На приведенном выше рисунке в текстовом поле явным образом указан путь C:\Program Files\R\R-3.2.0 .In the above image, the path C:\Program Files\R\R-3.2.0 is explicitly provided in the text box.

    Параметры установки R централизованно расположены в разделе "Создание R-скриптов" в диалоговом окне "Параметры".R installation settings are centrally located in the R Scripting section of the Options dialog. Чтобы указать параметры установки R, выберите Файл > Параметры и настройки, а затем Параметры > Создание R-скриптов.To specify your R installation settings, select File > Options and settings and then Options > R scripting. Если доступно несколько установок R, появится раскрывающееся меню для выбора используемой установки.If multiple installations of R are available, a drop-down menu appears that allows you to select which installation to use.

  4. Нажмите кнопку ОК для выполнения сценария R.Select OK to run the R Script. Если сценарий выполняется успешно, можно выбрать полученные кадры данных для добавления в модель Power BI.When the script runs successfully, you can then choose the resulting data frames to add to the Power BI model.

ОбновлениеRefresh

Вы можете обновить сценарий R в Power BI Desktop.You can refresh an R script in Power BI Desktop. При обновлении сценария R Power BI Desktop запускает его повторно в среде Power BI Desktop.When you refresh an R script, Power BI Desktop runs the R script again in the Power BI Desktop environment.

Дальнейшие действияNext steps

Ознакомьтесь с дополнительными материалами по R в Power BI.Take a look at the following additional information about R in Power BI.