跳至內容
資料工具

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 做快速的字面解讀:敘述類型、涉及的資料表、JOIN 與 CTE。字串與註解會被忽略。

填入參數

將 ?、$1、:name、@name 換成實際的值(例如要執行從日誌複製的查詢)。數字、NULL、TRUE/FALSE 維持原樣,其餘加上引號。

整理與嵌入

使用上方輸入框的 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。

這個工具的相關文章

最新文章