Разработка соединителя с помощью пакета SDK Power Query
Пакет SDK Power Query — это набор средств, предназначенных для создания соединителей Power Query. Эти соединители часто называются пользовательскими соединителями или расширениями Power Query.
Пользовательские соединители позволяют создавать новые источники данных или настраивать и расширять существующий источник. Типичные примеры такой ситуации:
- Создание понятного бизнес-аналитика представления для REST API.
- Предоставление фирменной символики для источника, который Power Query поддерживает с существующим соединителем (например, службой OData или драйвером ODBC).
- Реализация потока проверки подлинности OAuth версии 2 для предложения SaaS.
- Предоставление ограниченного или отфильтрованного представления по источнику данных для повышения удобства использования.
- Включение DirectQuery для источника данных с помощью драйвера ODBC.
Установите пакет 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 в применимых продуктах
Создав соединитель, вы можете отправить этот файл, как вы хотите пользователям, и они могут использовать соединитель в применимых продуктах, таких как 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.
Дополнительные сведения об использовании пользовательского соединителя для самостоятельного распространения см. в следующих статьях:
- Загрузка пользовательского соединителя Power Query в Power BI Desktop
- Включение и использование пользовательских соединителей в службе Power BI
Программа сертификации соединителя фабрики данных позволяет отправлять соединитель в Корпорацию Майкрософт для сертификации, где корпорация Майкрософт заботится о публикации и распространении соединителя в 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, использующих шлюз для проверки подлинности обновления или подключения.
Дополнительные сведения о программе сертификации соединителя фабрики данных.