登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  MySQL

MySQL JSON_TABLE 怎样给数组元素生成序号

来源:17golang原创

时间:2026-11-16 18:08:17 336浏览 收藏

如果 JSON 数组展开后还要保留“这是第几个元素”,不要在应用层再用变量补序号。MySQL 的 JSON_TABLE() 可以在 COLUMNS 中声明 FOR ORDINALITY 列,让每个行源元素得到从 1 开始的无符号整数序号。

官方地址:https://dev.mysql.com/doc/refman/8.4/en/json-table-functions.html

先记住这几个边界
  • FOR ORDINALITY 生成的是结果行序号,起点为 1,不是 JSON 文本里的从 0 开始的数组下标。
  • 行数由外层路径决定;路径匹配到几个元素,就产生几行。
  • 序号列写在 COLUMNS 中,不需要再提供 PATH。
  • 嵌套数组要在对应的 NESTED PATH 中分别声明序号,父序号和子序号的作用域不同。

先看 JSON_TABLE 把什么变成了行

JSON_TABLE() 接收 JSON 表达式和行路径,再按 COLUMNS 把每个匹配项投影成关系表的一行。下面的数组有三个对象,$[*] 表示每个对象都是一个行源:

SELECT jt.*
FROM JSON_TABLE(
    -- $[*] 让数组中的每个对象成为一行
    '[{"name":"Go"},{"name":"MySQL"},{"name":"Redis"}]',
    '$[*]' COLUMNS (
        -- PATH 从当前对象读取业务字段
        name VARCHAR(32) PATH '$.name'
    )
) AS jt;

这一步只得到业务字段,还没有顺序信息。需要在同一个 COLUMNS 中增加一个序号列。

MySQL JSON_TABLE 的 JSON 表达式、数组行源、COLUMNS 字段、FOR ORDINALITY 序号列和关系表结果静态关系图
图1:输入与结果关系说明图,展示 JSON 表达式如何经过行路径和 COLUMNS 生成带序号的关系表;这是静态说明图,不是数据库运行截图。

用 FOR ORDINALITY 生成从 1 开始的序号

声明形式是“列名 FOR ORDINALITY”。它不读取 JSON 中的字段,而是为每个行源产生递增的序号:

SELECT jt.position, jt.name
FROM JSON_TABLE(
    -- 输入数组的三个元素会对应三行
    '[{"name":"Go"},{"name":"MySQL"},{"name":"Redis"}]',
    '$[*]' COLUMNS (
        -- FOR ORDINALITY 自动生成从 1 开始的行号
        position FOR ORDINALITY,
        -- PATH 读取当前行对象里的 name
        name VARCHAR(32) PATH '$.name'
    )
) AS jt
ORDER BY jt.position;

结果中的 position 依次是 1、2、3。它适合做展示顺序、批量导入的原始位置或后续关联键的一部分,但不要把它误当作 JSON 数组下标;如果业务接口要求下标从 0 开始,可以在查询结果层使用 position - 1 显式转换。

嵌套数组要分别保留父序号和子序号

当每个父对象内部还有数组时,外层序号表示父对象位置,内层序号表示当前父对象中的子元素位置。两个序号不能只保留一个,否则多个父对象的子序号都会从 1 重新开始,无法定位完整路径:

SELECT jt.parent_no, jt.child_no, jt.item
FROM JSON_TABLE(
    -- 外层数组确定父对象的行源
    '[{"items":["a","b"]},{"items":["c"]}]',
    '$[*]' COLUMNS (
        -- 父序号在外层对象范围内计数
        parent_no FOR ORDINALITY,
        -- NESTED PATH 为每个父对象展开 items 子数组
        NESTED PATH '$.items[*]' COLUMNS (
            -- 子序号在当前父对象的子数组范围内重新计数
            child_no FOR ORDINALITY,
            -- $ 表示当前子数组元素本身
            item VARCHAR(32) PATH '$'
        )
    )
) AS jt
ORDER BY jt.parent_no, jt.child_no;

这里的关键不是把两个序号拼成一个字符串,而是保留它们的层级含义:父对象 1 的子元素是 (1,1)、(1,2),父对象 2 的子元素是 (2,1)。需要持久化时,可以在外层查询中组合成业务键。

MySQL JSON_TABLE 的父对象序号、NESTED PATH 子数组、子元素序号和层级定位关系静态结构图
图2:嵌套序号关系说明图,突出父序号与子序号的不同作用域;这是原创结构图,不是运行结果。

序号、缺失字段和 JSON null 不是一回事

FOR ORDINALITY 只负责编号,不会替代普通字段的 PATH、ON EMPTY 或 ON ERROR 处理。字段不存在时,可以指定默认值或 NULL;JSON 中明确写出的 null 也应按列定义处理。不要用“序号连续”推断业务字段一定存在。

SELECT jt.position, jt.code
FROM JSON_TABLE(
    -- 第二个对象缺少 code,第三个对象显式为 JSON null
    '[{"code":"A"},{},{"code":null}]',
    '$[*]' COLUMNS (
        -- 序号仍按行源位置连续生成
        position FOR ORDINALITY,
        -- ON EMPTY 和 ON ERROR 明确异常字段的返回策略
        code VARCHAR(16) PATH '$.code' NULL ON EMPTY NULL ON ERROR
    )
) AS jt;

如果只想取前两个结果,可以在外层使用 WHERE position ;如果要保证输出顺序,则保留 ORDER BY position。查询结果的顺序不应依赖没有写出的隐含排序。

常见疑问

FOR ORDINALITY 是从 0 还是从 1 开始?

从 1 开始。它是 JSON_TABLE 结果中的行计数器,不是 JavaScript 或多数编程语言使用的数组下标。

能不能用 PATH 读取数组下标?

本文场景优先使用 FOR ORDINALITY,因为它直接表达结果行位置。若业务需要原始 JSON 路径文本,应另行设计字段,不要把序号列和路径字段混为一谈。

嵌套数组为什么要声明两个序号?

因为 NESTED PATH 会在每个父对象的子数组范围内重新计数。父序号和子序号组合起来,才能表达完整的层级位置。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>