JSON_INSERT

描述

JSON_INSERT 函数用于在 JSON 中插入数据并返回结果。

语法

JSON_INSERT (<json_str>, <path>,  <val>[, <path>,  <val>, ...])

参数

参数	描述
<json_str>	要插入的 JSON 对象。可以是任意类型元素的 JSON 对象，包括NULL，如果没有指定元素，则返回一个空数组。如果 json_str 不是有效的 JSON 或任何 path 参数不是有效的路径表达式或包含了 * 通配符，则会返回错误
<path>	要插入的 JSON 路径。如果是 NULL ，则返回 NULL
<val>	要插入 JSON 的值。如果是 NULL ，则会在对应的位置插入 NULL 的 value 值。

需要注意的是，路径值对按从左到右的顺序进行评估。

如果 JSON 中不存在该路径，则路径值对会添加该值到 JSON 中，如果路径标识某个类型的值，则：

• 对于现有对象中不存在的成员，会将新成员添加到该对象中并与新值相关联。
• 对于现有数组结束后的位置，该数组将扩展为包含新值。如果现有值不是数组，则自动转换为数组，然后再扩展为包含新值的数组。

否则，对于 JSON 中不存在的某个路径的路径值对将被忽略且不会产生任何影响。

返回值

返回一个 JSON 值。

示例

select json_insert(null, null, null);

+---------------------------------+
| json_insert(NULL, NULL, 'NULL') |
+---------------------------------+
| NULL                            |
+---------------------------------+

select json_insert('{"k": 1}', "$.k", 2);

+---------------------------------------+
| json_insert('{\"k\": 1}', '$.k', '2') |
+---------------------------------------+
| {"k":1}                               |
+---------------------------------------+

select json_insert('{"k": 1}', "$.j", 2);

+---------------------------------------+
| json_insert('{\"k\": 1}', '$.j', '2') |
+---------------------------------------+
| {"k":1,"j":2}                         |
+---------------------------------------+

select json_insert('{"k": 1}', "$.j", null);

+-----------------------------------------------+
| json_insert('{"k": 1}', '$.j', 'NULL', '660') |
+-----------------------------------------------+
| {"k":1,"j":null}                              |
+-----------------------------------------------+