分享方式：

Data Factory 連接器認證

  • 文章

注意

本文說明提交 Data Factory 連接器以進行認證的需求和程式。 在開始認證程式之前，請先仔細閱讀整篇文章。

為數據源開發自定義連接器的數據源擁有者，可能會想要更廣泛地將自定義連接器散發給 Data Factory 使用者。 一旦使用者建立、使用及驗證自定義連接器之後，數據源擁有者就可以提交它以進行Microsoft認證。

認證 Data Factory 連接器可在下列體驗中公開、現成、Microsoft Fabric Data Factory 和 Microsoft Power BI：

  • Microsoft Fabric 數據流 Gen2
  • Microsoft Power BI 數據流 Gen1
  • Microsoft Power BI Datamart
  • Microsoft Power BI 語意模型 （在 Power BI 服務中）
  • Microsoft Power BI Desktop
  • 適用於 Microsoft Fabric 和 Microsoft Power BI 的內部部署數據閘道

認證的連接器如下：

  • 由合作夥伴開發人員維護

  • 合作夥伴開發人員支援

  • 經 Microsoft 認證

  • 依Microsoft散發

我們與合作夥伴合作，嘗試確保他們在維護方面有支援，但連接器本身的客戶問題會導向合作夥伴開發人員。

注意

今天，您可以利用 Power Query SDK 來建立可透過 Data Factory 連接器認證計畫認證的連接器。 請前往 Power Query SDK 概觀 ，以深入瞭解此工具。

認證概觀

必要條件

為了確保客戶獲得最佳體驗，我們只會考慮符合一組認證必要條件的連接器：

  • 連接器必須為公用產品。

  • 針對初始版本，連接器必須視為程序代碼完整。 程式允許頻繁反覆專案和更新。 Microsoft不提供技術支援或自定義連接器開發諮詢。 我們建議使用公用資源，例如 SDK 檔和範例存放庫。 如果您需要進一步的協助，我們可以共用一份已知第三方產業自定義連接器開發顧問清單，您可能想要直接參與，與任何Microsoft計劃或合作關係分開。 Microsoft未隸屬於上述任何顧問，且不負責您使用其服務。 Microsoft提供清單以方便您，且沒有任何保證、建議或保證。 若要深入瞭解，請連絡您的Microsoft認證聯繫人。

  • 開發人員必須提供目前和未來使用量的估計值。

  • 連接器必須已提供給客戶直接使用，才能滿足使用者需求或商務案例。 透過將已完成的連接器直接散發給用戶和組織，即可使用 Private Preview 計劃來完成此準則。 我們建議連接器的開發人員使用 自我散發機制 ，並執行自己連接器的內部測試，以逐一查看受控制群組下的連接器。 每個使用者或組織都應該能夠提供意見反應和驗證，指出連接器有商務需求，且連接器能夠順利完成其商務需求。

  • 連接器必須在客戶預期的使用量層級順利運作。

  • 客戶所推動的 Fabric Ideas 論壇 中必須有一個線程，以指出在 Data Factory 和 / 或 Power BI 中公開提供連接器的需求。 沒有設定的參與閾值。 然而，參與度越強，連接器的證據要求就越強。

這些必要條件存在，以確保進行認證的連接器具有重要的客戶和業務需要用於和支持的認證后。

進程和時程表

認證連接器會隨著每月Power BI Desktop版本發行，因此每個版本的期限會從每個Power BI Desktop發行日期回溯。 認證程式從註冊到發行的預期持續時間會根據連接器提交的品質和複雜度而有所不同。 Microsoft不提供任何連接器檢閱和核准的特定時程表保證。 每個連接器檢閱的硬期限會在下列步驟中概述，但Microsoft不保證遵守這些時程表。

  • 註冊：意圖認證自定義連接器的通知。 此註冊必須在目標 Power BI Desktop 發行前的當月 15 日、兩個月進行。

    • 例如，針對 4 月 Power BI Desktop 版本，期限會是 2 月 15 日。

  • 提交：提交連接器檔案以進行Microsoft檢閱。 此提交必須發生在目標 Power BI Desktop 發行前一個月。

    • 例如，針對 4 月 Power BI Desktop 版本，期限會是 3 月 1 日。

  • 技術檢閱：連接器檔案的完成，通過Microsoft檢閱和認證。 此檢閱必須在目標 Power BI Desktop 發行前的當月 15 日進行。

    • 例如，針對 4 月 Power BI Desktop 版本，期限會是 3 月 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” 等字組。
    • 針對關係型數據源，以表格式格式傳回數據，組織成具有數據行的數據表。 不支援以 Cube、維度和量值為基礎的多維度格式。
    • 在 Import 和 DirectQuery 模式中的行為相同，並傳回相同的結果。
    • 在初始版本上，將 Beta 旗標設定為 True。

  • 對 FunctionName 定義域而言應該有意義（例如“Contents”、“Tables”、“Document”、“Databases”等等）。

  • 連接器應該：

    • 具有圖示。
    • 提供瀏覽數據表。
    • 將字串放在檔案中 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 呼叫擷取）。

註冊認證

如果您有興趣尋求自定義連接器的認證，請確定您的案例和連接器符合 本文中所述的必要 條件和 需求 。 若無法這麼做，會導致認證延遲，因為小組要求您在繼續進行認證之前，先修正任何問題或不一致。

請確定您的連接器程式代碼已完成，且已在Power BI Desktop 撰寫中進行測試，並在 Power BI 服務 中重新整理和取用。 請確定您已使用內部部署數據閘道在 Power BI 服務中測試完整的端對端重新整理。

若要開始使用，請完成我們的 註冊窗體，Microsoft聯繫人會連絡以開始程式。

認證之後

在連接器通過 Microsoft Fabric 和 Microsoft Power BI 體驗認證並發行之後，您應該執行一些動作，以確保您可以正確使用生產部署的公開可用認證連接器。

  • 您和終端用戶應該使用認證之前包含在環境中的認證連接器版本（例如 Power BI Desktop 和數據閘道），並移除認證之前使用的任何現有 .mez 或 .pqx 檔案 （自定義連接器）。 若無法這麼做，可能會導致Power Query 不小心使用測試自定義連接器，而不是新認證的連接器。
  • 自定義連接器只應該用來測試新版連接器。
  • 與終端使用者和客戶合作時，請確定他們了解在認證之前測試中使用的自定義連接器版本，應該在測試完成之後移除，並可使用新的認證連接器版本。