JSON_TABLE需严格匹配路径与结构:首参必须为合法JSON值,COLUMNS中路径须精确对应,数组用[*]展开,嵌套用NESTED PATH,避免全量展开性能损耗。

JSON_TABLE 语法结构必须严格匹配路径和列定义
MySQL 8.0.4+ 引入 JSON_TABLE,它不是“自动解析 JSON 字符串”,而是把 JSON 文档按预设路径展开为行集——本质是声明式映射。常见错误是直接对 JSON_EXTRACT 结果套用 JSON_TABLE,结果报错 Invalid JSON text 或空结果。根本原因是:输入必须是合法 JSON 文档(字符串或 JSON 类型字段),且路径表达式必须与实际结构完全一致。
关键点:
-
JSON_TABLE第一个参数必须是 JSON 值,不能是未解析的 TEXT 字段(除非先用CAST(col AS JSON)转换) -
COLUMNS子句中每个列定义必须显式指定路径,如name VARCHAR(50) PATH '$.user.name';路径不存在时该列返回 NULL,不报错 - 数组路径需用
*展开,例如$.items[*],否则只取第一个元素 - 嵌套对象若要展开多层,必须用
Nested PATH显式声明,不能靠点号链式访问
处理 JSON 数组时必须用 [*] 通配符,否则只取首项
这是最常踩的坑:传入 '[{"id":1,"tag":"a"},{"id":2,"tag":"b"}]',却写 PATH '$.id',结果只得到一行 id=1。因为 $ 指向整个数组,$.id 在数组上下文中无效,MySQL 默认回退到第一个元素。
正确做法:
- 用
PATH '$[*]'将数组每一项作为一行输入 - 再在
COLUMNS中定义子路径,如id INT PATH '$.id', tag VARCHAR(10) PATH '$.tag' - 如果数组嵌套在对象里,比如
{"data":[{"id":1}]},路径必须写成'$.data[*]',不能省略data
示例:
SELECT jt.* FROM JSON_TABLE(
'[{"id":1,"name":"Alice"},{"id":2,"name":"Bob"}]',
'$[*]' COLUMNS (
id INT PATH '$.id',
name VARCHAR(20) PATH '$.name'
)
) AS jt;
嵌套 JSON 对象需用 NESTED PATH 显式展开
当 JSON 包含多层嵌套(如用户信息 + 多个地址 + 每个地址多个电话),仅靠单层 COLUMNS 无法拉平。试图用 phone VARCHAR(20) PATH '$.addresses[0].phones[0].number' 只能取固定位置,不可扩展。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
解决方案是嵌套 NESTED PATH:
- 外层
COLUMNS定义主对象字段(如 user.id, user.name) - 用
NESTED PATH '$.addresses[*]'开启子表,再在其内定义地址字段 - 可继续嵌套
NESTED PATH '$.phones[*]'展开电话列表 - 每级
NESTED PATH会生成笛卡尔积,注意数据膨胀
示例(简化):
SELECT u.id, u.name, a.city, p.number
FROM JSON_TABLE(
'{"user":{"id":100,"name":"Tom"},"addresses":[{"city":"Beijing","phones":[{"number":"123"}]}]}',
'$' COLUMNS (
id INT PATH '$.user.id',
name VARCHAR(20) PATH '$.user.name',
NESTED PATH '$.user.addresses[*]' COLUMNS (
city VARCHAR(20) PATH '$.city',
NESTED PATH '$.phones[*]' COLUMNS (
number VARCHAR(20) PATH '$.number'
)
)
)
) AS u;
性能敏感场景下避免在 WHERE 中对 JSON_TABLE 结果二次过滤
JSON_TABLE 是物化操作,MySQL 会先完整展开所有行,再执行后续 WHERE。如果原始 JSON 很大(如千级数组),但你只需要其中 tag = "urgent" 的几条,直接在 JSON_TABLE 外加 WHERE 会导致全量展开浪费 CPU 和内存。
更优方式:
- 先用
JSON_CONTAINS或JSON_SEARCH在原 JSON 字段上做粗筛,缩小参与JSON_TABLE的记录范围 - 或在应用层预处理:用
JSON_EXTRACT提前过滤出目标子数组,再传给JSON_TABLE -
JSON_TABLE本身不支持谓词下推,无法跳过无关路径
真正容易被忽略的是:虚表一旦生成,就脱离了 JSON 的二进制存储优势,后续所有操作都走普通行式处理——所以展开粒度越细、行数越多,代价越高。别为了“看起来简洁”就把整棵 JSON 树一次性 flatten。










