SQL 分析工作流设计
- Skill 标识
sql-analysis-skill- 所属分类
- 软件测试 / 缺陷与故障分析
接口慢,不再只会建议“加个索引”。按八步检查条件、索引、JOIN、排序与深分页,输出风险等级和 EXPLAIN 验证方向,把慢查询线索变成能和开发讨论的分析依据。
本文目录
- Skill 概览
- 适合谁、用在什么场景
- 需要准备什么、能得到什么
- 核心能力与使用边界
- 实战教程与使用说明
- 零、开始之前:你将学会什么
- 0.1 环境准备
- 一、为什么测试人必须懂 SQL 风险
- ❌ 价值有限的 Bug
- ✅ 补充 SQL 分析后
- 动手做 ①(5 分钟)
- 二、为什么 SQL 分析必须工作流化
- 三、SQL 分析工作流总览(8 步)
- 四、动手搭建:从零写出完整 Skill 文件
- 4.1 输入契约 — references/sql_input_contract.yaml
- 4.2 SQL 高危信号规则库 — references/sql_risk_signals.md
- 4.3 输出格式 — outputs/SQL分析输出格式.md
- 4.4 核心工作流 — workflows/sql_analysis.md
- 4.5 注册到 SKILL.md
- 五、八步详解(每步检查清单 + 案例)
- 5.1 Step 1:SQL 风险识别
- 5.2 Step 2:where 条件分析
- 5.3 Step 3:索引判断
- 5.4 Step 4:慢查询判断
- 5.5 Step 5:join 风险
- 5.6 Step 6:order by 风险
- 5.7 Step 7–8:性能风险 + 优化建议(示例)
- 六、完整跟做案例:订单列表慢查询
- 6.1 准备样例 SQL
- 6.2 在 Cursor 中运行
- 6.3 合格输出要点(对照自检)
- 七、可选:本地 explain 验证(MySQL)
- 八、课堂练习:分析 join + 深分页 SQL
- 8.1 交付要求
- 8.2 参考答案要点
- 九、常见错误自查表
- 十、本节小结
- 附录 A:学习前可准备的附件资料清单
- A.1 必备(课前准备)
- A.2 进阶(有则加分)
- A.3 推荐目录结构
- A.4 工具与环境
Skill 概览
适合谁、用在什么场景
需要识别数据库风险、辅助定位接口性能问题的测试工程师。
需要准备什么、能得到什么
- 输入材料:SQL、表结构、索引及可选的数据量、慢查询日志与 EXPLAIN。
- 交付产物:结构化风险分析、P0/P1 风险提示、验证方法及优化建议。
核心能力与使用边界
- 核心能力:将输入契约、高危信号规则、八步分析和输出模板拆成可维护文件。
- 使用边界:不替 DBA 做最终调优;没有执行计划和真实数据分布时,性能判断只能作为待验证风险。
实战教程与使用说明
预计用时:90–120 分钟(含 2 处动手练习)。前置:了解 Skill 目录结构(4.1)、工作流化概念(5.1);建议已学 5.3 日志排查工作流。
零、开始之前:你将学会什么
学完能做什么 | 验收标准 |
|---|---|
说清楚 SQL 分析工作流的价值与 8 步链路 | 能向开发说明「为什么危险」而非只说「加索引」 |
独立编写 | 文件含输入、8 步、输出、证据不足处理 |
用 AI 分析真实 SQL 并输出 P0/P1 风险 | 含验证方式(explain / 慢查询日志) |
0.1 环境准备
mkdir -p sql_analysis_skill/{workflows,outputs,references,assets/sample_sql}
cd sql_analysis_skill
核心观念:SQL 分析工作流的目的,不是替 DBA 调优,而是让测试人具备第一轮数据库风险识别能力,输出可和开发沟通的结构化结论。
一、为什么测试人必须懂 SQL 风险
很多线上问题最后都藏在 SQL 里:接口慢、页面卡、订单异常、数据不一致,表面是业务 Bug,底层常是查询、索引、事务或数据量问题。
❌ 价值有限的 Bug
订单列表响应慢,请开发查看
✅ 补充 SQL 分析后
疑似 order_info 大表查询未命中索引;
where 含 status + order by create_time 有排序风险;
建议 explain 检查 filesort / 全表扫描。
动手做 ①(5 分钟)
找一条你项目里「接口慢」相关的 SQL(可脱敏),用一句话对比:只报现象 vs 补充 SQL 方向,开发收到后的差异。
二、为什么 SQL 分析必须工作流化
很多测试人看 SQL 只关心「能不能查出结果」。高级测试还会看:性能、索引命中、数据量、排序、联表、锁、慢查询。
SELECT * FROM order_info WHERE status = 1 ORDER BY create_time DESC;
新人视角 | 工作流视角 |
|---|---|
能查出订单 | select *、status 区分度、order by 索引、大表全扫风险 |
SQL 分析工作流 = 把「看 SQL 经验」拆成 AI 可逐步执行的检查路径;禁止一上来就说「建议加索引」。
三、SQL 分析工作流总览(8 步)
① 输入 SQL + 业务上下文
↓
② SQL 风险识别(高危写法)
↓
③ where 条件分析
↓
④ 索引判断
↓
⑤ 慢查询判断
↓
⑥ join 风险分析
↓
⑦ order by 风险分析
↓
⑧ 性能风险输出 + 优化建议(含风险等级)
四、动手搭建:从零写出完整 Skill 文件
4.1 输入契约 — references/sql_input_contract.yaml
sql: |
SELECT * FROM order_info WHERE status = 1
ORDER BY create_time DESC LIMIT 100000, 20;
tables: [order_info]
business_scene: 订单列表查询
data_volume: 订单表 500 万+ 行
api_name: GET /api/orders
symptom: 列表加载慢,偶发超时
environment: production
has_explain: false # 若有执行计划,设为 true 并附 explain 结果
4.2 SQL 高危信号规则库 — references/sql_risk_signals.md
# SQL 高危信号(Step 2 必读)
- select *
- 无 where / where 字段无索引
- like '%关键词%'
- 函数包裹索引字段:date(create_time)
- 隐式类型转换
- 深分页:limit 100000, 20
- update/delete 无 where
- 大表 join 大表且无过滤
- group by 大表
4.3 输出格式 — outputs/SQL分析输出格式.md
# SQL 分析输出格式
## 必须按顺序输出 8 个小节
1. SQL 风险识别
2. where 条件分析
3. 索引判断
4. 慢查询判断
5. join 风险(无 join 写「不适用」)
6. order by 风险
7. 性能风险(类型/原因/影响/表现/验证方式/风险等级 P0-P2)
8. 优化建议(至少 3 条,须含 explain 验证)
## 禁止
- 无依据断言「必须加索引 xxx」
- 跳过验证方式
4.4 核心工作流 — workflows/sql_analysis.md
复制以下内容到文件(可按项目改表名):
# SQL 分析工作流
## 执行前加载
- references/sql_input_contract.yaml(用户填写)
- references/sql_risk_signals.md
- outputs/SQL分析输出格式.md
## 输入(必填)
- sql:待分析语句
- tables:涉及表
- business_scene / data_volume / api_name / symptom
## 步骤(必须逐步输出,禁止跳步)
### Step 1 SQL 风险识别
对照 sql_risk_signals.md,列出命中项(select *、深分页等)。
### Step 2 where 条件分析
- 是否有 where?能否缩小扫描范围?
- 字段区分度(如 status=1 是否过低)
- 函数/隐式转换/ or / 前缀模糊
### Step 3 索引判断
- 建议检查的索引组合(不写死「必须加」,写「建议验证」)
- where / join / order by 字段是否与索引左前缀一致
### Step 4 慢查询判断
- 扫描行数风险、返回字段过多、锁等待可能
### Step 5 join 风险
- 关联字段索引、先过滤再 join、大表 join 成本
### Step 6 order by 风险
- filesort 可能、排序前数据量是否过大
### Step 7 性能风险输出
| 字段 | 内容 |
|------|------|
| 风险类型 | 如慢查询/全表扫描 |
| 风险原因 | |
| 影响范围 | 接口/模块 |
| 可能表现 | 超时、CPU 升高等 |
| 验证方式 | explain、慢查询日志 |
| 风险等级 | P0/P1/P2 |
### Step 8 优化建议
至少 3 条,须可执行,并说明「改哪里、查哪里、验证哪里」。
## 证据不足时
若缺少表结构/数据量/explain,输出「待补充信息」清单,禁止猜根因。
4.5 注册到 SKILL.md
---
name: sql-analysis
description: SQL 性能风险分析。触发:分析SQL、慢查询、索引、explain。
---
用户给出 SQL 时:
1. 要求按 references/sql_input_contract.yaml 补全上下文
2. 严格执行 workflows/sql_analysis.md 八步
3. 输出必须符合 outputs/SQL分析输出格式.md
操作检查:上述 4 个文件已创建 → 进入第五节分步详解与案例。
五、八步详解(每步检查清单 + 案例)
5.1 Step 1:SQL 风险识别
SELECT * FROM user_log WHERE date(create_time) = '2026-05-20';
应识别:date() 包裹索引字段致索引失效;select *;user_log 大表慢查询风险。
5.2 Step 2:where 条件分析
SELECT order_no, status FROM order_info WHERE status = 1;
要点:status 区分度可能低;大表仅按 status 过滤扫描量大 → 建议加 user_id、create_time 或时间范围。
5.3 Step 3:索引判断
SELECT * FROM order_info
WHERE user_id = 1001 AND status = 1
ORDER BY create_time DESC;
建议验证:是否存在联合索引 (user_id, status, create_time);explain 是否 Using filesort。
5.4 Step 4:慢查询判断
SELECT * FROM order_info ORDER BY create_time DESC LIMIT 100000, 20;
风险:深分页;跳过 10 万行。建议游标分页(基于 id/create_time)。
5.5 Step 5:join 风险
SELECT o.order_no, u.mobile
FROM order_info o
LEFT JOIN user_info u ON o.user_id = u.id
WHERE o.status = 1;
检查:o.user_id、u.id 索引;status=1 数据量大时 join 成本高 → 先缩小订单范围。
5.6 Step 6:order by 风险
与 where、limit 组合看排序前数据量;联合索引是否覆盖 order by。
5.7 Step 7–8:性能风险 + 优化建议(示例)
**风险类型**:慢查询(P1)
**原因**:status 低区分度 + order by create_time + 深分页
**验证**:EXPLAIN + 慢查询日志(>1s)
**建议**:
1. 避免 select *,只查列表必要字段
2. 增加 create_time 范围过滤
3. 深分页改游标;与开发确认 (status, create_time) 索引
六、完整跟做案例:订单列表慢查询
6.1 准备样例 SQL
保存为 assets/sample_sql/order_list_slow.sql:
SELECT * FROM order_info
WHERE status = 1
ORDER BY create_time DESC
LIMIT 100000, 20;
6.2 在 Cursor 中运行
@sql_analysis_skill/workflows/sql_analysis.md
@sql_analysis_skill/assets/sample_sql/order_list_slow.sql
业务:订单列表;表 500 万行;现象:接口超时。
请严格按八步输出,风险等级 P0/P1/P2。
6.3 合格输出要点(对照自检)
命中:select *、status 过滤、order by、深分页
索引:建议验证 (status, create_time) 及 explain
优化:字段精简、游标分页、时间范围
含验证方式,非空泛「加索引」
七、可选:本地 explain 验证(MySQL)
若有测试库权限,可对样例 SQL 执行:
EXPLAIN SELECT * FROM order_info
WHERE status = 1
ORDER BY create_time DESC
LIMIT 100000, 20;
关注列:type、rows、Extra(Using filesort / Using temporary)。将结果贴回 AI 对话,要求修正分析。
八、课堂练习:分析 join + 深分页 SQL
练习 SQL(必做):
SELECT * FROM order_info o
LEFT JOIN user_info u ON o.user_id = u.id
WHERE o.status = 1
ORDER BY o.create_time DESC
LIMIT 50000, 20;
8.1 交付要求
按八步输出完整报告(Markdown)
性能风险含 P 等级与验证方式
优化建议 ≥3 条且可执行
8.2 参考答案要点
风险识别:select *、left join、status 低区分、order by、深分页
where:status=1 难缩范围
索引:o.user_id、u.id、o.create_time 相关索引需 explain
慢查询:深分页+排序叠加 → 高风险
join:大表 join,先过滤
优化:字段精简、时间范围、游标分页、explain 验证
九、常见错误自查表
错误 | 正确做法 |
|---|---|
只看 SQL 能否查出数据 | 必须走 8 步性能检查 |
一见慢就说「加索引」 | 先分析 where/join/order by/数据量 |
不看数据量级 | 输入契约必填 data_volume |
不要求 explain | 验证方式必须写 explain/慢日志 |
无风险等级 | P0/P1/P2 + 业务影响 |
十、本节小结
SQL 分析工作流 =
风险识别 + where + 索引 + 慢查询
+ join + order by + 性能风险 + 优化建议
测试人不必替 DBA 做最终调优,但必须能借助 AI 做第一轮 SQL 风险识别,提前发现慢查询、索引与大数据量风险。
附录 A:学习前可准备的附件资料清单
资料越真实,workflow 输出越贴近项目。建议放入 assets/ 与 references/。
A.1 必备(课前准备)
编号 | 资料 | 用途 |
|---|---|---|
A1 | 3~5 条真实慢 SQL(脱敏) |
|
A2 | 核心表数据量说明(订单/用户/支付) | 输入契约 data_volume |
A3 | 表结构 DDL 或字段清单(含索引) | 索引判断、join 分析 |
A4 | 1~2 份 EXPLAIN 结果截图/文本 | 对照 AI 分析是否准确 |
A5 | 团队 P0/P1/P2 定义(接口级) | 风险等级输出 |
A.2 进阶(有则加分)
A6 慢查询日志样例(>1s 的 SQL 原文)
A7 历史「SQL 导致的事故」RCA 1 份 → 写入
references/sql_incident_patterns.mdA8 接口与 SQL 映射表(哪个 API 用哪条 SQL)
A9 空白
workflows/sql_analysis.md+SKILL.md骨架(见第四节)A10 错误范例:只有「建议加索引」的 AI 输出(用于课堂对比)
A.3 推荐目录结构
sql_analysis_skill/
├── SKILL.md
├── workflows/
│ └── sql_analysis.md
├── outputs/
│ └── SQL分析输出格式.md
├── references/
│ ├── sql_input_contract.yaml
│ ├── sql_risk_signals.md
│ └── sql_incident_patterns.md # 可选
└── assets/
└── sample_sql/
├── order_list_slow.sql
└── order_join_deep_page.sql
A.4 工具与环境
Cursor / Claude Code(@ 引用 workflow 与样例 SQL)
可选:MySQL 测试库 + EXPLAIN 权限
可选:慢查询平台(如 Percona、云 RDS 慢日志)只读账号
本节课对应的skill全文档:
扫码添加辅导员,发送 Skill 名称,领取源码与配套资料。