跳转到主要内容

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
MySQL 的原生 JSON 列类型在插入时验证 JSON,以二进制格式存储以便高效访问,并提供一组函数,用于读取和修改单个字段而无需解析整个文档。

存储 JSON

MySQL 在插入时验证 JSON。插入格式错误的 JSON 会报错。

读取 JSON 字段

使用 JSON_EXTRACT(column, path) 或简写 ->:
两者都返回一个 JSON 值——带引号的字符串 "Acme"。要获得不带引号的普通字符串,请使用 ->>(它是 JSON_UNQUOTE(JSON_EXTRACT(...)) 的简写):
路径语法:
  • $.key — 访问对象字段
  • $.array[0] — 按下标访问数组元素
  • $.array[*] — 数组的所有元素
  • $.** — 递归通配符(任意深度的所有值)

按 JSON 字段筛选

请注意,->> 返回字符串,所以与 '16'(而不是 16)比较才是正确的,除非您显式转换:CAST(attributes ->> '$.ram_gb' AS UNSIGNED)。

修改 JSON

关键函数:

为 JSON 字段建立索引

JSON 列本身不能直接建立索引。要为某个特定的 JSON 字段建立索引,请创建一个生成列,然后为它建立索引:
现在 WHERE attributes ->> '$.brand' = 'Acme' 可以使用 idx_brand。MySQL 能识别出生成列的表达式与查询条件相匹配。 选择 MySQL 数据类型 对此有更详细的介绍——只要您查询某个 JSON 字段的频率高到需要索引,这就是推荐的模式。

JSON 与规范化列的对比

当结构确实可变时(用户可配置的属性、事件元数据、第三方 API 载荷),请使用 JSON。当结构固定,并且您需要按字段筛选、连接或聚合时,请使用规范化列。

常见问题

我可以为 JSON 数组建立索引以支持包含查询吗?

标准索引无法直接做到。对于 JSON_CONTAINS 查询,唯一的选择是全表扫描,除非您把数组提取到单独的子表(规范化),或者在一个把数组展平的生成列上使用全文索引。对于高吞吐量的包含查询,规范化是更好的路径。

-> 和 ->> 有什么区别?

-> 返回 JSON 值(字符串带有外围引号)。->> 返回去掉引号的字符串。对于显示、拼接以及任何使用文本的场景,->> 才是您想要的。不过,通过 -> 做等值比较仍然可行:MySQL 会先把另一个操作数强制转换为 JSON,所以 attributes -> '$.brand' = 'Acme' 确实能匹配。

存储 JSON 会影响性能吗?

从一个大的 JSON 文档中读取单个字段需要解析二进制结构,这比解析文本快,但比读取原生列慢。对于频繁访问的字段,生成列加索引的模式能让读取性能与原生列相当。

故障排除

另请参阅