Создание и использование визуальных элементов R в Power BI

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: Служба Power BI Power BI Desktop

Визуальные элементы R в настоящее время можно создавать только в Power BI Desktop, а затем публиковаться в служба Power BI. Дополнительные сведения о создании визуальных элементов R см. в статье "Создание визуальных элементов Power BI с помощью R ".

Просмотр визуальных элементов R в служба Power BI

Служба Power BI поддерживает просмотр и взаимодействие с визуальными элементами, созданными с помощью скриптов R. Визуальные элементы, созданные с помощью скриптов R, часто называемые визуальными элементами R, могут представлять расширенные формы данных и аналитику, такие как прогнозирование, используя широкие возможности аналитики и визуализации R.

Примечание.

Язык программирования R является одним из наиболее широко используемых языков программирования статистическими специалистами, специалистами по обработке и анализу данных и бизнес-аналитиками. Язык R имеет сообщество с открытым исходным кодом, которое предлагает более 7000 пакетов надстроек, а также широко используемые группы пользователей R.

Визуальные элементы R создаются в отчете Power BI Desktop, например отчет, показанный на следующем рисунке.

Desktop report with two visuals.

После создания отчета в Power BI Desktop можно опубликовать отчет, содержащий один или несколько визуальных элементов R в служба Power BI.

В службе поддерживаются не все пакеты R. Список пакетов, поддерживаемых в настоящее время в служба Power BI, см. в конце этой статьи.

Вы можете скачать этот пример файла Power BI Desktop (PBIX-файл ), который содержит несколько визуальных элементов R, чтобы узнать, как они работают, и экспериментировать.

Визуальные элементы R, созданные в Power BI Desktop, а затем опубликованные в служба Power BI, обычно ведут себя как любой другой визуальный элемент в служба Power BI. Вы можете взаимодействовать, фильтровать, срезы или делиться ими с другими пользователями. Однако, в отличие от других визуальных элементов, визуальные элементы R не могут отображать подсказки и не могут использоваться для фильтрации других визуальных элементов.

Как видно на следующем изображении, визуальные элементы R в служба Power BI в значительной степени отображаются и ведут себя как любой другой визуальный элемент. Пользователям не нужно знать базовый скрипт R, который создал визуальный элемент.

Screenshot of the report page in the Power BI service.

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

Визуальные элементы R создаются из скриптов R, которые могут содержать код с рисками безопасности или конфиденциальности.

Эти риски в основном существуют на этапе разработки, когда автор скрипта запускает скрипт на своем компьютере.

Служба Power BI применяет технологию песочницы для защиты пользователей и службы от рисков безопасности.

Этот подход к песочнице накладывает некоторые ограничения на скрипты R, выполняемые в служба Power BI, например доступ к Интернету или доступ к другим ресурсам, которые не требуются для создания визуального элемента R.

Ошибка сценариев R

Когда скрипт R обнаруживает ошибку, визуальный элемент R не отображается и отображается сообщение об ошибке. Дополнительные сведения об ошибке см. в визуальной ошибке R на холсте, как показано на следующем рисунке.

Screenshot showing an R visual error message.

В другом примере ниже показано сообщение об ошибке, которое отображается при сбое запуска скрипта R из-за отсутствия пакета R в Azure.

Screenshot showing a runtime error.

Лицензирование

Визуальные элементы R требуют лицензии Power BI Pro или Premium на пользователя (PPU) для отображения отчетов, обновления, фильтрации и перекрестного фильтрации. Дополнительные сведения о лицензиях Power BI Pro и о том, как они отличаются от бесплатных лицензий, см. в статье о содержимом Power BI Pro. Что такое?

Бесплатные пользователи Power BI могут использовать только плитки, к которым они предоставляются в рабочих областях Premium. Дополнительные сведения о premium см. в статье о приобретении Power BI Pro для получения дополнительных сведений.

В следующей таблице описаны возможности визуальных элементов R на основе лицензирования.

Создание визуальных элементов R в Power BI Desktop Создание отчетов служба Power BI с помощью визуальных элементов R Просмотр визуальных элементов R в отчетах
Гостевой (Power BI embedded) Поддерживается Не поддерживается Поддерживается только в емкости Premium или Azure
Неуправляемый клиент (домен не проверен) Поддерживается Не поддерживается Не поддерживается
Управляемый клиент с бесплатной лицензией Поддерживается Не поддерживается Поддерживается только в емкости Premium
Управляемый клиент с лицензией Pro или PPU Поддерживается Поддерживаемые Поддерживается

Обзор пакетов R

Пакеты R — это коллекции функций R, данных и скомпилированного кода, которые объединяются в хорошо определенный формат. При установке R он поставляется со стандартным набором пакетов, а другие пакеты доступны для скачивания и установки. После установки пакет R должен быть загружен в сеанс, который будет использоваться. Основным источником бесплатных пакетов R является CRAN, комплексная сеть архива R.

Power BI Desktop может использовать любой тип пакетов R без ограничений. Пакеты R можно установить в Power BI Desktop самостоятельно (например, с помощью интегрированной среды разработки RStudio).

Визуальные элементы R в служба Power BI поддерживаются пакетами, найденными в разделе "Поддерживаемые пакеты", приведенном в этой статье. Если вы не найдете интересующий вас пакет в списке поддерживаемых пакетов, вы можете запросить поддержку пакета. Дополнительные сведения см. в служба Power BI пакетах R для получения сведений о том, как запрашивать поддержку.

Требования и ограничения пакетов R

Существует несколько требований и ограничений для пакетов R:

  • Служба Power BI поддерживает пакеты R с бесплатными и открытыми лицензиями программного обеспечения, такими как GPL-2, GPL-3, MIT+и т. д.

  • Служба Power BI поддерживает пакеты, опубликованные в CRAN. Служба не поддерживает частные или пользовательские пакеты R. Мы рекомендуем пользователям сделать свои частные пакеты доступными в CRAN, прежде чем запрашивать пакет в служба Power BI.

  • Для Power BI Desktop есть два варианта для пакетов R:

    • Для визуальных элементов R можно установить любой пакет, включая пользовательские пакеты R.
    • Для пользовательских визуальных элементов R поддерживаются только общедоступные пакеты CRAN для автоматической установки пакетов.

  • По соображениям безопасности и конфиденциальности в настоящее время в службе не поддерживаются пакеты R, предоставляющие запросы на клиентский сервер через World-Wide Web (например, Rgoogle Карты). Сети блокируются для таких попыток. Дополнительные сведения см. в служба Power BI пакетах R для списка поддерживаемых и неподдерживаемых пакетов R.

  • Процесс утверждения для включения нового пакета R имеет дерево зависимостей; Некоторые зависимости, необходимые для установки в службе, не поддерживаются.

Поддерживаемые пакеты:

Длинный список поддерживаемых пакетов R (и короткий список неподдерживаемых пакетов) см. в следующей статье:

Рекомендации и ограничения

  • Поддержка визуальных элементов R ограничена пакетами, указанными в разделе Learn, какие пакеты R поддерживаются. В настоящее время поддержка пользовательских пакетов отсутствует.

  • Данные, используемые визуальным элементом R для построения, ограничены 150 000 строк. Если выбрано более 150 000 строк, используются только первые 150 000 строк, а на изображении отображается сообщение. Кроме того, входные данные имеют ограничение в 250 МБ.

  • Если входная семантическая модель визуального элемента R содержит столбец, содержащий строковое значение до 32766 символов, это значение усечено.

  • Все визуальные элементы R отображаются в 72 точках на дюйм.

  • Поддерживается только отображение устройства по умолчанию.

  • Если визуальное вычисление R превышает 60 секунд, время ожидания скрипта и отображение ошибки.

  • Визуальные элементы R обновляются при обновлении данных, фильтрации и выделении. Однако сам образ не является интерактивным и не поддерживает советы по инструментам.

  • Визуальные элементы R отвечают на выделение других визуальных элементов, но вы не можете выбирать элементы в визуальном элементе R, чтобы перекрестно фильтровать другие визуальные элементы.

  • Визуальные элементы R в настоящее время не поддерживаются для типа данных Time . Используйте вместо этого дату и время.

  • Визуальные элементы R не отображаются при использовании публикации в Интернете.

  • Визуальные элементы R не поддерживают переименование входных столбцов. Во время выполнения скрипта столбцы будут ссылаться на их исходное имя.

  • Визуальные элементы R не печатаются с печатью отчетов.

  • Визуальные элементы R не поддерживаются в режиме DirectQuery служб Analysis Services.

  • Визуальные элементы R могут преобразовать текстовые метки в графические элементы. Для этого в служба Power BI требуется следующий дополнительный шаг:

    • Добавьте следующую строку в начале скрипта R:

      powerbi_rEnableShowText = 1

  • Китайские, японские и корейские шрифты требуют правильной работы в служба Power BI:

    1. Установите showtext пакета R и все его зависимости. Его можно установить, выполнив следующий сценарий:

      install.packages("showtext")

    2. Добавьте следующую строку в начале скрипта R:

      powerbi_rEnableShowTextForCJKLanguages =  1