MySQL 格式化工具
在你的瀏覽器中格式化 MySQL 和 MariaDB 查詢。反引號、# 註解、@ 變數和 JSON 運算子按照 MySQL 的方式解析,你貼上的任何內容都不會上傳。
格式化器的每個版面配置設定,按群組分類 編輯器 › 格式化 在 SQLly 應用程式中。上方的樣式是起點;你在此處更改的任何內容都會被標記。
將 .sql 檔案拖到這裡以開啟。它會在你的瀏覽器中讀取,而不是上傳。
# monthly revenue by channel
SELECT
DATE_FORMAT(o.`created_at`, '%Y-%m') AS `month`,
o.meta ->> '$.channel' AS channel,
SUM(oi.`qty` * oi.`price`) AS revenue
FROM
`orders` o
JOIN `order_items` oi ON oi.`order_id` = o.`id`
WHERE
o.`status` = "paid"
AND o.`customer_id` <=> @customer
GROUP BY
`month`,
channel
ORDER BY
`month` DESC
LIMIT 12;
Loading the formatter…
編輯器中的快速鍵: Ctrl+Enter 鍵 會進行格式化,而 Ctrl+Shift+Enter 鍵 縮小(⌘ 而不是 Ctrl 在 Mac 上)。你的設定會記在這個瀏覽器裡,並保存在頁面位址中,所以分享連結帶的是你的樣式 —— 絕不會是你的 SQL。
格式化工具對 MySQL SQL 的處理方式
- 反引號與字串。
`order`是加引號的名稱,而"paid"是字串,就像 MySQL 的預設 SQL 模式。 一律加引號 會加上反引號。 - 每種註解樣式都會保留。
#註解、--註解以及/*! … */可執行註解會保持在你撰寫的位置。MySQL 在--,而格式化工具也遵循同一條規則。 - 變數是名稱。
@rank使用者變數、@@sql_mode系統變數以及:=指派都會當成單一 token 讀取。 - JSON 和 null 安全運算子會保持完整。
->,->>和<=>永遠不會被拆成- >>或<= >,將無法再執行。 - 字面值會保留其前綴。
b'0101',x'ff',N'…'以及字元集引導符號,例如_utf8mb4'…'會緊跟在後,因此不會被當成帶別名的欄位。 - 用引號保障大小寫。 在 Linux 上,資料表名稱可能區分大小寫,所以 移除不必要的引號 僅對小寫名稱取消加引號。
小知識
- 預設情況下,MySQL 會拒絕在內建函式之間使用空格,例如
COUNT或SUM以及它們的括號。格式化程式會寫入COUNT(*)而 Minify 會讓呼叫保持你撰寫的原樣;只有當你開啟 函式括號前加空格 如果你的伺服器執行於IGNORE_SPACE.
範例
MySQL 前後
# monthly revenue by channel select date_format(o.`created_at`,'%Y-%m') as `month`,o.meta->>'$.channel' as channel,sum(oi.`qty`*oi.`price`) as revenue from `orders` o join `order_items` oi on oi.`order_id`=o.`id` where o.`status`="paid" and o.`customer_id`<=>@customer group by `month`,channel order by `month` desc limit 12;
# monthly revenue by channel
SELECT
DATE_FORMAT(o.`created_at`, '%Y-%m') AS `month`,
o.meta ->> '$.channel' AS channel,
SUM(oi.`qty` * oi.`price`) AS revenue
FROM
`orders` o
JOIN `order_items` oi ON oi.`order_id` = o.`id`
WHERE
o.`status` = "paid"
AND o.`customer_id` <=> @customer
GROUP BY
`month`,
channel
ORDER BY
`month` DESC
LIMIT 12;
輸出使用標準樣式與 4 格空白縮排,和上面的格式化工具產出的完全一樣。把樣式切換到 緊湊 可用於更精簡的 SQL 或 展開 用於前置逗號及每行一個項目。 格式化工具文件 涵蓋了詳細資訊。
MySQL 格式化工具常見問題
它適用於 MariaDB 嗎?
是的。MariaDB 使用相同的引號、註解和變數語法,並且 /*M! … */ 可執行註解會像 MySQL 的 /*! … */ 註解一樣保留。
Minify 會刪除我的 /*! … */ 可執行註解嗎?
不會。Minify 會刪除一般註解,但保留可執行註解和最佳化提示,因為伺服器會執行其中的內容。
為什麼格式化工具寫 COUNT(*) 時沒有空格?
因為 MySQL 在未啟用 IGNORE_SPACE SQL 模式時,不接受 COUNT、SUM 等內建函式名稱與左括號之間有空白。
我的 SQL 會被傳送到伺服器嗎?
不會。該格式化工具已編譯為 WebAssembly,並在你的瀏覽器分頁中執行。你的 SQL 永遠不會被上傳、記錄或儲存,一旦頁面載入,它就能離線運作。
格式化會破壞我的查詢嗎?
它的設計就是不會。格式化之後,SQLly 會將輸出與你的輸入逐個 token 比對,如果除了空白與你指定的大小寫之外還有任何改變,它會把你的 SQL 原樣退回,並告訴你原因。無法順利解析的 SQL,例如未結束的字串,也會保持原樣,並指出問題所在的行與欄。
我可以與團隊共用我的格式化設定嗎?
是的。包括進階設定在內的每一項設定,都會保存在網址 # 號之後,複製網址或按「複製設定連結」就能分享你確切的樣式。連結只保存設定,絕不包含你的 SQL。
喜歡這個格式化工具嗎?來看看 SQLly 的其他功能吧
原生 SQL 工作台,支援 macOS、Windows 和 Linux,IntelliSense 認得你的結構描述,高風險查詢有防護,這套格式化工具也內建在編輯器裡。