閱讀英文

共用方式為


Data Factory 連接器認證

重要

連接器認證計劃目前正在進行變更,且新連接器認證的註冊目前為保留狀態。 一旦連接器認證計劃再次對新合作夥伴開放,本文將更新。 如果您有想要更新的認證連接器,請連絡我們的小組, dataconnectors@microsoft.com 以取得如何提交新版本的指示。 提交每個月都會處理,提交的截止日是每個月的第一個星期二。

為數據源開發自定義連接器的數據源擁有者,可能會想要更廣泛地將自定義連接器散發給 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認證聯繫人。

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

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

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

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

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

認證需求

我們有一組認證需求。 我們認識到,並非所有開發人員都能符合這些需求,而且我們希望引進一個功能集,以短時間內處理開發人員的需求。

功能和樣式

連接器必須遵循一組功能和樣式規則,以符合與其他認證連接器一致的可用性標準。

  • 連接器必須:

    • 使用區段檔格式。
    • 包含區段檔上方的版本標頭/裝飾
    • 提供 函式檔元數據
    • 具有 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 呼叫擷取)。

認證之後

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

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