SQL 分析工作流设计

Skill 标识
sql-analysis-skill

接口慢,不再只会建议“加个索引”。按八步检查条件、索引、JOIN、排序与深分页,输出风险等级和 EXPLAIN 验证方向,把慢查询线索变成能和开发讨论的分析依据。

扫码添加辅导员,发送 Skill 名称领取源码
本文目录
  1. Skill 概览
  2. 适合谁、用在什么场景
  3. 需要准备什么、能得到什么
  4. 核心能力与使用边界
  5. 实战教程与使用说明
  6. 零、开始之前:你将学会什么
  7. 0.1 环境准备
  8. 一、为什么测试人必须懂 SQL 风险
  9. ❌ 价值有限的 Bug
  10. ✅ 补充 SQL 分析后
  11. 动手做 ①(5 分钟)
  12. 二、为什么 SQL 分析必须工作流化
  13. 三、SQL 分析工作流总览(8 步)
  14. 四、动手搭建:从零写出完整 Skill 文件
  15. 4.1 输入契约 — references/sql_input_contract.yaml
  16. 4.2 SQL 高危信号规则库 — references/sql_risk_signals.md
  17. 4.3 输出格式 — outputs/SQL分析输出格式.md
  18. 4.4 核心工作流 — workflows/sql_analysis.md
  19. 4.5 注册到 SKILL.md
  20. 五、八步详解(每步检查清单 + 案例)
  21. 5.1 Step 1:SQL 风险识别
  22. 5.2 Step 2:where 条件分析
  23. 5.3 Step 3:索引判断
  24. 5.4 Step 4:慢查询判断
  25. 5.5 Step 5:join 风险
  26. 5.6 Step 6:order by 风险
  27. 5.7 Step 7–8:性能风险 + 优化建议(示例)
  28. 六、完整跟做案例:订单列表慢查询
  29. 6.1 准备样例 SQL
  30. 6.2 在 Cursor 中运行
  31. 6.3 合格输出要点(对照自检)
  32. 七、可选:本地 explain 验证(MySQL)
  33. 八、课堂练习:分析 join + 深分页 SQL
  34. 8.1 交付要求
  35. 8.2 参考答案要点
  36. 九、常见错误自查表
  37. 十、本节小结
  38. 附录 A:学习前可准备的附件资料清单
  39. A.1 必备(课前准备)
  40. A.2 进阶(有则加分)
  41. A.3 推荐目录结构
  42. A.4 工具与环境

Skill 概览

适合谁、用在什么场景

需要识别数据库风险、辅助定位接口性能问题的测试工程师。

需要准备什么、能得到什么

  • 输入材料:SQL、表结构、索引及可选的数据量、慢查询日志与 EXPLAIN。
  • 交付产物:结构化风险分析、P0/P1 风险提示、验证方法及优化建议。

核心能力与使用边界

  • 核心能力:将输入契约、高危信号规则、八步分析和输出模板拆成可维护文件。
  • 使用边界:不替 DBA 做最终调优;没有执行计划和真实数据分布时,性能判断只能作为待验证风险。

实战教程与使用说明

预计用时:90–120 分钟(含 2 处动手练习)。前置:了解 Skill 目录结构(4.1)、工作流化概念(5.1);建议已学 5.3 日志排查工作流。


零、开始之前:你将学会什么

学完能做什么

验收标准

说清楚 SQL 分析工作流的价值与 8 步链路

能向开发说明「为什么危险」而非只说「加索引」

独立编写 workflows/sql_analysis.md

文件含输入、8 步、输出、证据不足处理

用 AI 分析真实 SQL 并输出 P0/P1 风险

含验证方式(explain / 慢查询日志)

0.1 环境准备

bash
mkdir -p sql_analysis_skill/{workflows,outputs,references,assets/sample_sql}
cd sql_analysis_skill

核心观念:SQL 分析工作流的目的,不是替 DBA 调优,而是让测试人具备第一轮数据库风险识别能力,输出可和开发沟通的结构化结论。


一、为什么测试人必须懂 SQL 风险

很多线上问题最后都藏在 SQL 里:接口慢、页面卡、订单异常、数据不一致,表面是业务 Bug,底层常是查询、索引、事务或数据量问题。

❌ 价值有限的 Bug

text
订单列表响应慢,请开发查看

✅ 补充 SQL 分析后

text
疑似 order_info 大表查询未命中索引;
where 含 status + order by create_time 有排序风险;
建议 explain 检查 filesort / 全表扫描。

动手做 ①(5 分钟)

找一条你项目里「接口慢」相关的 SQL(可脱敏),用一句话对比:只报现象 vs 补充 SQL 方向,开发收到后的差异。


二、为什么 SQL 分析必须工作流化

很多测试人看 SQL 只关心「能不能查出结果」。高级测试还会看:性能、索引命中、数据量、排序、联表、锁、慢查询。

sql
SELECT * FROM order_info WHERE status = 1 ORDER BY create_time DESC;

新人视角

工作流视角

能查出订单

select *、status 区分度、order by 索引、大表全扫风险

SQL 分析工作流 = 把「看 SQL 经验」拆成 AI 可逐步执行的检查路径;禁止一上来就说「建议加索引」。


三、SQL 分析工作流总览(8 步)

text
① 输入 SQL + 业务上下文
    ↓
② SQL 风险识别(高危写法)
    ↓
③ where 条件分析
    ↓
④ 索引判断
    ↓
⑤ 慢查询判断
    ↓
⑥ join 风险分析
    ↓
⑦ order by 风险分析
    ↓
⑧ 性能风险输出 + 优化建议(含风险等级)

四、动手搭建:从零写出完整 Skill 文件

4.1 输入契约 — references/sql_input_contract.yaml

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

markdown
# SQL 高危信号(Step 2 必读)

- select *
- 无 where / where 字段无索引
- like '%关键词%'
- 函数包裹索引字段:date(create_time)
- 隐式类型转换
- 深分页:limit 100000, 20
- update/delete 无 where
- 大表 join 大表且无过滤
- group by 大表

4.3 输出格式 — outputs/SQL分析输出格式.md

markdown
# 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

复制以下内容到文件(可按项目改表名):

markdown
# 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

markdown
---
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 风险识别

sql
SELECT * FROM user_log WHERE date(create_time) = '2026-05-20';

应识别:date() 包裹索引字段致索引失效;select *;user_log 大表慢查询风险。

5.2 Step 2:where 条件分析

sql
SELECT order_no, status FROM order_info WHERE status = 1;

要点:status 区分度可能低;大表仅按 status 过滤扫描量大 → 建议加 user_id、create_time 或时间范围。

5.3 Step 3:索引判断

sql
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:慢查询判断

sql
SELECT * FROM order_info ORDER BY create_time DESC LIMIT 100000, 20;

风险:深分页;跳过 10 万行。建议游标分页(基于 id/create_time)。

5.5 Step 5:join 风险

sql
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:性能风险 + 优化建议(示例)

markdown
**风险类型**:慢查询(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:

sql
SELECT * FROM order_info
WHERE status = 1
ORDER BY create_time DESC
LIMIT 100000, 20;

6.2 在 Cursor 中运行

text
@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 执行:

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(必做):

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 参考答案要点

text
风险识别: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 + 业务影响


十、本节小结

text
SQL 分析工作流 =
风险识别 + where + 索引 + 慢查询
+ join + order by + 性能风险 + 优化建议

测试人不必替 DBA 做最终调优,但必须能借助 AI 做第一轮 SQL 风险识别,提前发现慢查询、索引与大数据量风险。


附录 A:学习前可准备的附件资料清单

资料越真实,workflow 输出越贴近项目。建议放入 assets/ 与 references/。

A.1 必备(课前准备)

编号

资料

用途

A1

3~5 条真实慢 SQL(脱敏)

assets/sample_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.md

  • A8 接口与 SQL 映射表(哪个 API 用哪条 SQL)

  • A9 空白 workflows/sql_analysis.md + SKILL.md 骨架(见第四节)

  • A10 错误范例:只有「建议加索引」的 AI 输出(用于课堂对比)

A.3 推荐目录结构

text
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全文档:

开始使用 sql-analysis-skill

扫码添加辅导员,发送 Skill 名称,领取源码与配套资料。

同类 Skills