// 免费工具

SQL Server 格式化工具 (T-SQL)

格式化 SQL Server 和 Azure SQL 的 T-SQL。带方括号的名称、@变量、#临时表和 GO 批处理都按 SQL Server 的方式解析,你的脚本永远不会离开你的设备。

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

格式化的 SQL
SELECT
    c.CustomerID,
    COUNT(*) AS Orders INTO #recent
FROM
    dbo.Orders o
    JOIN dbo.Customers c ON c.CustomerID = o.CustomerID
WHERE
    o.OrderDate >= DATEADD(day, -30, GETDATE())
GROUP BY
    c.CustomerID;
SELECT
    r.CustomerID,
    r.Orders,
    @@rowcount AS Total
FROM
    #recent r
WHERE
    r.Orders > @min
ORDER BY
    r.Orders DESC;
GO
DROP TABLE IF EXISTS #recent;
GO

Loading the formatter…

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

格式化器如何处理 SQL Server SQL

  • 带括号的名称保持原样。 [Order Details] 和 [dbo].[Orders] 是带引号的名称, ]] 转义也原样保留。设置 加引号 到 始终引用 格式化器会添加括号; 移除不必要的引号 只会从非保留字的普通名称中去掉它们,因此 Shared.[User] 保留其括号。 仅在必要时加引号 在名称使用了保留字时也会添加它们: Shared.User 变为 Shared.[User].
  • 变量和临时表是名称。 @since, @@ROWCOUNT, #recent, ##shared 和 OUTPUT $action 各自都会被当作一个完整的标记读取,所以不会被拆开。
  • GO 批处理保持它们自己的行。 A GO 行,可带一个可选的重复次数,例如 GO 5 而且无论大小写,总是独占一行。如果恰好有一列叫作 go 也不会被误当成 GO。
  • T-SQL 子句正确布局。 TOP, CROSS APPLY, MERGE … WHEN [NOT] MATCHED, OUTPUT 以及表提示,例如 WITH (NOLOCK) 保留其含义,并且 N'…' Unicode 字符串从不被修改。
  • 自动检测能识别 T-SQL 当它看到带括号的名称时, @ 参数或 GO 行。
  • 压缩会保留 GO。 把脚本压缩到一行时,仍会让每个 GO 单独占一行,因为 SQL Server 工具要求如此。

值得了解

  • 过程性 T-SQL 保持有效,过程中的语句按顺序排列,但 BEGIN … END, IF 和 WHILE 块不会重新缩进。
  • 包含 ODBC 转义序列的 SQL,例如 {fn NOW()} 会原样返回,并附有格式化器停止的位置说明。

示例

SQL Server 前后对比

之前
select c.CustomerID,count(*) as Orders into #recent from dbo.Orders o join dbo.Customers c on c.CustomerID=o.CustomerID where o.OrderDate>=dateadd(day,-30,getdate()) group by c.CustomerID;
select r.CustomerID,r.Orders,@@rowcount as Total from #recent r where r.Orders>@min order by r.Orders desc;
go
drop table if exists #recent;
go
之后
SELECT
    c.CustomerID,
    COUNT(*) AS Orders INTO #recent
FROM
    dbo.Orders o
    JOIN dbo.Customers c ON c.CustomerID = o.CustomerID
WHERE
    o.OrderDate >= DATEADD(day, -30, GETDATE())
GROUP BY
    c.CustomerID;
SELECT
    r.CustomerID,
    r.Orders,
    @@rowcount AS Total
FROM
    #recent r
WHERE
    r.Orders > @min
ORDER BY
    r.Orders DESC;
GO
DROP TABLE IF EXISTS #recent;
GO

输出采用 Standard 样式和 4 空格缩进,与上方格式化器生成的结果完全一致。可将样式切换为 紧凑 用于更紧凑的 SQL,或 已展开 用于前置逗号和每行一项。该 格式化工具文档 涵盖详细信息。

SQL Server 格式化工具常见问题

T-SQL 格式化工具能处理 GO 批处理分隔符吗?

能。GO 行始终独占一行,包括带重复次数的 GO,例如 GO 5,Minify 也会保留它。语句里名为 go 的列不会被当作分隔符。

它会改动我的 [方括号] 名称吗?

不会。带方括号的名称会原样保留,除非你在高级设置里选择了不同的引号选项。“删除不必要的引号”只会去掉普通名称(非保留字)的引号(所以 [User] 和 [Order] 会保留方括号),这样做是安全的,因为在默认排序规则下 SQL Server 的名称不区分大小写。

它能格式化包含临时表和变量的脚本吗?

是的。#temp 和 ##global 临时表、@变量、@@ 系统函数以及 $action 都会当作单个名称读取,格式化程序会照常排版脚本,而不是拒绝。

它适用于 Azure SQL 吗?

是的。Azure SQL 数据库和 Azure SQL 托管实例使用相同的 T-SQL 方言,所以请选择 SQL Server (T-SQL) 或保持方言自动检测。

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

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

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

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

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

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

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

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

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