Сертификация Подключение power Query

Статья
01/18/2024

Примечание.

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

Введение

С помощью пакета SDK Для Power Query все пользователи могут создать пользовательский соединитель Power Query для подключения к источнику данных из Power Query. В настоящее время пользовательские соединители поддерживаются только в семантических моделях Power BI (Power BI Desktop и служба Power BI) и требуют использования локального шлюза данных для обновления через служба Power BI. Пользовательские соединители должны быть распределены разработчиком по отдельности.

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

Сертификация настраиваемого соединителя Power Query делает соединитель доступным общедоступным, устаревшим в семантических моделях Power BI (Power BI Desktop и служба Power BI), потоках данных Power BI и диаграммах данных Power BI. Сертифицированные соединители поддерживаются в PowerBI.com и во всех версиях Power BI Premium.

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

Поддерживается разработчиком партнера
Поддерживается разработчиком партнера
Сертифицировано корпорацией Майкрософт
Распределено корпорацией Майкрософт

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

Различия сертифицированного соединителя и пользовательского соединителя

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

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

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

Распределение пользовательских соединителей

Пользовательские соединители могут распространяться для конечных пользователей перед сертификацией.

Так как M является универсальным языком, который, как показано в обработке проверки подлинности, имеет возможность взаимодействовать с сохраненными учетными данными, нам необходимо предоставить пользователям возможность выполнять только доверенные соединители.

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

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

Обзор сертификации

Необходимые компоненты

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

Соединитель должен быть для общедоступного продукта.
Соединитель должен считаться полным кодом для начальной версии выпуска. Программа позволяет выполнять частые итерации и обновления. Обратите внимание, что корпорация Майкрософт не предлагает технической помощи или консультации по разработке пользовательских соединителей. Мы рекомендуем использовать общедоступные ресурсы, такие как документация и репозиторий примеров пакета SDK. Если вам нужна дополнительная помощь, мы можем поделиться списком известных консультантов по разработке пользовательских соединителей сторонних производителей, которые могут потребоваться напрямую, отдельно от любой программы Майкрософт или партнерства. Обратите внимание, что корпорация Майкрософт не связана с любым из этих консультантов и не несет ответственности за использование своих служб. Корпорация Майкрософт предоставляет список для удобства и без каких-либо гарантий, рекомендаций или гарантий. Обратитесь к своему контакту с сертификацией Майкрософт, чтобы узнать больше.
Разработчик должен предоставить оценку использования. Мы рекомендуем разработчикам соединителей для очень бутик-продуктов использовать возможности самостоятельного подписания соединителя, чтобы предоставить их непосредственно клиенту.
Соединитель должен быть уже доступен клиентам непосредственно для выполнения пользовательского сценария или бизнес-сценария. Эти критерии можно выполнить с помощью программы private Preview, распространяя завершенный соединитель непосредственно конечным пользователям и организациям через самозаверяющую подпись. Каждый пользователь или организация должны иметь возможность предоставлять отзывы и проверку того, что для соединителя требуется бизнес-потребность, и что соединитель успешно работает для выполнения своих бизнес-требований.
Соединитель должен успешно работать на ожидаемом уровне использования клиентами.
На форуме "Идеи Power BI" должен быть поток, на основе которого клиенты указывают, что требуется сделать соединитель общедоступным в Power BI Desktop. Нет заданного порогового значения участия. Однако чем больше вовлеченности, тем сильнее свидетельствует спрос на соединитель.

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

Процесс и временная шкала

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

Регистрация: уведомление о намерении сертифицировать настраиваемый соединитель. Эта регистрация должна выполняться в течение 15-го месяца, за два месяца до целевого выпуска Power BI Desktop.
- Например, для апрельского выпуска Power BI Desktop крайний срок будет 15 февраля.
Отправка: отправка файлов соединителей для проверки Майкрософт. Эта отправка должна выполняться в течение 1-го месяца до целевого выпуска Power BI Desktop.
- Например, для апрельского выпуска Power BI Desktop крайний срок будет составлять 1 марта.
Технический обзор: завершение файлов соединителей, передача проверки и сертификации Майкрософт. Эта проверка должна выполняться до 15-го месяца до целевого выпуска Power BI Desktop.
- Например, для апрельского выпуска Power BI Desktop крайний срок будет составлять 15 марта.

Из-за сложности технических проверок и потенциальных задержек, перепродачи и тестирования проблем, мы настоятельно рекомендуем отправлять на ранних этапах с длительным временем выполнения для первоначального выпуска и сертификации. Если вы чувствуете, что соединитель важен для доставки нескольким клиентам с минимальными затратами, мы рекомендуем самостоятельно подписывать и предоставлять его таким образом.

Требования к сертификации

У нас есть определенный набор требований для сертификации. Мы понимаем, что не каждый разработчик может соответствовать этим требованиям, и мы надеемся представить набор функций, который будет обрабатывать потребности разработчиков в коротком порядке.

Файлы отправки (артефакты)

Убедитесь, что файлы соединителя, которые вы отправляете, включают все следующие элементы:

файл Подключение or (MEZ)
- Mez-файл должен соответствовать стандартам стиля и называться аналогично имени продукта или службы. Он не должен включать такие слова, как "Power BI", "Подключение or" или "API".
- Назовите mez-файл: ProductName.mez
Файл Power BI Desktop (PBIX) для тестирования
- Для тестирования соединителя требуется пример отчета Power BI (PBIX).
- Отчет должен содержать по крайней мере один запрос для тестирования каждого элемента в таблице навигации.
- Если не задана схема (например, базы данных), отчету необходимо включить запрос для каждого типа таблицы, которую может обрабатывать соединитель.
Проверка учетной записи в источнике данных
- Мы используем тестовую учетную запись для тестирования и устранения неполадок соединителя.
- Предоставьте тестовую учетную запись, которая является постоянной, чтобы использовать ту же учетную запись для сертификации любых будущих обновлений.
Инструкции по тестированию
- Предоставьте любую документацию по использованию соединителя и проверьте ее функциональные возможности.
Ссылки на внешние зависимости (например, драйверы ODBC)

Функции и стиль

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

Соединитель ДОЛЖЕН:
- Используйте формат документа раздела.
- Содержит заголовок или украшение версии над документом раздела.
- Укажите метаданные документации по функциям.
- Есть обработчик тестирования Подключение ion.
- Следуйте соглашениям об именовании (например, DataSourceKind.FunctionName). Он не должен включать такие слова, как "Power BI", "Подключение or" или "API".
- Установите для флага бета-версии значение True при первоначальном выпуске.
Должно FunctionName иметь смысл для домена (например, "Содержимое", "Таблицы", "Документ", "Базы данных" и т. д.).
Соединитель ДОЛЖЕН:
- Есть значки.
- Укажите таблицу навигации.
- Поместите строки в resources.resx файл. URL-адреса и значения должны быть жестко закодированы в коде соединителя и не помещаться в resources.resx файл.

Безопасность

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

Если Extension.CurrentCredentials() используется:
- Требуется ли использование? Если да, куда отправляются учетные данные?
- Гарантируется ли выполнение запросов по протоколу HTTPS?
  - Вы можете использовать вспомогательные функции принудительного применения HTTPS.
- Если учетные данные отправляются с помощью Web.Contents() GET:
  - Можно ли превратить его в POST?
  - Если требуется GET, соединитель ДОЛЖЕН использовать CredentialQueryString запись в Web.Contents() записи параметров для передачи конфиденциальных учетных данных.
Если используются функции Diagnostics.* :
- Проверка трассировки; данные не должны содержать личные данные или большие объемы ненужных данных.
- Если вы реализовали значительную трассировку в разработке, следует реализовать переменную или флаг компонента, который определяет, следует ли включить трассировку. Эта трассировка должна быть отключена перед отправкой для сертификации.
Если Expression.Evaluate() используется:
- Проверьте, откуда поступает выражение и что такое (т. е. может динамически создавать вызовы Extension.CurrentCredentials() и т. д.).
- Не Expression следует предоставлять пользователю и не принимать входные данные пользователя.
- Не Expression должно быть динамическим (то есть извлекается из веб-вызова).

Регистрация для сертификации

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

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

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

После сертификации

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

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

Приложения шаблонов (рекомендуется)

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