json_insert

Description

Syntax

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

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

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

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

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

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

example

  1. MySQL> select json_insert(null, null, null);
  2. +---------------------------------+
  3. | json_insert(NULL, NULL, 'NULL') |
  4. +---------------------------------+
  5. | NULL |
  6. +---------------------------------+
  7. MySQL> select json_insert('{"k": 1}', "$.k", 2);
  8. +---------------------------------------+
  9. | json_insert('{\"k\": 1}', '$.k', '2') |
  10. +---------------------------------------+
  11. | {"k":1} |
  12. +---------------------------------------+
  13. MySQL> select json_insert('{"k": 1}', "$.j", 2);
  14. +---------------------------------------+
  15. | json_insert('{\"k\": 1}', '$.j', '2') |
  16. +---------------------------------------+
  17. | {"k":1,"j":2} |
  18. +---------------------------------------+

keywords

JSON, json_insert