Общие сведения о пакете 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:

  • Пакет SDK для Visual Studio Power Query: выпущен в 2017 году в качестве расширения для Visual Studio 2017 и 2019.
  • Пакет SDK Power Query Для Visual Studio Code (предварительная версия): выпущен в 2022 году в качестве нового и рекомендуемого способа создания соединителей Power Query.

Мы рекомендуем всем разработчикам устанавливать и использовать только что выпущенный пакет SDK Power Query Visual Studio Code (предварительная версия), так как эта версия в конечном итоге станет пакетом SDK по умолчанию.

Visual Studio Power Query SDK

Выполните следующие действия, чтобы установить пакет SDK Для Visual Studio Power Query:

  1. Установите пакет SDK Power Query из Visual Studio Marketplace.
  2. Создайте проект соединителя данных.
  3. Определите логику соединителя.
  4. Создайте проект для создания файла расширения.

Предварительная версия компонента.

Пакет SDK Power Query для Visual Studio Code (предварительная версия)

Примечание.

Новый пакет SDK Power Query Для Visual Studio Code в настоящее время находится в общедоступной предварительной версии по состоянию на сентябрь 2022 года.

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

процесс разработки Подключение or

Хотя вы можете использовать Visual Studio Code или пакет SDK Для Visual Studio Power Query, оба используют аналогичный процесс для разработки соединителя на высоком уровне.

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

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

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

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

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

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

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

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

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

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

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

Создание проекта создает mez-файл или файл расширения.

Расширения Power Query упаковываются в ZIP-файл и получают расширение MEZ. Во время выполнения Power BI Desktop загружает расширения из [документов]\Microsoft Power BI Desktop\Custom Подключение or.

Примечание.

Проекты Подключение or данных не поддерживают пользовательские действия после сборки, чтобы скопировать файл расширения в каталог [Документы]\Microsoft Power BI Desktop\Custom Подключение ors. Если это то, что вы хотите сделать, может потребоваться использовать стороннее расширение.

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

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

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

Распределение соединителей данных

Соединители Power Query можно использовать в Power BI Desktop или в Power Query Online, таких как потоки данных Power BI, данные Power BI и другие возможности.

Power BI Desktop

Пользователи Power BI Desktop могут выполнить следующие действия, чтобы использовать настраиваемый соединитель Power Query:

  1. Скопируйте файл расширения (.mez или PQX) в [Документы]/Power BI Desktop/Custom Подключение ors.
  2. В Power BI Desktop выберите (не рекомендуется) Разрешить любому расширению загружаться без проверки или предупреждения в разделе "Параметры файла>" и "Параметры>параметров>безопасности>данных".
  3. Перезапустите Power BI Desktop.

Power BI Desktop автоматически загружает расширения при перезапуске.

Кроме того, как владелец источника данных и соединителя, вы можете отправить соединитель в программу сертификации Подключение or Power Query, чтобы она поставляется с Power BI Desktop на каждом выпуске.

Онлайн-версия Power Query

Примечание.

Команда Power Query работает над включением всех сертифицированных соединителей Power Query в Power Query Online.

В интерфейсе Power Query Online отображаются только сертифицированные соединители Power Query. Дополнительные сведения о программе сертификации соединителя Power Query см. в Подключение сертификации Power Query.