// 免費工具

MySQL 格式化工具

在你的瀏覽器中格式化 MySQL 和 MariaDB 查詢。反引號、# 註解、@ 變數和 JSON 運算子按照 MySQL 的方式解析,你貼上的任何內容都不會上傳。

將 .sql 檔案拖到這裡以開啟。它會在你的瀏覽器中讀取,而不是上傳。

格式化後的 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 認得你的結構描述,高風險查詢有防護,這套格式化工具也內建在編輯器裡。