Использование пользовательских соединителей данных с локальным шлюзом данных

Примечание.

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

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

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

Дополнительные сведения о разработке пользовательских соединителей данных для Power BI см. в пакете SDK data Подключение ors в GitHub. Этот сайт содержит сведения о начале работы и примерах для Power BI и Power Query.

Включение и использование пользовательских соединителей

Чтобы включить использование пользовательских соединителей, выберите Подключение or в локальном приложении шлюза данных. В пользовательских соединителях данных в разделе "Загрузка пользовательских соединителей данных из папки" перейдите к папке и выберите папку, к которым пользователь, на котором работает служба шлюза. По умолчанию используется NT SERVICE\PBIEgwService. Шлюз автоматически загружает файлы настраиваемых соединителей в этой папке, и они отображаются в списке соединителей данных.

Screenshot that shows the Custom data connectors screen in the On-premises data gateway app.

Примечание.

Если вы используете локальный шлюз данных (личный режим), вы можете отправить отчет Power BI в служба Power BI и использовать шлюз для его обновления.

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

Screenshot that shows enabling custom connectors on the on-premises gateway Settings page.

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

Screenshot that shows the Data Source list on the Settings page.

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

  • Убедитесь, что созданная папка доступна службе фонового шлюза. Как правило, папки в папках Windows или системных папках пользователей недоступны. Локальное приложение шлюза данных отображает сообщение, если папка недоступна. Это ограничение не применяется к локальному шлюзу данных (персональный режим).

  • Чтобы пользовательские соединители работали с локальным шлюзом данных, они должны реализовать раздел Test Подключение ion в пользовательском коде соединителя. Этот раздел не требуется при использовании пользовательских соединителей с Power BI Desktop. По этой причине можно использовать соединитель, который работает с Power BI Desktop, но не с шлюзом. Дополнительные сведения о реализации раздела Test Подключение ion см. в разделе Test Подключение ion.

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

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

Есть еще вопросы? Попробуйте попросить Сообщество Power BI.