// 免费工具

SQL 格式化工具

粘贴杂乱的 SQL,拿回干净、一致的 SQL。这正是 SQLly 桌面应用内置的同款格式化器,编译成了 WebAssembly——它完全在你的浏览器中运行,因此 你的 SQL 永远不会离开你的设备.

把 .sql 文件拖到此处即可打开。文件只在你的浏览器中读取,不会上传。

格式化的 SQL
SELECT TOP 5
    o.[OrderID],
    c.CompanyName,
    SUM(od.UnitPrice * od.Quantity) AS Total
FROM
    dbo.Orders o
    INNER JOIN dbo.Customers c ON c.CustomerID = o.CustomerID
    INNER JOIN [Order Details] od ON od.OrderID = o.OrderID
WHERE
    o.OrderDate >= '2024-01-01'
GROUP BY
    o.OrderID,
    c.CompanyName
ORDER BY
    Total DESC

Loading the formatter…

编辑器中的快捷键: Ctrl+输入 格式,以及 Ctrl+Shift+输入 压缩(⌘ 代替 Ctrl 在 Mac 上)。你的设置会记在这个浏览器里,也保留在页面地址中,因此分享链接时带出的是你的样式 – 而不是你的 SQL。

此 SQL 格式化器的功能

它像数据库那样读取你的 SQL——当作令牌而不是纯文本——然后以一致的方式排版:每行一个子句,选择列表缩进,JOIN 对齐,以及你偏好的关键字大小写。注释留在你放置的位置,字符串字面量绝不会被改动。

  • 支持方言识别。 T-SQL [brackets], #temp 表和 GO 批,PostgreSQL $$ 主体, :: 类型转换和 JSONB 操作符,MySQL `backticks` 和 @variables - 每种方言都使用其自身的规则进行读取。
  • 设计即安全。 输出会对照你的输入逐个词元重新核查。如果除了空格和大小写之外还有任何内容会变化,你的 SQL 会原样返回——页面还会告诉你原因,精确到行和列。
  • 应用里的每一项设置。 打开 高级设置 对于桌面应用程序提供的完整布局选项集:JOIN 和 ON 的位置,CASE 和 IN 列表的布局,CTE 和子查询风格,DDL 对齐,每类关键字的大小写等。
  • 显示更改内容。 结果会带语法高亮和行号显示,状态行会统计除空白之外的改动数,并且 更改 逐行显示与你输入内容的对比。
  • 私密。 格式化在你的标签页中进行。没有任何内容被上传、记录或存储;打开的文件由你的浏览器读取。
  • 还能压缩。 需要一行日志、JSON 负载或命令行吗? 压缩 会折叠查询,同时原样保留字面量、优化器提示以及所有手写内容。

适用于你的方言的 SQL 格式化工具

每个方言页面都会打开同一个工具并预选相应方言,同时说明该方言的语法是如何处理的。

示例

T-SQL 格式化工具:SQL Server 报表查询

之前
select top 5 o.[OrderID],c.CompanyName,sum(od.UnitPrice*od.Quantity) as Total from dbo.Orders o inner join dbo.Customers c on c.CustomerID=o.CustomerID inner join [Order Details] od on od.OrderID=o.OrderID where o.OrderDate>='2024-01-01' group by o.OrderID,c.CompanyName order by Total desc
之后
SELECT TOP 5
    o.[OrderID],
    c.CompanyName,
    SUM(od.UnitPrice * od.Quantity) AS Total
FROM
    dbo.Orders o
    INNER JOIN dbo.Customers c ON c.CustomerID = o.CustomerID
    INNER JOIN [Order Details] od ON od.OrderID = o.OrderID
WHERE
    o.OrderDate >= '2024-01-01'
GROUP BY
    o.OrderID,
    c.CompanyName
ORDER BY
    Total DESC

PostgreSQL 格式化工具:CTE

之前
with recent as (select customer_id, count(*) as n from orders where created_at > now() - interval '30 days' group by customer_id) select c.email, r.n from customers c join recent r using (customer_id) where r.n >= 3 order by r.n desc limit 20;
之后
WITH
    recent AS (
        SELECT
            customer_id,
            COUNT(*) AS n
        FROM
            orders
        WHERE
            created_at > NOW() - INTERVAL '30 days'
        GROUP BY
            customer_id
    )
SELECT
    c.email,
    r.n
FROM
    customers c
    JOIN recent r USING (customer_id)
WHERE
    r.n >= 3
ORDER BY
    r.n DESC
LIMIT 20;

两个输出都采用 4 空格缩进的标准样式,和上面格式化工具生成的完全一致。把样式切换为 紧凑 用于更紧凑的 SQL,或 已展开 用于前置逗号和每行一项。该 格式化工具文档 涵盖详细信息。

SQL 格式化工具常见问题

这个 SQL 格式化工具是免费的吗?

是的。使用免费,无需注册,也没有使用限制。这是来自 SQLly 桌面应用的格式化工具,以免费网页工具的形式发布。

我的 SQL 会被发送到服务器吗?

不会。格式化工具编译成了 WebAssembly,在你的浏览器标签页中运行。你的 SQL 绝不会被上传、记录或存储;页面加载后,断网也能继续使用。

它支持哪些 SQL 方言?

支持 SQL Server 和 Azure SQL 的 T-SQL、PostgreSQL、MySQL 和 MariaDB、SQLite 和 Oracle。Snowflake 和 Redshift 使用 PostgreSQL 规则进行格式化,BigQuery 使用 MySQL 规则。自动检测功能会在看到 [方括号] 名称、@参数或 GO 语句时选择 T-SQL,看到 `反引号` 时选择 MySQL,否则选择 PostgreSQL。

格式化会破坏我的查询吗?

它的设计目标就是不破坏。格式化后,SQLly 会逐个令牌地把输出与你的输入比对。如果除空白和你要求的大小写之外还有任何变化,它会把你原本的 SQL 原样返回,并告诉你原因。无法顺利解析的 SQL,例如未终止的字符串,也会原样保留,并附上问题所在的行和列。

如何让查询的某一部分完全保持原样?

把它包进 -- formatter:off 和 -- formatter:on 注释。两者之间的内容原样通过,对手动对齐的列表或生成的代码特别有用。

我可以与团队共享我的格式化设置吗?

是的。包括高级设置在内的每一项设置都保存在页面地址 # 号之后,因此复制地址或点击“复制设置链接”,对方得到的就是和你完全相同的样式。链接只包含设置,绝不含你的 SQL。

我可以在工作时自动格式化 SQL 吗?

可以,在 macOS、Windows 和 Linux 的 SQLly 桌面应用中都可以。从“查询”菜单或命令面板运行“格式化 SQL”,或开启“保存时格式化”和“粘贴时格式化”,设置与此处的高级面板相同。

// 格式化只是最次要的部分

喜欢这个格式化工具?来认识一下 SQLly 的其他功能

适用于 macOS、Windows 和 Linux 的原生 SQL 工作台,智能感知能理解你的数据库模式,高危查询有防护,这款格式化工具就内置在编辑器里。