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

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

  • Статья

Примечание.

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

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

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

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

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

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

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

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

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

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

  • Регистрация: уведомление о намерении сертифицировать настраиваемый соединитель. Эта регистрация должна выполняться в течение 15-го месяца, за два месяца до целевого выпуска Power BI Desktop.

    • Например, для апрельского выпуска Power BI Desktop крайний срок будет 15 февраля.

  • Отправка: отправка файлов соединителей для проверки Майкрософт. Эта отправка должна выполняться в первый месяц до целевого выпуска Power BI Desktop.

    • Например, для апрельского выпуска Power BI Desktop крайний срок будет составлять 1 марта.

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

    • Например, для апрельского выпуска Power BI Desktop крайний срок будет составлять 15 марта.

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

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

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

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

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

  • Файл Соединителя (MEZ)

    • Mez-файл должен соответствовать стандартам стиля и называться аналогично имени продукта или службы. Не следует включать такие слова, как Fabric, Power BI, Connector или API.
    • Назовите mez-файл: ProductName.mez

  • Файл Power BI Desktop (PBIX) для тестирования

    • Для тестирования соединителя требуется пример отчета Power BI (PBIX).
    • Отчет должен содержать по крайней мере один запрос для тестирования каждого элемента в таблице навигации.
    • Если не задана схема (например, базы данных), отчету необходимо включить запрос для каждого типа таблицы, которую может обрабатывать соединитель.

  • Проверка учетной записи в источнике данных

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

  • Инструкции по тестированию

    • Предоставьте любую документацию по использованию соединителя и проверьте ее функциональные возможности.

  • Ссылки на внешние зависимости (например, драйверы ODBC)

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

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

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

    • Используйте формат документа раздела.
    • Содержит заголовок или украшение версии над документом раздела.
    • Укажите метаданные документации по функциям.
    • У вас есть обработчик 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 должно быть динамическим (то есть извлекается из веб-вызова).

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

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

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

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

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

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

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