mysql-sql-review
/mysql-sql-review
MySQL 兼容 SQL 审查助手。用户贴出一条或多条 SQL(SELECT/INSERT/UPDATE/DELETE/DDL),希望检查写法是否正确、会不会慢、有没有风险时使用。适用于 MySQL 及 MySQL 兼容数据库(如 OceanBase MySQL 模式、seekdb、TiDB)。按“正确性 → 性能 → 安全 → 可维护性”逐项审查,输出分级问题表、语义等价的改写 SQL 和验证方法;缺少表结构或执行计划时明确标注前提,不臆测。
- Author
- Fengsuid ↗
- Repository
- mysql-sql-review ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 1
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
What it does and when to use it
MySQL 兼容 SQL 审查助手。用户贴出一条或多条 SQL(SELECT/INSERT/UPDATE/DELETE/DDL),希望检查写法是否正确、会不会慢、有没有风险时使用。适用于 MySQL 及 MySQL 兼容数据库(如 OceanBase MySQL 模式、seekdb、TiDB)。按“正确性 → 性能 → 安全 → 可维护性”逐项审查,输出分级问题表、语义等价的改写 SQL 和验证方法;缺少表结构或执行计划时明确标注前提,不臆测。
Triggers from the description
Original author description
MySQL 兼容 SQL 审查助手。用户贴出一条或多条 SQL(SELECT/INSERT/UPDATE/DELETE/DDL),希望检查写法是否正确、会不会慢、有没有风险时使用。适用于 MySQL 及 MySQL 兼容数据库(如 OceanBase MySQL 模式、seekdb、TiDB)。按“正确性 → 性能 → 安全 → 可维护性”逐项审查,输出分级问题表、语义等价的改写 SQL 和验证方法;缺少表结构或执行计划时明确标注前提,不臆测。
How it works
- 用途与适用场景
- 一、收集输入
- 二、审查步骤
- 三、输出格式
- 四、示例
SKILL.md preview
---
name: mysql-sql-review
description: MySQL 兼容 SQL 审查助手。用户贴出一条或多条 SQL(SELECT/INSERT/UPDATE/DELETE/DDL),希望检查写法是否正确、会不会慢、有没有风险时使用。适用于 MySQL 及 MySQL 兼容数据库(如 OceanBase MySQL 模式、seekdb、TiDB)。按“正确性 → 性能 → 安全 → 可维护性”逐项审查,输出分级问题表、语义等价的改写 SQL 和验证方法;缺少表结构或执行计划时明确标注前提,不臆测。
---
<!-- OB-S:RCWdLPRcjnMBIEelQzt9Pg -->
# MySQL 兼容 SQL 审查助手
## 用途与适用场景
- **用途**:审查 SQL 语句,找出结果错误、性能隐患、安全风险和难以维护的写法,给出可直接替换的改写和验证方法。
- **适用**:代码评审前自查 SQL、排查“查询变慢”、上线前检查 UPDATE/DELETE、学习 SQL 写法。
- **不适用**:PostgreSQL/Oracle 专有语法;需要真实连库执行或压测才能判断的问题。本 Skill 只做静态审查,不连接数据库、不执行 SQL。
## 一、收集输入
审查所需信息如下。只有 SQL 时也照常审查,但涉及索引和数据量的结论要写成“可能”,并说明前提。
| 信息 | 用途 | 缺失时 |
| --- | --- | --- |
| SQL 原文 | 审查对象 | 必须提供,没有就请用户贴出 |
| 业务意图(这条 SQL 想查/改什么) | 判断结果是否正确 | 从 SQL 推断,并在结论里写明“按 xx 理解” |
| 表结构 `SHOW CREATE TABLE`(列类型、索引) | 判断隐式转换、索引是否可用 | 索引类结论标“需确认表结构” |
| 大致数据量 | 判断全表扫描、深分页的影响 | 不给出耗时估计 |
| 执行计划 `EXPLAIN` 输出 | 确认实际访问路径 | 建议用户执行 EXPLAIN 后再确认 |
| 数据库及版本 | 语法和优化器差异 | 按通用 MySQL 8.0 语义审查,并注明 |
## 二、审查步骤
逐条 SQL 按下面四个维度检查,每发现一个问题记录:级别、位置、问题、原因、建议。
### 1. 正确性(结果是否符合意图)
- `AND` 与 `OR` 混用未加括号:`A AND B OR C` 实际是 `(A AND B) OR C`。
- `NOT IN (子查询)`:子查询结果含 NULL 时整体返回空,建议改用 `NOT EXISTS`。
- 与 NULL 比较用了 `= NULL` / `!= NULL`,应写 `IS NULL` / `IS NOT NULL`。
- `GROUP BY` 之外的非聚合列出现在 SELECT 中,结果不确定。`ONLY_FULL_GROUP_BY` 关闭时不会报错,更危险。
- 多表 JOIN 缺少关联条件,或条件写错,导致笛卡尔积或重复行;`LEFT JOIN` 的右表条件写进 `WHERE`,实际退化成内连接。
- 时间范围边界:`BETWEEN '2026-10-01' AND '2026-10-31'` 会漏掉 31 日 00:00 之后的数据。
- `LIMIT` 没有确定的 `ORDER BY`,翻页结果可能重复或遗漏。
- `UPDATE` / `DELETE` 没有 `WHERE`,或 `WHERE` 条件可能匹配大量行。
### 2. 性能(会不会慢)
- 在索引列上使用函数或计算,如 `DATE(created_at) = ...`、`id + 1 = ...`,索引无法直接使用,应改为对常量计算或改写成范围条件。
- 隐式类型转换:字符串列与数字比较(`phone = 13800000000`),或两边字符集、排序规则不一致,可能导致索引失效。
- 前导通配 `LIKE '%xxx'` 无法使用普通 B+ 树索引。
- 联合索引不满足最左前缀;`OR` 连接不同列的条件,可能退化为全表扫描。
- 深分页 `LIMIT 100000, 20` 需要先扫过前 10 万行,建议改为游标分页(`WHERE id > 上一页最后一个 id`)。
- `SELECT *`:多读无用列,无法利用覆盖索引,表结构变化时容易出错。
- `ORDER BY` / `GROUP BY` 无法利用索引时会产生 filesort 或临时表。
- 相关子查询逐行执行,可考虑改为 JOIN 或 `EXISTS`;`IN` 列表过长(数千项)。
- 单条语句修改大量行,形成大事务,会长时间持锁、产生大量日志,建议分批。
### 3. 安全
- 字符串拼接用户输入构造 SQL,有注入风险,应改用参数化查询(占位符)。
- 生产环境 DML 缺少保护:建议先用相同 `WHERE` 执行 `SELECT COUNT(*)` 确认影响行数,并保留回滚方案。
- DDL 可能锁表或重建表,例如在大表上加列、改类型,应在低峰期执行,并确认所用数据库支持的在线 DDL 方式。
### 4. 可维护性
- 缺少别名或别名含糊、魔法数字(`status = 3`)无注释、超长单行 SQL。只作为“建议”级别,不要喧宾夺主。
### 判定原则
- **级别**:
- **严重**:结果错误、数据可能被误改误删、存在注入风险。
- **警告**:大概率导致明显变慢或不稳定。
- **建议**:写法改进。
- 没有表结构或 EXPLAIN 时,索引类问题写“可能导致……(前提:xx 列上有索引)”,不下定论。
- 不编造执行时间、扫描行数或“提升 N 倍”之类的数字;需要数据时,告诉用户如何用 EXPLAIN 自行验证。
- 改写 SQL 必须与原意语义等价。如果原 SQL 意图不明,或者改写会改变结果(如补括号),要明确写出差异,并请用户确认。
- 只审查用户给出的内容,不臆造不存在的表、列或索引。
## 三、输出格式
按以下结构回答,使用用户的语言:
1. **结论摘要**:1–2 句话,先说最严重的问题,例如“有 1 个会导致结果错误的严重问题、2 个性能警告”。
2. **问题清单**(按 严重 → 警告 → 建议 排序):
| # | 级别 | 位置 | 问题 | 原因 | 建议 |
| --- | --- | --- | --- | --- | --- |
3. **改写后的 SQL**:放在代码块中,在关键改动处加注释;与原意可能不同的地方单独标出。
4. **需要确认的信息**:列出影响结论的前提,例如“`status` 列的类型”“意图是否为 (A 且 B) 或 C”。
5. **验证方法**:如“分别对原 SQL 和改写后的 SQL 执行 `EXPLAIN`,比较 type/key/rows”,或“在测试环境比较两者结果集是否一致”。
如果 SQL 没有发现问题,直接说明“未发现明显问题”,并列出本次审查的前提,不要为了显得有内容而硬凑问题。
## 四、示例
**用户输入:**
```sql
SELECT * FROM orders
WHERE DATE(created_at) = '2026-10-01' AND status = 1 OR user_id = 42
ORDER BY id LIMIT 100000, 20;
```
**回答要点(节选):**
- 结论:1 个严重问题(AND/OR 优先级可能与意图不符),2 个性能警告,1 个建议。
- 严重:`... AND status = 1 OR user_id = 42` 实际为 `(日期条件 AND status = 1) OR user_id = 42`,会返回 user_id = 42 的所有日期的订单。请确认意图。
- 警告:`DATE(created_at)` 使 created_at 上的索引(若有)无法直接使用,改为 `created_at >= '2026-10-01' AND created_at < '2026-10-02'`。
- 警告:`LIMIT 100000, 20` 深分页,建议改为 `WHERE id > ? ORDER BY id LIMIT 20` 游标分页。
- 建议:`SELECT *` 改为列出所需列。
- 需确认:`status` 列类型。若为字符串,`status = 1` 会发生隐式转换,应写 `status = '1'`。
```sql
-- 假设意图为:10 月 1 日且 status = 1 的订单,或 user_id = 42 的订单(请确认)
SELECT id, user_id, status, created_at -- 按需补充实际需要的列
FROM orders
WHERE ((created_at >= '2026-10-01' AND created_at < '2026-10-02' AND status = 1)
OR user_id = 42)
AND id > ? -- 游标分页:第一页传 0,之后传上一页最后一个 id;外层括号不能省
ORDER BY id
LIMIT 20;
```
Files in this package (3)
- LICENSE 1 KB
- README.md 2 KB
- SKILL.md 7 KB
Versions
The database has no other skills named mysql-sql-review.
Database snapshot: 13.11.2026 · package version 5c70a04c769a (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100fai-sql-code-review-skill
Review SQL code for correctness, performance, security, and maintainability across PostgreSQL, SQL Server, and MySQL. Use when auditing SQL in PRs or reviewing database migration scripts. - 100sql-quality-check
Check SQL files for MySQL performance problems (full table scans, ineffective joins, filesorts, functions on indexed columns, implicit conversions and more) and report them, CI style, without changing anything. Use when asked to check, lint or review the SQL of a project, or to… - 100sql-cheatsheet
Use when the user needs SQL: SELECT queries, WHERE filters, JOINs, GROUP BY and aggregation, subqueries, INSERT, UPDATE and DELETE, CREATE TABLE, indexes, transactions, and window functions across MySQL, PostgreSQL and SQLite. - 100sql-safety-review
评估 SQL 查询的安全性、规范性和性能风险。覆盖 OLAP(Spark/Hive、Impala、ClickHouse)和 OLTP(MySQL)两大场景。审查维度:命名规范、编码格式、查询优化、索引策略、DDL/DML 规范、引擎特性、锁与事务。当用户贴出 SQL 问"能不能跑"、"会不会查爆"、"帮我 review"、"格式对不对"、"命名规范吗"、"这个 EXPLAIN 怎么看"、"为什么这么慢"、"能不能在生产跑"、"帮我看看这条 SQL"、"这个查询有没有问题"、"Code Review 一下"、"建表语句有问题吗"、"ETL… - 86tidb
TiDB开发专家助手。当用户需要进行TiDB分布式数据库开发、NewSQL数据库、HTAP场景、分布式事务或MySQL兼容迁移时调用。 - 100sql-expert
Expert in SQL query writing, optimization, and database design. Supports PostgreSQL, MySQL, SQLite, and BigQuery. Use for complex queries, performance tuning, and schema design.