SQL Server 格式化工具(T-SQL)
格式化 SQL Server 和 Azure SQL 的 T-SQL。方括號名稱、@變數、#暫存資料表和 GO 批次都會以 SQL Server 的方式解讀,你的腳本永遠不會離開你的裝置。
格式化器的每個版面配置設定,按群組分類 編輯器 › 格式化 在 SQLly 應用程式中。上方的樣式是起點;你在此處更改的任何內容都會被標記。
將 .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+Enter 鍵 會進行格式化,而 Ctrl+Shift+Enter 鍵 縮小(⌘ 而不是 Ctrl 在 Mac 上)。你的設定會記在這個瀏覽器裡,並保存在頁面位址中,所以分享連結帶的是你的樣式 —— 絕不會是你的 SQL。
格式化工具對 SQL Server SQL 的處理方式
- 帶括號的名稱保持不變。
[Order Details]和[dbo].[Orders]是引用的名稱,]]包含跳脫字元。設定 引號用法 到 一律加引號 而格式化工具會補上括號; 移除不必要的引號 僅從非保留字的普通名稱中移除,因此Shared.[User]會保留它的括號。 僅在必要時加引號 也會在保留字被當成名稱使用時加上引號:Shared.User變成Shared.[User]. - 變數和暫存資料表都是名稱。
@since,@@ROWCOUNT,#recent,##shared和OUTPUT $action每個都會當成一個 token 讀取,所以不會被拆散。 - GO 批次各自佔一行。 A
GO行,可帶選擇性的重複次數,例如GO 5且不分大小寫,永遠單獨佔一行。如果某個欄位剛好叫做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
輸出使用標準樣式與 4 格空白縮排,和上面的格式化工具產出的完全一樣。把樣式切換到 緊湊 可用於更精簡的 SQL 或 展開 用於前置逗號及每行一個項目。 格式化工具文件 涵蓋了詳細資訊。
SQL Server 格式化工具常見問題
T-SQL 格式化工具會處理 GO 批次分隔符嗎?
會的。GO 這一行會獨自一行,包括像 GO 5 這樣帶重複次數的寫法,Minify 也會保留它。語句內名為 go 的欄位不會被當成分隔符號。
它會變更我用方括號括起來的名稱嗎?
不會。以中括號括起的名稱會保持原樣,除非你在進階設定中選擇了不同的引號選項。「移除不必要的引號」只會取消非保留字的一般名稱的引號(因此 [User] 和 [Order] 會保留中括號),這是安全的,因為 SQL Server 在預設定序下名稱不區分大小寫。
它可以格式化含暫存資料表與變數的腳本嗎?
是的。#temp 和 ##global 暫存資料表、@變數、@@ 系統函式和 $action 都會被當成單一名稱,因此格式化工具會照常排版指令碼,而不是拒絕處理。
它適用於 Azure SQL 嗎?
是的。Azure SQL Database 和 Azure SQL Managed Instance 都用相同的 T-SQL 方言,選 SQL Server (T-SQL),或把方言設成自動偵測都行。
我的 SQL 會被傳送到伺服器嗎?
不會。該格式化工具已編譯為 WebAssembly,並在你的瀏覽器分頁中執行。你的 SQL 永遠不會被上傳、記錄或儲存,一旦頁面載入,它就能離線運作。
格式化會破壞我的查詢嗎?
它的設計就是不會。格式化之後,SQLly 會將輸出與你的輸入逐個 token 比對,如果除了空白與你指定的大小寫之外還有任何改變,它會把你的 SQL 原樣退回,並告訴你原因。無法順利解析的 SQL,例如未結束的字串,也會保持原樣,並指出問題所在的行與欄。
我可以與團隊共用我的格式化設定嗎?
是的。包括進階設定在內的每一項設定,都會保存在網址 # 號之後,複製網址或按「複製設定連結」就能分享你確切的樣式。連結只保存設定,絕不包含你的 SQL。
其他方言
- 任何方言(自動偵測)
- PostgreSQL 格式化工具
- MySQL 格式化工具
- SQLite 格式化工具
- Oracle SQL 格式化工具
- Snowflake SQL 格式化工具
- BigQuery SQL 格式化工具
- Redshift SQL 格式化工具
每天都在使用 SQL Server 嗎?看看 SQLly 桌面應用程式為 SQL Server 做了什麼,或瀏覽所有 功能.
喜歡這個格式化工具嗎?來看看 SQLly 的其他功能吧
原生 SQL 工作台,支援 macOS、Windows 和 Linux,IntelliSense 認得你的結構描述,高風險查詢有防護,這套格式化工具也內建在編輯器裡。