Создание визуальных элементов Power BI с помощью RCreate 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.

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

Модуль R не входит в состав приложения Power BI Desktop, не развертывается и не устанавливается вместе с ним.By default, Power BI Desktop doesn't include, deploy, or install the R engine. Для выполнения сценариев R в Power BI Desktop необходимо отдельно установить R на локальном компьютере.To run R scripts in Power BI Desktop, you must separately install R on your local computer. Вы можете скачать и установить 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.

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

Создание визуальных элементов R в приложении Power BI DesktopCreate R visuals in Power BI Desktop

  1. Выберите значок R Visual (Визуальный элемент R) в области Визуализация, чтобы добавить визуальный элемент R.Select the R Visual icon in the Visualization pane to add an R visual.

    Значок "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. В разделе Значения области Визуализация перетащите из области Поля поля, которые требуется использовать в сценарии R, как и для любого другого визуального элемента Power BI Desktop.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 вы можете добавлять в область Значения новые поля и удалять ненужные.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 создает для них связующий код сценария в серой области вверху области редактора.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.In the example shown in the following image, three fields are selected: hp, gear, and drat. В результате редактор создает связующий код следующего характера.As a result of those selections, the R script editor generates binding code, which is summarized as follows:

    • Создается кадр данных dataset, который состоит из различных полей, выбранных пользователем.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. Например, чтобы обратиться к полю gear, добавьте dataset$gear в сценарий R.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. После автоматического создания кадра данных с выбранными полями можно написать сценарий R, по которому Power BI Desktop строит визуализацию на устройстве 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. Чтобы просмотреть подробные сведения об этой ошибке, выберите команду См. подробности в данном сообщении.For details on the error, select See details from the R visual error.

    Ошибка визуального элемента R

Безопасность R-скриптовR scripts security

Визуальные элементы R создаются на основе сценариев R, которые могут содержать код, не обеспечивающий достаточный уровень безопасности или конфиденциальности.R visuals are created from R scripts, which might contain code with security or privacy risks. При первой попытке просмотра визуальных элементов 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

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

  • Установки 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

Дополнительные сведения о R в Power BI см. в следующих статьях.For more information about R in Power BI, see the following articles: