Расширяемость соединителя в Power BI

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

Power BI подключается к данным через существующие соединители и универсальные источники, такие как ODBC, OData, OLE DB, Web, CSV, XML и JSON. Разработчики добавляют новые источники с помощью настраиваемых расширений данных, называемых настраиваемыми соединителями. Корпорация Майкрософт сертифицирует и распространяет некоторые пользовательские соединители как сертифицированные соединители.

Разработка кастомных коннекторов (SDK Power Query)

Используйте пакет SDK Power Query в Visual Studio Code для создания, проверки и упаковки пользовательских соединителей:

• Установите из Visual Studio Marketplace пакет SDK Power Query для Visual Studio Code.
• Изучите примеры и расширенные шаблоны в репозитории GitHub: microsoft/DataConnectors на GitHub.
• Используйте пакет SDK для:
  • Создание и редактирование .pq и .m исходных файлов с подсветкой синтаксиса и проверкой схемы
  • Создание пакета (.mez сжатого набора соединителей)
  • Выполнение тестовых запросов с помощью встроенного средства выполнения запросов
  • Проверка таблиц навигации, потоков проверки подлинности и типов источников данных

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

Кроме того, разработчик может подписать соединитель с сертификатом и предоставить вам сведения, необходимые для его использования, не изменяя параметры безопасности. Дополнительные сведения см. в разделе "Доверенные сторонние соединители".

Настраиваемые соединители

Несертифицированные пользовательские соединители варьируются от небольших, критически важных для бизнеса api до крупных отраслевых служб, которые еще не имеют соединителя Майкрософт. Поставщики распределяют множество соединителей. Если вам нужен отраслевой или бизнес-соединитель, обратитесь к поставщику.

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

Если эти соединители не нужны в этом сеансе, нажмите кнопку "ОК ", чтобы закрыть ошибку.

Чтобы предотвратить ошибку несертифицированных соединителей, измените параметр безопасности расширений данных или удалите несертифицированные соединители из папки настраиваемых соединителей .

Разрешить несертифицированные пользовательские соединители

Чтобы использовать несертифицированный пользовательский соединитель, выполните следующее:

1. Скопируйте файл соединителя (.pq, .pqx, .m, или .mez) в папку пользовательских соединителей внутри каталога Документы.

   [Documents]\Microsoft Power BI Desktop\Custom Connectors

   Если папка не существует, создайте ее.

   Замечание

   Если в организации включена синхронизация OneDrive или Перенос известных папок, эффективный путь к документам может быть перенаправлен. Например: C:\Users\<user>\OneDrive - Fabrikam\Documents.

   Не делайте предположений %USERPROFILE%\Documents. Чтобы надежно найти правильную папку в PowerShell, выполните следующие действия.

   [Environment]::GetFolderPath('MyDocuments')
   Join-Path ([Environment]::GetFolderPath('MyDocuments')) 'Microsoft Power BI Desktop\Custom Connectors'
   

   Поместите файлы соединителя туда, а затем перезапустите Power BI Desktop.

2. В Power BI Desktop перейдите в раздел Файл>Параметры и настройки>Параметры>Безопасность, чтобы отрегулировать настройки безопасности расширения данных.

3. В разделе "Расширения данных" выберите (Не рекомендуется) Разрешить загрузку любого расширения без проверки или предупреждения, а затем нажмите кнопку "ОК".

   

4. Перезапустите Power BI Desktop.

Подписать пользовательские коннекторы

Если вы подпишете .mez пакет доверенным сертификатом подписи кода, пользователи могут загрузить соединитель без включения параметра расширения данных разрешить любое расширение.

Правильно подписанный коннектор от доверенного издателя загружается в соответствии с рекомендуемой настройкой безопасности. Неподписанные или самоподписанные соединители активируют диалоговое окно о несертифицированности, если разрешающий параметр не активирован.

Дополнительные сведения о подписывании соединителей см. в разделе "Обработка подписывания соединителя Power Query".

Требования к доверию сертификатов и пограничные варианты (корневое хранилище, промежуточные цепи, отзыв) см. в разделе доверенных сторонних соединителей.

Сертифицированные соединители

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

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

Устранение неполадок пользовательского соединителя

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

Связанный контент

• См. сертификацию соединителя Power Query для сертификации пользовательского соединителя.