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

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

  • Статья

Внимание

В настоящее время программа сертификации соединителя проходит изменения, и регистрация новых сертификатов соединителей в настоящее время находится на удержании. Эта статья будет обновлена после того, как программа сертификации соединителя снова откроется для новых партнеров. Если у вас есть сертифицированный соединитель, который вы хотите обновить, обратитесь к нашей команде dataconnectors@microsoft.com по инструкциям по отправке новой версии. Заявки обрабатываются каждый месяц, и срок подачи - первый вторник каждого месяца.

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

Сертификация соединителя фабрики данных обеспечивает доступность соединителя общедоступной, внестандартной фабрики данных 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 Power Query для создания соединителя, который можно сертифицировать с помощью программы сертификации соединителя Фабрики данных. Перейдите к обзору пакета SDK Power Query, чтобы узнать больше об этом средстве.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Должно FunctionName иметь смысл для домена (например, "Содержимое", "Таблицы", "Документ", "Базы данных" и т. д.).

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

    • Есть значки.
    • Укажите таблицу навигации.
    • Поместите строки в resources.resx файл. URL-адреса и значения должны быть жестко закодированы в коде соединителя и не помещаться в resources.resx файл.

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

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

  • Если Extension.CurrentCredentials() используется:

    • Требуется ли использование? Если да, куда отправляются учетные данные?
    • Гарантируется ли выполнение запросов по протоколу 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 непреднамеренно, а не только что сертифицированный соединитель.
  • Пользовательские соединители должны использоваться только для тестирования новых версий соединителя.
  • При работе с конечными пользователями и клиентами убедитесь, что они понимают, что пользовательская версия соединителя, используемая в тестировании, должна быть удалена до сертификации после завершения тестирования и доступна новая сертифицированная версия соединителя.