通过

数据工厂连接器认证

  • 项目

重要

连接器认证计划目前正在进行更改，新的连接器认证的注册目前处于暂停状态。 一旦连接器认证计划再次为新合作伙伴开放，本文将更新。 如果你有一个想要更新的已认证连接器，请通过 dataconnectors@microsoft.com 联系我们的团队，获取有关如何提交新版本的说明。 每个月都会处理提交，提交的截止日期是每个月的第一个星期二。

为数据源开发自定义连接器的数据源所有者可能希望将自定义连接器更广泛地分发给数据工厂用户。 一旦最终用户创建、使用和验证了自定义连接器，数据源所有者就可以提交它，以便进行 Microsoft 认证。

认证数据工厂连接器可使连接器在以下体验中以公开、现成的方式提供给 Microsoft Fabric 数据工厂和 Microsoft Power BI：

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Microsoft Power BI 语义模型（在 Power BI 服务中）
  • Microsoft Power BI Desktop
  • Microsoft Fabric 和 Microsoft Power BI 的本地数据网关

经认证的连接器包括：

  • 由合作伙伴开发人员维护

  • 由合作伙伴开发人员提供支持

  • Microsoft 已认证

  • 由 Microsoft 分发

我们与合作伙伴合作，努力确保其在维护方面提供支持，但连接器本身的客户问题会转给合作伙伴开发人员。

注意

现在，你可以利用 Power Query SDK 创建一个可通过数据工厂连接器认证计划获得认证的连接器。 请访问 Power Query SDK 概述，了解有关此工具的详细信息。

认证概述

先决条件

为了确保为客户提供最佳体验，我们仅考虑满足一组认证先决条件的连接器：

  • 连接器必须用于公共产品。

  • 对于初始发布版本，连接器必须被视为代码完整。 程序允许频繁迭代和更新。 Microsoft 不提供技术支持或自定义连接器开发咨询。 建议利用公共资源，例如 SDK 文档和示例存储库。 如果你需要进一步的帮助，我们可以共享已知第三方行业自定义连接器开发顾问的列表，你可能希望独立于任何 Microsoft 计划或合作关系直接与之合作。 Microsoft 不隶属于这些顾问中的任何一个，并且不对其服务的使用负责。 Microsoft 提供方便性列表，无需任何保障、建议或保证。 若要了解详细信息，请联系 Microsoft 认证联系人。

  • 开发人员必须提供当前和未来的使用量的估算值。

  • 连接器必须已可供客户直接使用，以满足用户需求或业务方案要求。 可以将已完成的连接器直接分发给最终用户和组织，从而使用预览版计划满足此条件。 我们建议连接器的开发人员使用自分发机制并对其自己的连接器运行内部测试，以便在对照组下对其连接器进行迭代操作。 每个用户或组织都应能够提供反馈和验证连接器业务需要，并且连接器正在成功满足其业务需求。

  • 连接器必须在客户的预期使用量级别成功工作。

  • 客户推动的 Fabric 创意论坛中必须有一个会话，表明在数据工厂和/或 Power BI 中公开提供连接器的要求。 没有设定的参与阈值。 但是，参与度越多，连接器的有证据需求就越强。

之所以存在这些先决条件，是为了确保正在接受认证的连接器具有重要的客户和业务需求，该需求在连接器完成认证后将得到使用并获得相应支持。

认证要求

我们对认证会有一组特定的要求。 我们认识到，并不是每个开发人员都能满足这些要求，我们希望引入一个功能集，能够在短时间内满足开发人员需求。

功能和样式

连接器必须遵循一组功能和样式规则，以满足与其他经认证连接器一致的可用性标准。

  • 连接器必须：

    • 使用节文档格式。
    • 包含节文档上方的版本标头/修饰。
    • 提供函数文档元数据。
    • 具有 TestConnection 处理程序。
    • 遵循命名约定（例如，DataSourceKind.FunctionName）。 它不应包含“Fabric”、“Power BI”、“连接器”或“API”之类的字词。
    • 以表格格式返回数据，将数据按列组织为表格，如同对关系数据源所做的一样。 不支持基于多维数据集、维度和度量值的多维格式。
    • 在 Import 和 DirectQuery 模式下的运作方式相同，返回相同的结果。
    • 在初始版本上，Beta 标志设置为 True。

  • FunctionName 应该对域（例如“内容”、“表”、“文档”、“数据库”等）有意义。

  • 连接器应：

    • 具有图标。
    • 提供导航表。
    • 将字符串放在 resources.resx 文件中。 URL 和值应在连接器代码中硬编码，而不是放在 resources.resx 文件中。

安全性

连接器必须处理特定安全注意事项。

  • 如果使用 Extension.CurrentCredentials()：

    • 是否需要使用？ 如果需要，会将凭据发送到何处？
    • 是否保证通过 HTTPS 发出请求？
    • 如果通过 GET 使用 Web.Contents() 发送凭据：
      • 可以将其变成 POST 吗？
      • 如果需要 GET，连接器必须使用 CredentialQueryString 选项记录中的 Web.Contents() 记录来传入敏感凭据。

  • 如果使用 Diagnostics.* 函数：

    • 验证正在跟踪的内容；数据不得包含 PII 或大量不必要的数据。
    • 如果在开发中实现了重要的跟踪，则应实现一个变量或功能标志，用于确定是否应启用跟踪。 在提交进行认证之前，必须将跟踪关闭。

  • 如果使用 Expression.Evaluate()：

    • 验证表达式的来源及其用途（即，可以动态构造对 Extension.CurrentCredentials() 的调用，诸如此类）。
    • Expression 不应由用户提供，也不应接受用户输入。
    • Expression 不应是动态的（也就是说，不应该从 Web 调用中检索）。

完成认证后

通过 Microsoft Fabric 和 Microsoft Power BI 体验认证并发布连接器后，应执行一些操作，以确保能够正确使用公开发布的生产部署级已认证连接器。

  • 你和最终用户都应使用认证之前环境中包含的已认证连接器版本（例如 Power BI Desktop 和数据网关），并移除认证之前使用的任何现有 .mez 或 .pqx 文件（自定义连接器）。 否则，可能会导致 Power Query 无意中使用测试自定义连接器，而不是新认证的连接器。
  • 自定义连接器应仅用于测试连接器的新版本。
  • 与最终用户和客户合作时，请确保在测试完成并且新的认证连接器版本可用后，移除在认证之前用于测试的自定义连接器版本。