VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

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)