JSON_APPEND
功能描述
JSON_APPEND函数功能同JSON_ARRAY_APPEND函数,详细内容请参考JSON_ARRAY_APPEND。
注意事项
- 该功能仅在数据库兼容模式为MySQL时支持(即数据库初始化时指定DBCOMPATIBILITY='B')。
- 在指定的数组位置末尾追加元素,假如指定的位置不是数组追加完过后就变成了数组。
- 如果任何参数为 NULL,则返回 NULL。
- JSON_APPEND函数可能在将来的版本中被删除,推荐使用JSON_ARRAY_APPEND函数。
语法格式
JSON_APPEND(json_doc, path, val[, path, val] …)
参数说明
json_doc
JSON文档,它可以是一个JSON字符串,或者一个JSON列。
path
路径参数。
val
将要追加到JSON文档的元素。
示例
select JSON_APPEND('{"name": "Tim", "hobby": ["car"]}', '$.car', 'food');
select JSON_APPEND('[1, [2, 3]]'::varchar(20), '$[1]', null);
返回结果分别为:
json_append
-----------------------------------
{"name": "Tim", "hobby": ["car"]}
(1 row)
json_append
-------------------
[1, [2, 3, null]]
(1 row)