此多部分參考涵蓋 Power Query 連接器開發人員標準測試套件的設定和執行。 參考應該循序遵循，以確保您的環境已設定為測試延伸連接器。
此參考使用 Power Query SDK 測試架構、標準化測試套件，以及 紐約市計程車和豪華轎車委員會 （TLC） 綠色行程記錄資料的修改版本。 後續各節會逐步解說設定環境以驗證延伸模組連接器的步驟。
測試架構可讓 Power Query SDK 開發人員存取標準測試和測試工具，以驗證延伸模組連接器的 DirectQuery （DQ） 功能。 有了這項新功能，開發人員就有了驗證連接器的標準方法，以及新增自訂測試的平台。 我們設想這是提高 Power Query SDK 提供的測試工作流程生產力的第一步。
什麼是 Power Query SDK 測試架構？
Power Query SDK 測試架構是現成的測試工具to-go 具有預先建置的測試，可標準化新和現有擴充連接器的測試。 它能夠大規模執行功能、合規性和回歸測試。 它有助於滿足對全面測試框架的需求，以滿足擴展連接器的需求。
開發人員的工作流程
下列清單是使用測試架構的一般 Power Query SDK 開發人員工作流程：
- 安裝 Power Query SDK Visual Studio Code 延伸模組： 連接器開發人員必須 安裝 PowerQuery SDK Visual Studio Code 延伸模組，才能開發延伸模組連接器。 Visual Studio Code 延伸模組會包裝 Microsoft.PowerQuery.SdkTools NuGet 套件，其中也包含測試工具 PQTest.exe。 PQTest 測試工具包含新的 比較 命令，用於執行測試框架中存在的測試。
- 複製 DataConnectors GitHub 存放庫： 複製 DataConnectors GitHub 存放庫，以存取測試架構中包含的 測試資料 和 測試 。 如需這些測試的詳細資訊，請移至 PowerQuery SDK 測試架構第 3 部分 - 測試套件。
- 將測試資料載入至資料來源： 連接器開發人員必須將測試資料 （由兩個 CSV 檔案組成） 載入為其資料來源的資料表，以確保結構描述符合提供的 SQL 結構描述檔案。 如需詳細資訊，請移至 Power Query SDK 測試架構第 2 部分 - 測試資料。
- 設定並執行測試： 然後，連接器開發人員必須使用提供的 RunPQSDKTestSuites PowerShell 公用程式來執行測試，該公用程式會使用 PQTest 比較 命令來執行測試。 如需詳細資訊，請移至 Power Query SDK 測試架構第 5 部分 - 測試您的延伸模組連接器。
- 報告和 CI/CD： 預設測試報告是在主控台中產生，也有選項可以以摘要、詳細、TRX 和 JSON 格式產生報告。 TRX （Visual Studio 測試結果檔案） 格式有助於在結果作為管線的一部分執行時檢視結果。 如需詳細資訊，請移至 Power Query SDK 測試架構第 7 部分 - 管線指南。
測試架構的目標
Power Query SDK 測試架構的長期目標是提供與 Visual Studio Code SDK 整合的健全測試解決方案，以測試延伸模組連接器。 它應該會大幅改善開發人員開發連接器的體驗。 它還應該為相當分散的測試實踐帶來標準化，最終提高質量標準並減少連接器的維護工作。
測試架構初始版本的目標是提供：
- 易於使用的命令行實用程序，供用戶輕鬆測試其擴展連接器： 測試框架引入了 PQTest 比較 命令，其中包含用於運行測試的直觀選項。 它還提供了 RunPQSDKTestSuites PowerShell 實用程序，這也有助於批量測試。 提供了簡單和自動的配置來配置和運行測試。
- 就緒 -to-go 要執行的初始標準測試集，以驗證連接器： 測試框架提供了一套健全性測試來驗證測試表的架構、行計數和數據。 它還提供了一個標準測試套件來驗證數據類型、數學、日期、時間、文本函數、運算子和連接。
- 手動添加測試以擴展測試的輕鬆方法： 測試框架中的測試使用新的PQ/PQOut測試格式，通過最大限度地減少所需的配置來簡化測試創建過程。 然後，連接器開發人員可以專注於建立 M 查詢以進行測試。 每個測試都是模塊化的，並分離成單獨的文件，以簡化維護。 預期的輸出也會在第一次執行中產生。
- 能夠測試查詢折疊測試：測試架構也可以產生連接器的診斷。 目前，診斷功能僅限於在 ODBC 型連接器的查詢摺疊期間產生 SQL 查詢。 此功能將來擴展到其他診斷。
參考指南概觀
在本指南中，您可以：
- 瞭解 Power Query SDK 測試架構。
- 透過安裝測試框架來學習設定開發環境。
- 擷取測試套件中使用的資料集，並根據您的擴充功能連接器將它上傳至資料來源。
- 了解測試格式規範、文件格式及其在測試框架中的功能。
- 擷取並執行測試套件，其中包含驗證延伸模組連接器之測試。
- 使用不同的組態執行個別測試。
- 新增您自己的測試，以驗證連接器特定的功能。
- 藉由設定測試的管線來自動化測試執行。
組件
| 部分 | section | 詳細資訊 |
|---|---|---|
| 1 | 設定 | 設定您的環境。 |
| 2 | 準備資料 | 準備測試數據。 |
| 3 | 測試套件 | 擷取並瞭解測試套件。 |
| 4 | 測試格式規格 | 了解測試框架中使用的各種檔案格式。 |
| 5 | 連接器測試 | 測試您的擴充連接器。 |
| 6 | 新增測試 | 新增自己的測試，並了解測試框架中的各種選項和配置。 |
| 7 | 管線設定指南 | 在管線中執行測試。 |