// 免费工具

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+输入 格式,以及 Ctrl+Shift+输入 压缩(⌘ 代替 Ctrl 在 Mac 上)。你的设置会记在这个浏览器里,也保留在页面地址中,因此分享链接时带出的是你的样式 – 而不是你的 SQL。

格式化器如何处理 MySQL SQL

  • 反引号和字符串。 `order` 是带引号的名称,而 "paid" 是字符串——MySQL 默认的 SQL 模式下正是如此。 始终引用 添加反引号。
  • 每种注释风格都会保留。 # 注释, -- 注释和 /*! … */ 可执行注释会留在你写入的位置。MySQL 要求在 --,而且格式化器也遵循同样的规则。
  • 变量是名称。 @rank 用户变量, @@sql_mode 系统变量和 := 赋值作为单个标记读取。
  • JSON 和空值安全运算符都保持完整。 ->, ->> 和 <=> 从不被分成 - >> 或者 <= >,它将不再运行。
  • 字面量会保留前缀。 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;

输出采用 Standard 样式和 4 空格缩进,与上方格式化器生成的结果完全一致。可将样式切换为 紧凑 用于更紧凑的 SQL,或 已展开 用于前置逗号和每行一项。该 格式化工具文档 涵盖详细信息。

MySQL 格式化工具常见问题解答

它适用于 MariaDB 吗?

是的。MariaDB 使用相同的引号、注释和变量语法,并且 /*M! … */ 可执行注释会像 MySQL 的 /*! … */ 注释一样保留。

Minify 会删除我的 /*! … */ 可执行注释吗?

不会。Minify 会删除普通注释,但会保留可执行注释和优化器提示,因为服务器会执行其中的内容。

为什么格式化器输出的 COUNT(*) 不带空格?

因为 MySQL 除非启用了 IGNORE_SPACE SQL 模式,否则不接受 COUNT、SUM 及其他一些内置函数与左括号之间的空格。

我的 SQL 会被发送到服务器吗?

不会。格式化工具编译成了 WebAssembly,在你的浏览器标签页中运行。你的 SQL 绝不会被上传、记录或存储;页面加载后,断网也能继续使用。

格式化会破坏我的查询吗?

它的设计目标就是不破坏。格式化后,SQLly 会逐个令牌地把输出与你的输入比对。如果除空白和你要求的大小写之外还有任何变化,它会把你原本的 SQL 原样返回,并告诉你原因。无法顺利解析的 SQL,例如未终止的字符串,也会原样保留,并附上问题所在的行和列。

我可以与团队共享我的格式化设置吗?

是的。包括高级设置在内的每一项设置都保存在页面地址 # 号之后,因此复制地址或点击“复制设置链接”,对方得到的就是和你完全相同的样式。链接只包含设置,绝不含你的 SQL。

// 格式化只是最次要的部分

喜欢这个格式化工具?来认识一下 SQLly 的其他功能

适用于 macOS、Windows 和 Linux 的原生 SQL 工作台,智能感知能理解你的数据库模式,高危查询有防护,这款格式化工具就内置在编辑器里。