json_set

SinceVersion dev

Description

Syntax

VARCHAR json_set(VARCHAR json_str, VARCHAR path, VARCHAR val[, VARCHAR path, VARCHAR val] ...)

json_set 函数在 JSON 中插入或更新数据并返回结果。如果 json_str 或 path 为 NULL，则返回 NULL。否则，如果 json_str 不是有效的 JSON 或任何 path 参数不是有效的路径表达式或包含了 * 通配符，则会返回错误。

路径值对按从左到右的顺序进行评估。

如果 JSON 中已存在某个路径，则路径值对会将现有 JSON 值覆盖为新值。如果 JSON 中不存在该路径，则路径值对会添加该值到 JSON 中，如果路径标识某个类型的值，则：

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

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

example

1. MySQL> select json_set(null, null, null);
2. +------------------------------+
3. | json_set(NULL, NULL, 'NULL') |
4. +------------------------------+
5. | NULL                         |
6. +------------------------------+

8. MySQL> select json_set('{"k": 1}', "$.k", 2);
9. +------------------------------------+
10. | json_set('{\"k\": 1}', '$.k', '2') |
11. +------------------------------------+
12. | {"k":2}                            |
13. +------------------------------------+

15. MySQL> select json_set('{"k": 1}', "$.j", 2);
16. +------------------------------------+
17. | json_set('{\"k\": 1}', '$.j', '2') |
18. +------------------------------------+
19. | {"k":1,"j":2}                      |
20. +------------------------------------+

keywords

JSON, json_set