Поделиться через

Разработка соединителя с помощью пакета SDK Power Query

  • Статья

Пакет SDK Power Query — это набор средств, предназначенных для создания соединителей Power Query. Эти соединители часто называются пользовательскими соединителями или расширениями Power Query.

Пользовательские соединители позволяют создавать новые источники данных или настраивать и расширять существующий источник. Типичные примеры такой ситуации:

  • Создание понятного бизнес-аналитика представления для REST API.
  • Предоставление фирменной символики для источника, который Power Query поддерживает с существующим соединителем (например, службой OData или драйвером ODBC).
  • Реализация потока проверки подлинности OAuth версии 2 для предложения SaaS.
  • Предоставление ограниченного или отфильтрованного представления по источнику данных для повышения удобства использования.
  • Включение DirectQuery для источника данных с помощью драйвера ODBC.

Установка пакета SDK Для Power Query

Установите пакет SDK Power Query Для Visual Studio Code из раздела Visual Studio Code в Visual Studio Marketplace. Выберите " Установить", чтобы установить пакет SDK.

Процесс разработки соединителя

В следующих разделах описывается на высоком уровне наиболее распространенный процесс создания соединителя Power Query с помощью пакета SDK.

Создание нового расширения

При создании новой рабочей области (пакет SDK Для Power Query Для Visual Studio Code) вы начинаете с следующих основных файлов:

  • Файл определения соединителя (<connectorName.pq>)
  • Файл запроса (<connectorName.query.pq>)
  • Файл строковых ресурсов (resources.resx)
  • PNG-файлы различных размеров, используемых для создания значков

Файл определения соединителя начинается с описания пустого источника данных. Дополнительные сведения об источнике данных см. в контексте пакета SDK Power Query из статьи по обработке доступа к данным.

Тестирование

Пакет SDK Power Query предоставляет базовые возможности выполнения запросов, позволяя протестировать расширение без необходимости переключиться на другое клиентское приложение. Вы можете дополнительно протестировать соединитель в приложении, например:

Тестовый файл запроса

Помимо файла расширения проекты Соединителя данных могут иметь файл запроса (name.query.pq). Этот файл можно использовать для выполнения тестовых запросов в Visual Studio Code. Оценка запроса автоматически включает код расширения без регистрации PQX-файла, что позволяет вызывать или тестировать все общие функции в коде расширения.

Файл запроса может содержать одно выражение (например, выражение (например, HelloWorld.Contents()let создание Power Query) или документ раздела.

Сборка и развертывание

Создание проекта создает mez-файл или файл расширения. Расширения Power Query упаковываются в ZIP-файл и получают расширение MEZ.

Расширения определяются в документе раздела M. Документ раздела имеет немного другой формат от документов запроса, созданных в Power Query. Код, импортируемый из Power Query, обычно требует изменения в документе раздела, но изменения являются незначительными. Различия в документе раздела следует учитывать:

  • Они начинаются с объявления раздела (например, section HelloWorld;).
  • Каждое выражение заканчивается точкой с запятой (например, a = 1; или b = let c = 1 + 2 in c;).
  • Все функции и переменные являются локальными в документе раздела, если они не помечены как общие. Общие функции становятся видимыми для других запросов и функций и могут рассматриваться как экспорт для расширения (т. е. они становятся вызываемыми из Power Query).

Дополнительные сведения о документах раздела M см. в спецификации языка M.

Распределение соединителей Power Query

У вас есть два пути, в которых можно распределить соединитель:

  • Самостоятельное распределение
  • Сертификация соединителя

Самостоятельное распределение

Механизм самообслуживания, в котором можно применять пользовательские соединители Power Query в применимых продуктах

Создав соединитель, вы можете отправить этот файл, как вы хотите пользователям, и они могут использовать соединитель в применимых продуктах, таких как Microsoft Power BI.

Microsoft Power BI

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

Соединители Power Query можно загрузить в три интерфейса:

  • Локальный шлюз данных: соединитель можно загрузить через шлюз, который будет использоваться в Microsoft Fabric и Microsoft служба Power BI
  • Power Query Online: в таких интерфейсах, как Power BI Datamarts, Fabric Dataflow 2-го поколения и многие другие
  • Power Query Desktop: в таких интерфейсах, как Power BI Desktop.

Дополнительные сведения об использовании пользовательского соединителя для самостоятельного распространения см. в следующих статьях:

Сертификация соединителя

Программа сертификации соединителя фабрики данных позволяет отправлять соединитель в Корпорацию Майкрософт для сертификации, где корпорация Майкрософт заботится о публикации и распространении соединителя в Microsoft Fabric и Microsoft Power BI для применимых продуктов и возможностей:

  • Power Query Desktop: Microsoft Power BI Desktop.
  • Power Query Online: Поток данных Microsoft Fabric 2-го поколения, хранилище Microsoft Fabric, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow 1-го поколения и другие
  • Локальный шлюз данных: для Microsoft Fabric и Microsoft Power BI, использующих шлюз для проверки подлинности обновления или подключения.

Дополнительные сведения о программе сертификации соединителя фабрики данных.