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

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

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

• Поток данных Microsoft Fabric 2-го поколения
• Поток данных Microsoft Power BI 1-го поколения
• Microsoft Power BI Datamart
• Семантическая модель Microsoft Power BI (в службе Power BI)
• Microsoft Power BI Desktop
• Локальный шлюз данных для Microsoft Fabric и Microsoft Power BI

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

• Поддерживается разработчиком партнера

• Поддерживается разработчиком партнера

• Сертифицировано корпорацией Майкрософт

• Распределено корпорацией Майкрософт

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

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

Предварительные условия

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

• Соединитель должен быть для общедоступного продукта.

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

• Разработчик должен предоставить оценку текущего и будущего использования.

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

• Соединитель должен успешно работать на ожидаемом уровне использования клиентами.

• На форуме "Идеи для Fabric" должна быть тема, управляемая клиентами, чтобы указать требование сделать соединитель общедоступным в Data Factory и/или Power BI. Нет заданного порогового значения участия. Однако чем больше вовлеченности, тем более очевиден спрос на соединитель.

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

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

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

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

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

• Соединитель ДОЛЖЕН:

  • Используйте формат документа раздела.
  • Разместите заголовок/украшение версии над документом раздела.
  • Укажите метаданные документации функции.
  • Есть обработчик TestConnection.
  • Следуйте соглашениям об именовании (например, DataSourceKind.FunctionName). Не следует включать такие слова, как Fabric, Power BI, Connector или API.
  • Возвращайте данные в табличном формате, упорядоченные в таблицы с столбцами, как для реляционного источника данных. Многомерные форматы на основе кубов, измерений и мер не поддерживаются.
  • Ведет себя одинаково в режиме импорта и DirectQuery, возвращая идентичные результаты.
  • Установите флаг бета-тестирования на 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 должно быть динамическим (то есть извлекается из веб-вызова).

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

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

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