Power Query SDK 测试框架参考

此多部分参考介绍了 Power Query 连接器开发人员的标准测试套件的设置和运行。 引用应按顺序执行，以确保为测试扩展连接器设置环境。

此参考使用 Power Query SDK 测试框架、标准化测试套件和 NewYork City Taxi & Limousine Commission （TLC） 绿色行程记录数据的修改版本。 后续部分逐步讲解如何设置环境以验证扩展连接器。

测试框架允许 Power Query SDK 开发人员访问标准测试和测试工具，以验证扩展连接器的 DirectQuery （DQ） 功能。 借助这项新功能，开发人员有一种验证连接器的标准方式和用于添加自定义测试的平台。 我们设想这是增强 Power Query SDK 提供的测试工作流工作效率的第一步。

什么是 Power Query SDK 测试框架？

Power Query SDK 测试框架是一种现成to-go 的测试工具，具有预生成的测试，用于标准化新扩展连接器和现有扩展连接器的测试。 它能够大规模执行功能、合规性和回归测试。 它有助于满足全面测试框架的需求，以满足扩展连接器的需求。

开发人员工作流

以下列表是具有测试框架的典型 Power Query SDK 开发人员工作流：

1. 安装 Power Query SDK Visual Studio Code 扩展： 连接器开发人员必须 安装 PowerQuery SDK Visual Studio Code 扩展来开发扩展连接器。 Visual Studio Code 扩展包装了 Microsoft.PowerQuery.SdkTools NuGet 包，该包还包含测试工具 PQTest.exe。 PQTest 测试工具包含新的 compare 命令，用于执行测试框架中存在的测试。
2. 克隆 DataConnectors GitHub 存储库：克隆 DataConnectors GitHub 存储库以访问测试框架中包含的测试数据和测试。 有关这些测试的更多详细信息，请转到 PowerQuery SDK 测试框架第 3 部分 - 测试套件。
3. 将测试数据加载到数据源： 连接器开发人员必须将测试数据（由两个 CSV 文件组成）作为表加载到其数据源，这可确保架构与提供的 SQL 架构文件匹配。 有关更多详细信息，请转到 Power Query SDK 测试框架第 2 部分 - 测试数据。
4. 配置并运行测试： 然后，连接器开发人员必须使用提供的 RunPQSDKTestSuites PowerShell 实用工具运行测试，该实用工具使用 PQTest compare 命令运行测试。 有关更多详细信息，请转到 Power Query SDK 测试框架第 5 部分 - 测试扩展连接器。
5. 报告和 CI/CD： 默认测试报告在控制台中生成，还可以选择以摘要、详细、TRX 和 JSON 格式生成报表。 TRX（Visual Studio 测试结果文件）格式可用于在管道中运行时查看结果。 有关更多详细信息，请转到 Power Query SDK 测试框架第 7 部分 - 管道指南。

测试框架的目标

Power Query SDK 测试框架的长期目标是提供与 Visual Studio Code SDK 集成的可靠测试解决方案来测试扩展连接器。 它应极大地改善连接器开发的开发人员体验。 它还应将标准化引入相当分散的测试实践，最终提高质量条，减少连接器的持续工作量。

测试框架初始版本的目标是提供：

• 易于使用的命令行实用工具供用户轻松测试其扩展连接器： 测试框架引入了 PQTest compare 命令和直观的选项来运行测试。 它还提供 RunPQSDKTestSuites PowerShell 实用工具，这也有助于进行批处理测试。 提供简单且自动的配置来配置和运行测试。
• 就绪 -to-go 要执行的初始标准测试集以验证连接器： 测试框架提供一套健全性测试来验证测试表的架构、行计数和数据。 它还提供一个标准测试套件来验证数据类型、数学、日期、时间、文本函数、运算符和联接。
• 手动添加测试以扩展测试的轻松方法： 测试框架中的测试使用新的 PQ/PQOut 测试格式，通过最小化所需的配置来简化测试创建过程。 然后，连接器开发人员可以专注于为其测试创建 M 查询。 每个测试都是模块化的，并分为单独的文件，以简化维护。 预期输出也会在第一次运行中生成。
• 测试查询折叠测试的功能： 测试框架还可以为连接器生成诊断。 目前，诊断功能仅限于在基于 ODBC 的连接器的查询折叠期间生成 SQL 查询。 将来，此功能将扩展到其他诊断。

参考指南概述

在本指南中，你将：

• 了解 Power Query SDK 测试框架。
• 了解如何通过安装测试框架来设置开发环境。
• 提取测试套件中使用的数据集，并根据扩展连接器将其上传到数据源。
• 了解测试框架中的测试格式规范、文件格式及其功能。
• 提取并运行包含用于验证扩展连接器的测试的测试套件。
• 使用不同的配置运行单个测试。
• 添加自己的测试以验证连接器特定的功能。
• 通过为测试设置管道来自动执行测试运行。

部件