要点
- 01支持 PostgreSQL、MySQL、SQLite、BigQuery 和标准 SQL，具有方言感知的关键字处理。
- 02选择关键字大小写（大写、小写或保留）和缩进（2 空格、4 空格或制表符）。
- 03完全在浏览器中运行 — 包含敏感数据的查询永远不会离开你的设备。
- 04该工具仅重新格式化文本；它不执行查询或连接到任何数据库。
为什么在共享前格式化 SQL?
未格式化的 SQL 真的很难审查。长 SELECT 列表压在一行上、子查询中不一致的缩进、混合大小写的关键字都会减慢代码审查和调试。格式正确的查询使 JOIN 条件、WHERE 子句和 CTE 结构立即可读。
在与遵循风格指南的团队共享查询时，格式化变得更加重要 — 大写关键字、四空格缩进、每行一个子句。Handytool 的 SQL 格式化工具在你粘贴的所有内容中一致执行该风格，无论是两行查找还是 200 行包含多个 CTE 和窗口函数的分析查询。
如何格式化 SQL 查询
- 01
粘贴你的 SQL
将任何 SQL 语句粘贴到输入面板中 — SELECT、INSERT、UPDATE、DELETE、CREATE 或完整的 CTE 链。除了浏览器可用内存外，没有大小限制。
- 02
选择方言
从下拉菜单中选择 PostgreSQL、MySQL、SQLite、BigQuery 或标准 SQL。方言决定了如何处理保留字和特定于供应商的语法，如 RETURNING 或 STRUCT。
- 03
设置关键字大小写和缩进
为关键字大小写选择大写、小写或保留。为缩进选择 2 空格、4 空格或制表符。大写关键字加 2 空格缩进是共享代码库中最常见的风格。
- 04
单击格式化
格式化的输出立即在右面板中出现。子句放在自己的行上，JOIN 条件对齐，子查询相对于其父查询缩进。
- 05
复制并使用
单击复制将格式化的 SQL 复制到剪贴板。粘贴到你的 IDE、SQL 文件、PR 描述或文档片段。
使用生产查询模式很安全
sql-formatter 库完全在浏览器中运行。没有数据发送到服务器 — 没有查询文本、没有表名、没有示例数据。这使其可以安全地格式化引用真实模式名称或包含来自暂存数据库示例值的查询。
格式化工具不会做的一件事是执行你的 SQL。它仅仅是文本转换工具。你可以安全地粘贴会删除表或删除行的查询 — 该工具将其视为纯文本并重新格式化它，而不运行任何语句。
SQL 格式化工具常见问题
此格式化工具支持哪些 SQL 方言?
标准 SQL、PostgreSQL、MySQL、SQLite 和 BigQuery。每种方言正确处理特定于供应商的语法，如 PostgreSQL 的 RETURNING 子句、MySQL 的反引号标识符和 BigQuery 的 STRUCT 类型。
格式化工具会运行我的查询吗?
不会。它仅重新格式化查询文本。它不连接到任何数据库、验证列名或执行语句。
我的 SQL 会上传到任何服务器吗?
不会。sql-formatter 库在浏览器中运行。你的查询文本保留在你的设备上。
为什么我的存储过程或 PL/pgSQL 块格式化很奇怪?
过程 SQL 块（PL/pgSQL、BEGIN…END 块、DECLARE 部分）超出了格式化工具语法覆盖范围。从这些块中单独格式化较小的 SELECT 或 DML 片段。
共享代码库的最佳关键字大小写是什么?
大写关键字是最广泛采用的约定 — 它们在视觉上将 SQL 结构与标识符名称分开。两空格或四空格缩进是团队偏好问题。