SQL语句格式化与排版检查工具（开发）

什么是SQL格式化工具？

SQL格式化工具是一款在线工具，可将复杂编写的SQL查询整理得更易于阅读。即使是压缩在一行的查询，也能通过应用适当的缩进和换行，让其结构一目了然。

支持MySQL、PostgreSQL、Oracle、SQL Server、MariaDB、SQLite等8种主流SQL方言，提供关键字大小写转换和缩进大小调节选项。通过语法高亮功能，用颜色区分关键字、字符串、数字和注释，提高可读性。

适用场景

• 分析压缩查询 – 将单行长SQL查询结构化分解以便理解
• 代码审查 – 在审查同事编写的SQL之前进行格式化，提高可读性
• 调试 – 在复杂的JOIN或子查询中查找错误时，明确其结构
• 文档编写 – 将SQL整理后添加到项目文档或Wiki
• 学习 – 可视化理解和学习SQL语法结构
• 统一编码风格 – 在团队内统一SQL编写风格
• 日志分析 – 将从应用日志中提取的查询转换为易读格式

主要功能

• 支持8种SQL方言 – 支持标准SQL、MySQL、PostgreSQL、Oracle PL/SQL、SQL Server T-SQL、MariaDB、SQLite、Amazon Redshift、Snowflake。根据各方言的特殊语法进行格式化。
• 关键字大小写转换 – 提供UPPER（大写）、lower（小写）、preserve（保持原样）3种选项，可选择关键字风格。
• 缩进调节 – 可选择2格或4格缩进，适应个人或团队风格。
• 语法高亮 – 为关键字（蓝色）、字符串（红色）、数字（紫色）、注释（灰色）、运算符等应用颜色，提高代码可读性。
• 显示行号 – 输入和输出两侧都显示行号，便于引用特定行。
• 文件上传/下载 – 可直接上传.sql文件，并将格式化结果下载为.sql文件。
• SQL示例 – 提供SELECT、INSERT、JOIN、子查询、CREATE TABLE等5种示例，可快速测试功能。
• 自动保存 – 正在编写的SQL会自动保存到浏览器，即使刷新页面也能恢复。
• 剪贴板复制 – 一键将格式化结果复制到剪贴板。
• 实时转换 – 输入即时应用格式化，立即查看结果。

使用方法

1. 输入SQL – 在左侧输入区域输入或粘贴要格式化的SQL查询。也可通过”示例”按钮加载样例。
2. 设置选项 – 在顶部选择SQL方言、关键字大小写、缩进大小。
3. 查看结果 – 在右侧输出区域查看格式化后的SQL。输入的同时会自动转换。
4. 复制或下载 – 使用”复制”按钮复制到剪贴板，或使用”下载”按钮保存为.sql文件。

支持的SQL方言详情

SQL格式化工具支持以下数据库系统的SQL语法：

• 标准SQL – ANSI/ISO SQL标准语法。与大多数RDBMS兼容。
• MySQL – 支持MySQL及MySQL兼容数据库（Percona、TiDB等）的语法。识别LIMIT、AUTO_INCREMENT等MySQL特有语句。
• PostgreSQL – 支持PostgreSQL的扩展语法。识别RETURNING、UPSERT、数组、JSON运算符等。
• Oracle PL/SQL – 支持Oracle Database的PL/SQL过程语言。识别DECODE、NVL、ROWNUM等Oracle函数。
• SQL Server T-SQL – 支持Microsoft SQL Server的Transact-SQL。识别TOP、NOLOCK、变量(@)等。
• MariaDB – 支持MariaDB的MySQL扩展语法。识别SEQUENCE、窗口函数扩展等。
• SQLite – 支持SQLite的轻量级语法。识别AUTOINCREMENT、VACUUM、ATTACH等。
• Amazon Redshift – 支持AWS Redshift的分析查询语法。识别DISTKEY、SORTKEY、COPY、UNLOAD等。
• Snowflake – 支持Snowflake云数据平台的语法。识别VARIANT、FLATTEN、QUALIFY等。

格式化规则

SQL格式化工具应用以下规则整理查询：

• 按子句换行 – SELECT、FROM、WHERE、JOIN、ORDER BY等主要子句从新行开始。
• 列对齐 – SELECT子句的列列表各占一行并对齐缩进。
• 条件对齐 – WHERE子句的AND/OR条件各占一行，清晰区分条件。
• 子查询缩进 – 子查询比上层查询多缩进一级，表达层次关系。
• 括号对齐 – 统一整理左括号和右括号的位置。
• 查询间分隔 – 多个SQL语句之间用空行分隔。

使用技巧

• 大容量查询 – 可处理数千行的SQL，但超大文件可能影响浏览器性能。
• 保留注释 – 单行（–）和多行（/* */）注释会原样保留。
• 保留字符串 – 单引号或双引号括起的字符串内容不会被更改。
• Tab键 – 在输入区域按Tab键会插入设置的缩进大小的空格。
• 利用自动保存 – 即使在工作中误关闭页面，也能恢复自动保存的内容。

详细说明

SQL格式化工具的结果基于输入值与所选条件计算得到。

涉及最终决策时，请结合官方标准或专业意见进行复核。

常见问题