Power Query SDK 测试框架参考
此参考包含多个部分，介绍适用于 Power Query 连接器开发人员的标准测试套件的设置和运行。 应按顺序执行参考，以确保将环境设置用于测试扩展连接器。
此参考使用 Power Query SDK 测试框架、标准化测试套件以及纽约市出租车和豪华轿车委员会 (TLC) 绿色出行记录数据的修改版本。 后续部分将逐步介绍设置环境以验证扩展连接器的步骤。
该测试框架允许 Power Query SDK 开发人员访问标准测试和测试工具来验证扩展连接器的 DirectQuery (DQ) 功能。 借助这项新功能，开发人员可以采用标准方法来验证连接器，并提供一个用于添加自定义测试的平台。 我们将此视为提高 Power Query SDK 提供的测试工作流程生产力的第一步。
Power Query SDK 测试框架是什么？
Power Query SDK 测试框架是一个现成的测试工具，具有预构建的测试，可标准化新的和现有的扩展连接器的测试。 它能够大规模执行功能性、合规性和回归测试。 它有助于满足对综合测试框架的需求，以满足扩展连接器的需求。
面向开发人员的工作流
以下列表是使用测试框架的典型 Power Query SDK 开发人员工作流程：
- 安装 Power Query SDK Visual Studio Code 扩展：连接器开发人员必须安装 PowerQuery SDK Visual Studio Code 扩展才能开发扩展连接器。 Visual Studio Code 扩展包装了 Microsoft.PowerQuery.SdkTools NuGet 包，其中还包含测试工具 PQTest.exe。 PQTest 测试工具包含新的 compare 命令，用于执行测试框架中存在的测试。
- 克隆 DataConnectors GitHub 存储库：克隆 DataConnectors GitHub 存储库以访问测试框架中包含的测试数据和测试。 有关这些测试的更多详细信息，请转到 PowerQuery SDK 测试框架第 3 部分 - 测试套件。
- 将测试数据加载到数据源：连接器开发人员必须将由两个 CSV 文件组成的测试数据作为表加载到其数据源，以确保架构与提供的 SQL 架构文件相匹配。 有关更多详细信息，请转到 Power Query SDK 测试框架第 2 部分 - 测试数据。
- 配置并运行测试：连接器开发人员必须使用提供的 RunPQSDKTestSuites PowerShell 实用程序运行测试，该实用程序使用 PQTest compare 命令来运行测试。 有关更多详细信息，请转到 Power Query SDK 测试框架第 5 部分 - 测试扩展连接器。
- 报告和 CI/CD：默认测试报告在控制台中生成，还可以选择生成摘要、详细、TRX 和 JSON 格式的报告。 TRX（Visual Studio 测试结果文件）格式对于查看作为管道的一部分运行的结果非常有用。 有关更多详细信息，请参阅 Power Query SDK 测试框架第 7 部分 - 管道指南。
测试框架的目标
Power Query SDK 测试框架的长期目标是提供与 Visual Studio Code SDK 集成的强大测试解决方案来测试扩展连接器。 它应该会大大改善开发人员的连接器开发体验。 它还应将标准化引入极为分散的测试实践，最终提高质标准并减少连接器的维护工作。 我们还设想将测试框架插入连接器认证流程并增强合作伙伴的体验。
测试框架初始版本旨在提供：
- 易于使用的命令行实用程序，让用户可以轻松测试其扩展连接器：测试框架引入了 PQTest compare 命令以及运行测试的直观选项。 它还提供 RunPQSDKTestSuites PowerShell 实用程序，这也有助于进行批量测试。 提供简单且自动的配置来配置和运行测试。
- 一组现成的初始标准测试，以验证连接器：测试框架提供了一套健全性测试来验证测试表的架构、行计数和数据。 它还提供了一个标准测试套件来验证数据类型、数学、日期、时间、文本函数、运算符和连接。
- 手动添加测试以扩展测试的轻松方式：测试框架中的测试使用新的 PQ/PQOut 测试格式，该格式通过最大限度地减少所需的配置来简化测试创建过程。 然后，连接器开发人员就可以专注于创建用于测试的 M 查询。 每个测试都是模块化的，并分为多个单独的文件，以简化维护。 第一次运行时也会生成预期的输出。
- 测试查询折叠测试的能力：测试框架还可以生成连接器的诊断信息。 目前，诊断功能仅限于基于 ODBC 连接器的查询折叠期间的 SQL 查询生成。 将来，该功能还将扩展到其他诊断。
参考指南概述
在本指南中，你将：
- 了解 Power Query SDK 测试框架。
- 了解如何通过安装测试框架来设置开发环境。
- 获取测试套件中使用的数据集并基于扩展连接器将其上传到数据源。
- 了解测试框架中的测试格式规范、文件格式及其功能。
- 提取并运行包含用于验证扩展连接器的测试的测试套件。
- 使用不同的配置运行单个测试。
- 添加自己的测试以验证特定于连接器的功能。
- 通过为测试设置管道来自动执行测试运行。
组成部分
| 组成部分 | 部分 | 详细信息 |
|---|---|---|
| 1 | 设置 | 设置环境 |
| 2 | 准备数据 | 准备测试数据。 |
| 3 | 测试套件 | 提取和了解测试套件。 |
| 4 | 测试格式规范 | 了解测试框架中使用的各种文件格式。 |
| 5 | 连接器测试 | 测试扩展连接器。 |
| 6 | 添加测试 | 添加自己的测试并了解测试框架中的各种选项和配置。 |
| 7 | 管道设置指南 | 在管道中运行测试。 |