跳到主要内容
版本:3.0

json_each

功能

将 JSON 对象的最外层按照键和值展开为两列,返回一行或多行数据的集合。

语法

JSON_EACH(json_object_expr)

参数说明

json_object_expr:JSON 对象的表达式,可以是 JSON 类型的列,或者 PARSE_JSON 等 JSON 函数构造的 JSON 对象。

返回值说明

返回键和值两列。键的列名为 key,值的列名为 value。键、值的列类型分别为 VARCHAR 和 JSON。

由于 key 是关键字,在 select 语句中指定列名时,需要用 t.`key` 这种方式(见下面示例)。

注意事项

JSON_EACH 属于表函数,返回的是行的集合。因此 JSON_EACH 必须在 FROM 子句中通过 LATERAL 连接使用(LATERAL 关键字可省略),不能用于 SELECT 子句。

示例

-- 本示例以表tj进行说明。
mysql> SELECT * FROM tj;
+------+------------------+
| id | j |
+------+------------------+
| 1 | {"a": 1, "b": 2} |
| 3 | {"a": 3} |
+------+------------------+

-- 表tj中j列为JSON类型的对象,将其按照键和值展开为两列,得到多行数据的集合,然后通过LATERAL连接表tj。
mysql> SELECT * FROM tj, LATERAL JSON_EACH(j);
+------+------------------+------+-------+
| id | j | key | value |
+------+------------------+------+-------+
| 1 | {"a": 1, "b": 2} | a | 1 |
| 1 | {"a": 1, "b": 2} | b | 2 |
| 3 | {"a": 3} | a | 3 |
+------+------------------+------+-------+

mysql> SELECT tj.*, t2.`key` as j_key, t2.value as j_val FROM tj, LATERAL JSON_EACH(j) as t2;
+------+------------------+-------+-------+
| id | j | j_key | j_val |
+------+------------------+-------+-------+
| 1 | {"a": 1, "b": 2} | a | 1 |
| 1 | {"a": 1, "b": 2} | b | 2 |
| 3 | {"a": 3} | a | 3 |
+------+------------------+-------+-------+