Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

mysql-sql-review

/mysql-sql-review

Sprawdza zapytania SQL pod kątem MySQL: poprawność, wydajność, bezpieczeństwo i czytelność, z poprawionymi wersjami i sposobem weryfikacji.

Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
1
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Sprawdza zapytania SQL pod kątem MySQL: poprawność, wydajność, bezpieczeństwo i czytelność, z poprawionymi wersjami i sposobem weryfikacji.

Wyzwalacze z opisu

正确性 → 性能 → 安全 → 可维护性
Oryginalny opis (EN)

MySQL 兼容 SQL 审查助手。用户贴出一条或多条 SQL(SELECT/INSERT/UPDATE/DELETE/DDL),希望检查写法是否正确、会不会慢、有没有风险时使用。适用于 MySQL 及 MySQL 兼容数据库(如 OceanBase MySQL 模式、seekdb、TiDB)。按“正确性 → 性能 → 安全 → 可维护性”逐项审查,输出分级问题表、语义等价的改写 SQL 和验证方法;缺少表结构或执行计划时明确标注前提,不臆测。

Jak działa

  1. 用途与适用场景
  2. 一、收集输入
  3. 二、审查步骤
  4. 三、输出格式
  5. 四、示例
Sekcje z nagłówków SKILL.md, w oryginale · 118 linii, 518 słów
Podgląd SKILL.md
---
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;
```
Pliki w paczce (3)
  • LICENSE 1 KB
  • README.md 2 KB
  • SKILL.md 7 KB

Wersje

W bazie nie ma innych skilli o nazwie mysql-sql-review.

Migawka bazy z 13.11.2026 · wersja paczki 5c70a04c769a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100fai-sql-code-review-skill
    Przegląda kod SQL pod kątem poprawności, wydajności, bezpieczeństwa i utrzymywalności w PostgreSQL, SQL Server i MySQL, w PR i skryptach migracji baz.
  • 100sql-quality-check
    Sprawdza pliki SQL pod kątem problemów wydajności MySQL i raportuje je jak w CI, bez zmieniania kodu.
  • 100sql-cheatsheet
    Podaje zwięzłą ściągę SQL: SELECT, JOIN, agregacje, DML, indeksy, transakcje i funkcje okna w MySQL, PostgreSQL i SQLite.
  • 100sql-safety-review
    Ocenia zapytania i instrukcje DDL oraz DML pod kątem nazewnictwa, wydajności, indeksów i blokad w Spark, ClickHouse i MySQL.
  • 86tidb
    Pomaga w bazie TiDB: rozproszone transakcje, HTAP i migracje zgodne z MySQL.
  • 100sql-expert
    Pomaga pisać i optymalizować zapytania SQL oraz projektować bazy w PostgreSQL, MySQL, SQLite i BigQuery.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.