使用说明
排成一行的 SQL 不便阅读 WHERE 条件、JOIN 关系与字段列表。此工具按选定方言重新组织排版,帮助代码评审和问题排查。它只处理字符串,不连接数据库、不执行查询,也不会评估查询计划。
- 在 Dialect 中选择与数据库一致的方言。
- 粘贴脱敏后的 SQL,设置 Keyword case 和缩进样式。
- 检查注释、参数占位符和字符串字面量,再复制到开发环境验证。
输入与输出示例
输入
select id,name from users where active=1 order by id;
输出示例
SELECT id, name FROM users WHERE active = 1 ORDER BY id;
示例体现排版效果;实际空格和换行取决于所选方言与选项。
限制与注意事项
- 格式化不等于 SQL 语法验证,也不保证与特定数据库版本兼容。
- MyBatis、模板变量、过程语言和厂商扩展可能无法解析,遇到错误应保留原稿。
- 关键字大小写或换行变化不代表查询性能提升;性能问题需要在数据库中查看执行计划。
常见问题
工具会执行我输入的 SQL 吗?
不会。页面没有数据库连接,输入作为文本参与排版。
为什么同一段 SQL 换个方言就报错?
方言的标识符引用、函数与参数语法不同。先选择真实使用的数据库,而不是通过反复换方言掩盖语法问题。
相关工具与教程
查看配置排查教程内容由轻工具编辑整理。发现说明与实际结果不一致时,欢迎通过联系页面反馈脱敏样例。