JSON_ARRAY_INSERT
功能描述
JSON_ARRAY_INSERT函数用来修改JSON文档,向JSON文档中的指定的数组中的指定位置插入一个值并返回新的JSON文档。
注意事项
- 该功能仅在数据库兼容模式为MySQL时支持(即数据库实例初始化时指定DBCOMPATIBILITY='B')。
- 如果路径表达式指示的数组元素超过了数组的长度,那么新元素将插入到数组的尾部。
- 如果任何参数为NULL,则返回NULL。
语法格式
JSON_ARRAY_INSERT(json, path, value[, path2, value2] …)
参数说明
json_doc
JSON文档,它可以是一个JSON字符串,或者一个JSON列。
path
路径参数。
value
将要插入到JSON文档的元素。
示例
select json_array_insert('[1, [2, 3], {"a": [4, 5]}]', '$[0]', 0);
select json_array_insert('[1, [2, 3], {"a": [4, 5]}]', '$[9]', 4);
返回结果分别为:
json_array_insert
-------------------------------
[0, 1, [2, 3], {"a": [4, 5]}]
(1 row)
json_array_insert
-------------------------------
[1, [2, 3], {"a": [4, 5]}, 4]
(1 row)