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+输入 格式,以及 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 工作台,智能感知能理解你的数据库模式,高危查询有防护,这款格式化工具就内置在编辑器里。