// 免費工具

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+Enter 鍵 會進行格式化,而 Ctrl+Shift+Enter 鍵 縮小(⌘ 而不是 Ctrl 在 Mac 上)。你的設定會記在這個瀏覽器裡,並保存在頁面位址中,所以分享連結帶的是你的樣式 —— 絕不會是你的 SQL。

這個 SQL 格式化工具的功能

它像資料庫一樣讀取你的 SQL——視為詞元而非純文字——並以一致的方式排版:每個子句一行、SELECT 清單縮排、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;

兩個輸出都使用標準樣式與四個空格縮排,和上面的格式化工具產出的完全一樣。把樣式切換成 緊湊 可用於更精簡的 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,看到 `backticks` 就選 MySQL,其餘情況則選 PostgreSQL。

格式化會破壞我的查詢嗎?

它的設計就是不會。格式化之後,SQLly 會將輸出與你的輸入逐個 token 比對,如果除了空白與你指定的大小寫之外還有任何改變,它會把你的 SQL 原樣退回,並告訴你原因。無法順利解析的 SQL,例如未結束的字串,也會保持原樣,並指出問題所在的行與欄。

如何讓查詢的某部分完全保持原樣?

用 -- formatter:off 和 -- formatter:on 註解把它包起來。兩者之間的內容一律原封不動,手動對齊的清單或產生的程式碼就很受用。

我可以與團隊共用我的格式化設定嗎?

是的。包括進階設定在內的每一項設定,都會保存在網址 # 號之後,複製網址或按「複製設定連結」就能分享你確切的樣式。連結只保存設定,絕不包含你的 SQL。

我可以在工作時自動格式化 SQL 嗎?

可以,在 macOS、Windows 和 Linux 的 SQLly 桌面應用程式中。從「查詢」選單或命令面板執行「格式化 SQL」,或開啟「儲存時格式化」與「貼上時格式化」,設定和這裡的進階面板相同。

// 格式化只是最基本功能

喜歡這個格式化工具嗎?來看看 SQLly 的其他功能吧

原生 SQL 工作台,支援 macOS、Windows 和 Linux,IntelliSense 認得你的結構描述,高風險查詢有防護,這套格式化工具也內建在編輯器裡。