SQL 格式化工具
貼上 SQL 就能整理成易讀的格式。可從 PostgreSQL、MySQL、MariaDB、SQLite、SQL Server(T-SQL)、BigQuery、Snowflake、Oracle(PL/SQL)、Redshift、Trino、Spark 與標準 SQL 共 12 種方言中選擇,並可變更關鍵字大小寫、縮排(2、4 或 Tab)、AND / OR 放在行首或行尾,以及一行容納的寬度。dbt、Jinja、shell 的範本變數,SQL Server 的 GO 與 MySQL 的 DELIMITER,也能不破壞地處理。適合閱讀日誌中成一行的長 SQL,以及程式碼審查前統一格式。只負責整理格式,不會執行 SQL 或確認是否正確。所有處理都在瀏覽器內完成,SQL 不會被傳送。也提供常見失誤的簡易檢查:沒有 WHERE 的 DELETE / UPDATE、DROP 與 TRUNCATE、= NULL、含子查詢的 NOT IN、SELECT *、逗號連接、沒有 ORDER BY 的 LIMIT,以及開頭為 % 的 LIKE。
SQL 檢查
這段 SQL 做了什麼
對上方 SQL 做快速的字面解讀:敘述類型、涉及的資料表、JOIN 與 CTE。字串與註解會被忽略。
填入參數
將 ?、$1、:name、@name 換成實際的值(例如要執行從日誌複製的查詢)。數字、NULL、TRUE/FALSE 維持原樣,其餘加上引號。
上方 SQL 中沒有佔位符(?、$1、:name、@name)。
整理與嵌入
使用上方輸入框的 SQL。可移除註解、在 MySQL、PostgreSQL、SQL Server 風格間切換識別字的引號、把 SQL 包成程式碼用的字串,或從程式碼字串與日誌中取出 SQL。
轉換成其他資料庫的寫法
將上方的 SQL 在資料庫之間(MySQL、PostgreSQL、SQLite、SQL Server)改寫:引號、LIMIT / TOP、IFNULL / COALESCE、NOW()、GROUP_CONCAT / STRING_AGG、:: 轉型,以及 CREATE TABLE 的常見型別。無法安全修改的內容會列在下方。結果只是起點,請務必在實際資料庫上測試。
需手動確認
指南使用方式與特色
- 從「Dialect」下拉式選單選擇對應的資料庫引擎(預設為 MySQL)。
- 將 SQL 語句貼上至輸入框,系統將自動呈現格式化後的結果。
- 點擊「Copy」按鈕即可將美化後的查詢指令複製到剪貼簿。
範例輸入與輸出範例
SELECT 語句格式化範例
select a,b,c from table1 join table2 on table1.id = table2.id where a > 10 order by b desc
SELECT a, b, c FROM table1 JOIN table2 ON table1.id = table2.id WHERE a > 10 ORDER BY b DESC
FAQ常見問題
支援哪些 SQL 方言?
支援 MySQL、MariaDB、PostgreSQL、Redshift、SQLite、T-SQL、BigQuery、Snowflake、PL/SQL、Trino、Spark 與標準 SQL。查詢含有方言專屬語法時,選擇對應的方言,整理結果會更自然。整理後會改變查詢的意義或執行結果嗎?
不會。整理只調整空白、換行與縮排等外觀,不影響語法與執行結果。可以放心貼上正式環境的查詢,只提升可讀性。可以整理從日誌取出的單行長 SQL 嗎?
可以。貼上應用程式記錄成一行的長查詢,就會依子句(SELECT / FROM / WHERE 等)換行並縮排成易讀的形式,有助於審查前整理與理解複雜的 JOIN 結構。可以整理含有 GO 或 DELIMITER 行的腳本嗎?
可以。T-SQL 的 GO、GO 5 行會保留為批次分隔,前後的語句分別整理。MySQL 的 DELIMITER 行也以相同方式處理,預存程序的分隔符號(//)不會被破壞。字串或註解中只有 go 的行不視為分隔。可以調整縮排與關鍵字大小寫嗎?
可以。可選擇縮排(2 個空格 / 4 個空格 / Tab)、關鍵字大小寫(維持 / 大寫 / 小寫)、AND / OR 放在行首或行尾,以及單行容納的運算式寬度。方言與設定會記住,下次繼續使用。輸入機密的查詢安全嗎?
安全。所有整理都在瀏覽器內完成,不會把資料傳到伺服器。可以把 MySQL 的 SQL 轉成 PostgreSQL 或 SQL Server 用嗎?
引號、LIMIT、IFNULL / COALESCE、NOW()、GROUP_CONCAT / STRING_AGG、:: 轉型,以及 CREATE TABLE 的型別與 AUTO_INCREMENT 等可機械式修正的部分,會改寫。ILIKE、||、UPSERT、RETURNING 這類語意會改變的項目不會改寫,而是列為需手動確認的項目。不保證結果行為完全相同,執行前請先在實際的資料庫上確認。
使用情境主要使用情境
讀懂日誌裡的單行 SQL
貼上應用程式日誌或慢查詢日誌中沒有換行的長 SQL,就會依子句換行並縮排。JOIN 條件與 WHERE 篩選更容易追蹤,找出慢查詢的原因也更快。程式碼審查前統一 SQL 格式
可選擇關鍵字大小寫、縮排寬度(2、4 或 Tab),以及 AND / OR 放在行首還是行尾。先依團隊風格整理再貼到 PR,就不必為格式問題來回修改。整理含 dbt、Jinja 或 shell 變數的 SQL
`{{ ref('orders') }}`、`{% if … %}`、`${table}` 這類範本變數會被視為單一元素,不會造成語法錯誤,連同範本一起整理。依資料庫方言整理格式
可從 PostgreSQL、MySQL、SQLite、SQL Server、BigQuery、Snowflake 等 12 種方言中選擇。`$1`、`@name` 等佔位符也會依方言保留。
注意注意事項與限制
只負責整理格式,不會檢查 SQL 是否正確
不會執行查詢,也不會確認資料表與欄位是否存在。含有語法錯誤的 SQL 可能無法整理,或在意料之外的位置換行。請先修正語法再整理。方言不符時,版面可能會亂掉
各方言有自己的語法,例如 BigQuery 的陣列或 PostgreSQL 的 `::` 轉型。若結果不對,請切換成您使用的資料庫方言。特定廠商獨有的語法,以及預存程序內的程序式程式碼,可能無法完整整理。範本變數只會保留,不會解讀
`{{ … }}`、`{% … %}`、`${…}` 僅作為單一單位保留。若範本會改變 SQL 結構(例如以 `{% if %}` 分支的語句),換行位置可能與預期不同。執行前請確認整理後的 SQL
關鍵字轉大寫只作用於保留字,不會更動字串內容;但換行與縮排可能使註解的位置移動。執行或部署前請先確認差異。輸入內容僅在瀏覽器內處理,不會傳送至伺服器。
簡介關於此工具
SQL 格式化工具
很長、壓縮過或由 ORM 產生的 SQL 通常難以閱讀。這個 SQL 格式化工具會加入換行與縮排,讓 JOIN、WHERE、GROUP BY、子查詢與排序條件更容易檢查。
適合使用的情境
- 程式碼審查前:讓複雜 query 更容易被團隊閱讀。
- 除錯 ORM 輸出:整理 logs 中的 SQL,確認 join 與條件。
- 效能調校時:更清楚地檢查 filter、group 與 order 條件。
實務提醒
格式化可以提升可讀性,但不保證 query 正確或效能良好。請在目標資料庫中測試結果,並在效能敏感情境查看 execution plan。
這個工具的相關文章
SQL 格式化工具:如何讓查詢語句變得易讀,以及方言(dialect)選擇為何重要
把從日誌或 ORM 取得的雜亂 SQL 整理成易讀的查詢語句。說明方言選擇(PostgreSQL/MySQL/BigQuery)為何會影響格式化結果的技術原因,以及格式化為何同時能當作語法檢查。
如何用 SQL 建構器以視覺化方式組出 SELECT、JOIN 查詢
說明如何在瀏覽器中用視覺化 SQL 建構器組合 SELECT、WHERE、JOIN。涵蓋數值自動加引號的判斷原理、JOIN 使用時機對照表,以及多資料表 JOIN 的寫法。
SQL 子句執行順序參考|為什麼 WHERE 看不到 SELECT 的別名
SQL 並不是照撰寫的順序執行。以邏輯執行順序(FROM → WHERE → … → LIMIT)為主軸,說明別名為何在 WHERE 無法使用、WHERE 與 HAVING 的分工,以及 LEFT JOIN 搭配 WHERE 的陷阱。
SQL JOIN 完全參考|INNER、LEFT、RIGHT、FULL 的差異與結果列數觀念
以對照表與結果列數範例,完整整理 SQL 的 JOIN 種類(INNER/LEFT/RIGHT/FULL/CROSS/SELF)。說明一對多 JOIN 為何會使列數增加、WHERE 子句與 ON 子句在 NULL 判斷上的陷阱,以及多資料表 JOIN 的寫法。
