返回列表

SQL 格式化|慢查询日志里的一行 SQL,先格式化再发 PR

从 MySQL slow log 或 ORM 调试贴出的单行 SELECT,用浏览器 SQL 格式化折行看 JOIN 和 WHERE,再压缩塞回工单。不执行 SQL,不连库。

作者 WGinit · 2026年11月20日 · 阅读5分钟

为什么先格式化

慢查询、死锁复盘、代码评审里常见这种:SELECT u.id,u.name,o.total FROM users u LEFT JOIN orders o ON u.id=o.user_id WHERE o.total>100 AND u.status='active' ORDER BY o.total DESC LIMIT 50。一行塞满屏幕,JOIN 条件和过滤混在一起。

打开 SQL 格式化,粘贴整段,选「格式化」后点执行。工具会在 SELECT、FROM、WHERE、JOIN、ORDER BY 等关键字前断行,并把 AND、OR、ON 缩进一格,方便肉眼对表名和关联键。

处理发生在浏览器里,不会把你的 SQL 发到 WoDeTool 服务器执行,也不连接你的数据库,适合 staging 慢查询样例;生产表名、客户字段仍建议脱敏后再贴。

格式化与压缩两种模式

「格式化」把多余空白收成一行再按关键字拆行,输出多行只读 SQL,适合放进 Jira/PR 描述或和同事对齐。「压缩」把所有空白压成一行,适合复制回单元测试夹具,或对比日志原始行与规范化行是否只差换行(有些复制会插入奇怪空格)。两种模式都不改关键字大小写、不改标识符引号,也不会自动加分号。方言专用语法(如 PostgreSQL ::jsonb、ILIKE)会按原文保留,只是换行位置按通用关键字列表处理。

工具能做什么、不能做什么

这是基于关键字列表的轻量排版,不是完整 SQL 解析器。字符串字面量里若恰好出现 AND 或 SELECT 字样,极少数情况下可能被误断行——遇到这种语句请以数据库客户端为准。常见 WITH 子句(CTE)不在断行关键字表里,可能仍贴在一行;你可先手工在 WITH 前换行,或把 CTE 主体贴进来再格式化。

不校验语法是否能在 MySQL / PostgreSQL / SQLite 上执行;发版前仍要在目标库 EXPLAIN 或测试环境跑一遍。与 JSON 格式化 类似:浏览器负责「读清楚」,执行责任仍在你的流水线。

端到端实操流程(图示)

实操顺序:粘贴 → 格式化 → 阅读 JOIN/WHERE → 若要记录索引优化,用 Diff 对比 把改前改后的 SQL 并列;批量改表别名时可用 文本替换 在格式化结果上做受控替换。

先格式化再 diff,比直接 diff 单行更容易看出你动的是哪一段 ON 或哪条 AND。

方言、隐私与排查

脱敏:真实邮箱、手机号、公司名换成占位符后再贴;,WHERE email='...' 里的字面量同事照样能看见。

ORM 里的 DATE_FORMAT、TO_CHAR 等方言函数,格式化只动排版不动语义。索引结论仍以目标库 EXPLAIN 为准;,写文档时把计划文本和格式化后的 SQL 并排贴进工单。

常见问题

Q格式化后 GROUP BY 和 ORDER BY 的上下关系看着别扭,是不是改了语义?

A没有。工具只在关键字前断行,不重排子句;非法 SQL 排版也救不了,用目标库 EXPLAIN 验证。

Q要比 DBA 改索引前后的 SQL?

A两边各格式化一份,进 Diff 对比;单行 diff 很难看出 ON 动了哪。

Q慢日志里的反引号表名 ` user ` 会不会被吃掉?

A原样保留,只动空白和关键字断行。

Q压缩模式会不会删注释?

A-- 和 /* */ 跟着正文走,压缩只并空白;注释若必须在行首,格式化后可能要手工挪一行。

实操示例(分步)

1. 慢查询日志:# Query_time: 2.3 SELECT p.id,p.sku,i.qty FROM product p INNER JOIN inventory i ON p.id=i.product_id WHERE i.qty<5 AND p.deleted=0 ORDER BY i.qty ASC LIMIT 20

2. 复制 SELECT 起至 LIMIT 20,粘贴 SQL 格式化,选「格式化」。

3. 确认 INNER JOIN 单独一行,ON p.id=i.product_id 缩进在 AND 同级规则下可见。

4. DBA 建议加索引前,把当前 SQL 与改后版(FORCE INDEX 草案)各格式化一次。

5. 两份多行文本进 Diff 对比,只看 FROM/JOIN 段差异。

6. 工单里贴多行版;单元测试夹具用「压缩」拉回单行。

7. 若需把 orders 批量改成 orders_archive 做演练,在格式化结果上用 文本替换 限定替换范围。

8. 字数超工单上限时,用 字数统计 估长度,删无关列名说明而非截断 SQL。

相关工具

相关教程