任务路径 / 从输入到结果
如何在不执行查询的情况下格式化 SQL
- 01
选择 SQL 方言
选择标准 SQL、PostgreSQL、MySQL、SQLite、SQL Server、BigQuery 或 Snowflake，让方言特有语法得到正确解析——默认是 PostgreSQL。这里没有自动识别：请选择你的数据库实际使用的方言，因为在标准 SQL 下能正常格式化的子句，换成正确的方言后关键字归属可能不同。
- 02
粘贴后立即格式化
粘贴或输入最多 256 KiB 的 SQL。粘贴会立即运行；开启自动格式化时，普通输入会在短暂停顿后重跑；也可按 Ctrl 或 Command + Enter 按需应用当前选项。工作区预置了一段包含联接的示例查询，可以先观察格式化效果，再交给它处理生产 SQL。
- 03
选择可读或紧凑输出
压缩保留换行、注释、字面量与词法单元间的分隔。PostgreSQL 假设 standard_conforming_strings=on，MySQL 假设默认反斜杠转义；不会检测数据库会话设置。格式化会改变引号内容、注释或字面量之间的换行。请改用压缩模式或调整 SQL；不会导出部分结果。
- 04
检查结果和字节数
输出面板随每次运行更新，页脚会报告精确的输入和输出字节数，让可读性的成本——或压缩带来的节省——一目了然。运行在 Web Worker 中执行，评审后的预算为 1,500 毫秒；格式化输出上限为 512 KiB；分词器无法处理的语句会停止并标明行列位置。
- 05
检查、复制或下载
根据实际数据库版本检查结果，然后复制到剪贴板或下载为 toolars-formatted.sql 文件。格式化不能替代数据库校验：工作区从不连接数据库，对象名、权限和语义请在查询真正运行的环境中确认。取消会停止运行并关闭自动格式化，保留 SQL。修改 SQL 或选项会清除先前的输出。