Power Query 連線 or 認證

  • 發行項

注意

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

簡介

有了 Power Query SDK，每個人都有權建立自定義 Power Query 連接器，以從 Power Query 連線到數據源。 目前，自定義連接器僅支援Power BI語意模型（Power BI Desktop和 Power BI 服務），而且需要使用內部部署數據網關透過 Power BI 服務 重新整理。 自定義連接器必須由開發人員個別散發。

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

認證 Power Query 自定義連接器可在 Power BI 語意模型內公開、現成可用的連接器（Power BI Desktop 和 Power BI 服務）、Power BI 數據流和 Power BI 數據超市。 PowerBI.com 和所有版本的Power BI 進階版都支援認證連接器。

認證的連接器如下：

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

  • 合作夥伴開發人員支援

  • 由 Microsoft 認證

  • 由 Microsoft 散發

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

認證的連接器和自定義連接器差異

認證的連接器會隨附於Power BI Desktop 中現成可用的連接器，並部署至Power BI服務、Power BI資料流和Power BI資料超市。 自定義連接器僅在Power BI語意模型中受到支援，而且必須在Power BI Desktop中載入，如在Power BI Desktop 中載入延伸模組中所述。 透過實作 Test 連線 ion，即可透過 Power BI Desktop 或 Power BI 服務來重新整理認證和自定義連接器。 自訂連接器需要內部部署數據閘道。

具有實作的Power BI Desktop TestConnection 認證連接器也支援透過雲端進行端對端重新整理（Power BI 服務），而不需要內部部署數據閘道。 Power BI 服務 環境基本上會裝載類似內部部署閘道執行的「雲端閘道」。 認證之後，我們會將您的連接器部署到此環境，以便可供所有 Power BI 客戶使用。

具有額外元件的自定義和認證連接器（例如 ODBC 驅動程式）都需要在終端使用者電腦上安裝額外的元件，而且需要內部部署數據網關，除非額外元件部署至 Power BI 雲端。 目前，我們不會向Power BI雲端認證及部署任何新的額外元件，因此具有額外元件相依性之連接器的認證不會移除內部部署數據網關需求。

自定義連接器散發

自定義連接器可以在認證之前散發給終端使用者。

M 是一種多功能的語言，如處理驗證中所見，有能力與預存認證互動，因此我們必須讓用戶能夠只允許受信任的連接器執行。

從開發人員的觀點來看，開發人員需要 自行簽署 其自定義連接器，併為使用者提供資訊（指紋）以安全地載入它。

從用戶的觀點來看，用戶必須使用開發人員的指紋，安全地 信任並載入自定義連接器 以供使用。 或者，用戶可以選擇降低其安全性設定，以允許載入 Microsoft 或其他開發人員未通過認證的程式代碼，但不建議使用此選項。

認證概觀

必要條件

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

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

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

  • 開發人員必須提供使用量的估計值。 我們建議非常精品產品的連接器開發人員使用我們的 連接器自我簽署功能 ，直接提供給客戶。

  • 連接器必須已提供給客戶直接使用，才能滿足使用者需求或商務案例。 您可以透過自我簽署，將已完成的連接器直接散發給使用者和組織，藉此使用 Private Preview 計劃來完成此準則。 每個使用者或組織都應該能夠提供意見反應和驗證，指出連接器有商務需求，且連接器能夠順利完成其商務需求。

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

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

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

進程和時程表

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

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

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

  • 提交：提交連接器檔案以供 Microsoft 檢閱。 此提交必須在目標 Power BI Desktop 發行前的當月 1 日發生。

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

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

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

由於技術檢閱和潛在延遲、重新架構和測試問題的複雜性， 我們強烈建議儘早提交初始發行和認證的前置時間。 如果您覺得連接器對於提供少數額外負荷的客戶很重要，建議您 自行簽署 ，並以這種方式提供。

認證需求

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

提交檔案 （成品）

請確定您提交的連接器檔案包含下列所有專案：

  • 連線 or （.mez） 檔案

    • .mez 檔案應遵循樣式標準，且名稱與產品或服務名稱類似。 它不應該包含 「Power BI」、“連線 or” 或 “API” 等字組。
    • 將 .mez 檔案命名為： ProductName.mez

  • 用於測試的 Power BI Desktop （.pbix） 檔案

    • 我們需要範例 Power BI 報表 （.pbix） 來測試您的連接器。
    • 報表應該包含至少一個查詢，以測試導覽數據表中的每個專案。
    • 如果沒有設定的架構（例如資料庫），報表必須包含連接器可能處理之每個數據表「類型」的查詢。

  • 測試數據源的帳戶

    • 我們會使用測試帳戶來測試和疑難解答您的連接器。
    • 提供持續性的測試帳戶，因此我們可以使用相同的帳戶來認證任何未來的更新。

  • 測試指示

    • 提供有關如何使用連接器並測試其功能的任何檔。

  • 外部相依性的連結（例如 ODBC 驅動程式）

功能和樣式

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

  • 連接器必須：

  • 對 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 聯繫人會連絡以開始程式。

認證之後

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

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

開發數據源的連接器之後，請考慮建立 範本應用程式，協助客戶快速啟動並執行。 範本應用程式為客戶提供連線到其數據的預先建置報表，讓他們可以視需要使用現成可用的報表或自定義。

注意

範本應用程式不支援需要閘道的連接器。