VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
JSON 列类型在插入时验证 JSON,以二进制格式存储以便高效访问,并提供一组函数,用于读取和修改单个字段而无需解析整个文档。
存储 JSON
读取 JSON 字段
使用JSON_EXTRACT(column, path) 或简写 ->:
"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 文档中读取单个字段需要解析二进制结构,这比解析文本快,但比读取原生列慢。对于频繁访问的字段,生成列加索引的模式能让读取性能与原生列相当。故障排除
另请参阅
- 选择 MySQL 数据类型 — 何时使用 JSON,何时使用规范化列
- MySQL 中的生成列 — 用虚拟生成列为 JSON 字段建立索引
- 从 SQL 发起 HTTP 请求 — 解析 HTTP API 响应中的 JSON