底層運作原理
內建多方言 `sql-formatter` 詞法排版引擎,能準確辨識不同資料庫系統的專屬語法(例如 PostgreSQL 的 `$1` 參數與 JSONB 運算子、BigQuery 的反引號識別字或 T-SQL 方括號)。在美化模式中會依縮排與關鍵字大小寫規則重新排版;在壓縮(Minify)模式中則會以詞法級安全方式移除 `--` 與 `/* */` 註解及多餘空白,同時完整保留單引號字串內的文字不變。
詳細操作步驟
選擇您的 SQL 方言(Standard SQL、PostgreSQL、MySQL、SQLite、T-SQL 或 BigQuery)。
設定關鍵字大小寫偏好(全部大寫 UPPERCASE、全部小寫 lowercase 或保留原樣)與縮排寬度(2 空白、4 空白或 Tab)。
選擇「美化排版(Beautify)」或「安全壓縮(Minify)」模式並貼上 SQL 查詢語句。
檢視多語句解析診斷資訊後,一鍵複製格式化完成的 SQL。
核心功能與效能優勢
- 支援 6 大主流資料庫方言:PostgreSQL(含 `$1`、JSONB)、MySQL、SQLite、T-SQL、BigQuery 與 ANSI SQL
- 彈性切換關鍵字大小寫(UPPERCASE / lowercase / Preserve)與縮排樣式(2/4 空白或 Tab)
- 安全壓縮模式精準剔除 `--` 與 `/* */` 註解,絕不誤刪單引號字串內含 `--` 的正常資料
- 內建多語句分號診斷,協助快速發現未閉合字串或括號不對稱問題
- 100% 瀏覽器本地運作,公司內部資料庫表名、商業邏輯與連線查詢絕不上傳
運算方法、公式與技術標準
採用 `sql-formatter` 進行方言專屬詞法斷詞與 AST 縮排輸出;壓縮模式使用狀態機掃描(區分一般程式碼、單/雙引號字串、單行註解 `--` 與區塊註解 `/* */`),僅安全折疊註解與非字串區段的連續空白。
常見實務應用情境
- 將 ORM(如 Prisma、TypeORM、Hibernate)在日誌印出的冗長單行 SQL 一鍵排版成易讀的縮排查詢
- 在團隊 Code Review 或文件撰寫前,把 `SELECT` / `JOIN` / `WHERE` 統一整理成 2 空白與關鍵字大寫規範
- 把人工撰寫、附帶多行說明註解的長查詢壓縮為單行,方便放進設定檔或命令列執行
- 檢查跨方言轉移(如 MySQL 搬遷至 PostgreSQL)時報表 SQL 的結構層次
實作範例與邊界案例
PostgreSQL Query Expansion
select id,email from users where active=true order by id desc limit 10;
SELECT id, email FROM users WHERE active = true ORDER BY id DESC LIMIT 10;
Aligns SELECT columns, predicates, and sorting clauses automatically.
Comment-Safe Minification
-- prod check SELECT count(*) FROM orders;
SELECT count(*)FROM orders;
Drops line comments while keeping quoted string tokens intact.
使用限制與精準度說明
- • 極度複雜的預存程序(如 PL/pgSQL `$$` 語法區塊或特殊自訂觸發器)部分段落可能僅能維持基礎縮排。
- • 僅做靜態詞法與格式檢查,不會連線至真實資料庫伺服器驗證資料表或欄位名稱是否存在。
瀏覽器本地運算與隱私保障
傳統線上轉換網站會將您的文件、文字片段或影音檔案上傳至遠端伺服器。SQL 語法格式化與美化壓縮工具 完全在您的瀏覽器分頁內運行:
您的檔案與文字都在裝置本機計算,不會傳送內容至任何後端伺服器。
Microdeck 不會記錄或儲存您在工具內貼上的任何檔案或程式碼。
所有暫存結果僅存在目前分頁記憶體中,重設或關閉分頁後即刻清除。
常見問題 (FAQ)
壓縮(Minify)模式會不會不小心把我字串條件裡的 `--` 當成註解刪掉?
不會。我們的狀態機掃描器能精準辨識字串邊界,位於引號內的文字內容會 100% 原封不動保留。
為什麼需要區分 PostgreSQL、MySQL 與 BigQuery 方言?
不同資料庫的跳脫引號、參數佔位符(如 `$1` vs `?`)與專屬運算子(如 `->>`)不同,選對正確方言能避免語法錯斷或誤報。
可以一次貼上好幾段用分號隔開的 SQL 一起排版嗎?
可以,工具支援多語句批次格式化,並會提示基本的括號或引號配對異常。
公司的商業查詢語句與資料表結構貼上後會外洩嗎?
絕對不會。本工具純粹在您的瀏覽器本地端執行詞法重排,不會發送任何資料到雲端。