本文为SQL Tuning Guide 第21章“Gathering Diagnostic Data with SQL Test Case Builder”的笔记。
SQL Test Case Builder 是一种工具，可自动收集在不同数据库实例中重现问题所需的信息。
SQL 测试用例是一组信息，使开发人员能够为遇到性能问题的特定 SQL 语句重现执行计划。
22.1 Purpose of SQL Test Case Builder
SQL Test Case Builder 自动收集和再现有关问题及其发生环境的信息。
对于大多数 SQL 组件，获得可重现的测试用例是影响 bug 解决速度的最重要因素。 对用户来说也是最长最痛苦的一步。 SQL Test Case Builder 的目标是尽可能多地收集与 SQL 事件相关的信息，然后以一种使 Oracle 员工能够在不同系统上重现问题的方式将其打包。
SQL Test Case Builder 的输出是预定义目录中的一组脚本。 这些脚本包含在另一个数据库实例上重新创建所有必要对象和环境所需的命令。 测试用例准备就绪后，您可以创建目录的 zip 文件并将其移动到另一个数据库，或者将文件上传到 Oracle 支持。
22.2 Concepts for SQL Test Case Builder
SQL Test Case Builder 的关键概念包括 SQL 事件、记录的信息类型和输出形式。
22.2.1 SQL Incidents
在 Oracle 数据库的故障诊断基础设施中，一个事件是一个问题的单次出现。
SQL 事件是与 SQL 相关的问题。 当多次出现问题（严重错误）时，数据库会为每次出现的事件创建一个事件。 事件在自动诊断存储库 (ADR) 中带有时间戳和跟踪。 每个事件都有一个数字事件 ID，它在 ADR 中是唯一的。
SQL Test Case Builder 可随时在命令行上访问。 在 Oracle Enterprise Manager Cloud Control (Cloud Control) 中，SQL 测试用例页面仅在发现 SQL 事件后可用。