KingbaseES Json 系列五--Json数据操作函数三

KingbaseES Json 系列五：Json数据操作函数三(JSONB_SET,JSONB_INSERT,JSON_QUERY)

JSON 数据类型是用来存储 JSON（JavaScript Object Notation）数据的。KingbaseES为存储JSON数据提供了两种类型:JSON和 JSONB。JSON 和 JSONB 几乎接受完全相同的值集合作为输入。

本文将主要介绍Kingbase数据库的Json数据操作函数第三部分。

准备数据：

CREATE TABLE "public"."jsontable" (
	"id" integer NULL,
	"jsondata" json NULL,
	"jsonvarchar" varchar NULL,
	"jsonarray" json NULL,
	"jsonrecord" json NULL,
	"jsonset" json NULL
);

INSERT INTO "public"."jsontable" ("id","jsondata","jsonvarchar","jsonarray","jsonrecord","jsonset") VALUES
	 (1,'{"f2":{"f3":1},"f4":{"f5":99,"f6":"foo"}}','{"f2": {"f3": 1}, "f4": {"f5": 99, "f6": "foo"}}','[1,true,[1,[2,3]],null,{"f1":1,"f2":[7,8,9]},false,"stringy"]','{"a":1,"b":"bcol","c":"cc"}','[{"a":1,"b":"bcol","c":"cc"},{"a":1,"b":"bcol","d":""}]'),
	 (2,'{"a":[1,2,3,4,5]}','{"a": [1, 2, 3, 4, 5]}','[1,2,3,4,5]','{"a":1,"b":"bcol","c":""}','[{"a":1,"b":"bcol","c":""},{"a":1,"b":"bcol","e":""}]'),
	 (3,'{"a":1, "b": ["2", "a b"],"c": {"d":4, "e": "ab c"}}','{"a": 1, "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}','[{"f1":1,"f2":null},2,null,3]','{"a":1,"b":"bcol","d":"dd"}','[{"a":1,"b":"bcol","c":"cc_3_1"},{"a":1,"b":"bcol","c":"cc_3_2"}]');

CREATE TABLE "public"."comtable" (
	"id" integer NULL,
	"name" character varying(10 char) NULL
);

INSERT INTO "public"."comtable" ("id","name") VALUES
	 (1,'a'),
	 (2,'b'),
	 (3,'c');

json函数列表

• JSONB_SET

• JSONB_INSERT

• JSON_QUERY

json函数简介

• JSONB_SET

JSONB_SET

功能：

JSON函数，返回 target 其中由 path 指定的节用 new_value 替换，如果指定的项不存在并且 create_missing 为真（默认为真）则加上 new_value 。正如面向路径的操作符一样，出现在 path 中的负整数表示从JSON数组的末尾开始数

用法：

jsonb_set(target jsonb, path text[],new_value jsonb[, create_missing boolean])

示例：

-- json数组中，path值'{p1，p2}'，p1：表示数组位置；p2：表示具体的key值。
demo=# SELECT jsonb_set('[{"f1":1,"f2":null},2,null,3]', '{0,f1}', '[2,3,4]', false);
                  jsonb_set
---------------------------------------------
 [{"f1": [2, 3, 4], "f2": null}, 2, null, 3]
(1 行记录)

-- 在数组json中，进行value替换

demo=#  select jsonarray , jsonb_set(jsonarray::jsonb , '{0}' ,'[9]' ,false) from jsontable ;
                           jsonarray                           |                                  jsonb_set
---------------------------------------------------------------+------------------------------------------------------------------------------
 [1,true,[1,[2,3]],null,{"f1":1,"f2":[7,8,9]},false,"stringy"] | [[9], true, [1, [2, 3]], null, {"f1": 1, "f2": [7, 8, 9]}, false, "stringy"]
 [1,2,3,4,5]                                                   | [[9], 2, 3, 4, 5]
 [{"f1":1,"f2":null},2,null,3]                                 | [[9], 2, null, 3]
(3 行记录)

demo=#  select jsonarray , jsonb_set(jsonarray::jsonb , '{0}' ,'9' ,false) from jsontable ;
                           jsonarray                           |                                 jsonb_set
---------------------------------------------------------------+----------------------------------------------------------------------------
 [1,true,[1,[2,3]],null,{"f1":1,"f2":[7,8,9]},false,"stringy"] | [9, true, [1, [2, 3]], null, {"f1": 1, "f2": [7, 8, 9]}, false, "stringy"]
 [1,2,3,4,5]                                                   | [9, 2, 3, 4, 5]
 [{"f1":1,"f2":null},2,null,3]                                 | [9, 2, null, 3]
(3 行记录)

demo=#  select jsonarray , jsonb_set(jsonarray::jsonb , '{0}' ,'true' ,false) from jsontable ;
                           jsonarray                           |                                   jsonb_set
---------------------------------------------------------------+-------------------------------------------------------------------------------
 [1,true,[1,[2,3]],null,{"f1":1,"f2":[7,8,9]},false,"stringy"] | [true, true, [1, [2, 3]], null, {"f1": 1, "f2": [7, 8, 9]}, false, "stringy"]
 [1,2,3,4,5]                                                   | [true, 2, 3, 4, 5]
 [{"f1":1,"f2":null},2,null,3]                                 | [true, 2, null, 3]
(3 行记录)

demo=#  select jsonarray , jsonb_set(jsonarray::jsonb , '{0}' ,'"a"' ,false) from jsontable ;
                           jsonarray                           |                                  jsonb_set
---------------------------------------------------------------+------------------------------------------------------------------------------
 [1,true,[1,[2,3]],null,{"f1":1,"f2":[7,8,9]},false,"stringy"] | ["a", true, [1, [2, 3]], null, {"f1": 1, "f2": [7, 8, 9]}, false, "stringy"]
 [1,2,3,4,5]                                                   | ["a", 2, 3, 4, 5]
 [{"f1":1,"f2":null},2,null,3]                                 | ["a", 2, null, 3]
(3 行记录)

-- json对象值替换

demo=# select jsonrecord , jsonb_set(jsonrecord , '{a}' ,'2' ,false ) from jsontable ;
         jsonrecord          |            jsonb_set
-----------------------------+----------------------------------
 {"a":1,"b":"bcol","c":"cc"} | {"a": 2, "b": "bcol", "c": "cc"}
 {"a":1,"b":"bcol","c":""}   | {"a": 2, "b": "bcol", "c": ""}
 {"a":1,"b":"bcol","d":"dd"} | {"a": 2, "b": "bcol", "d": "dd"}
(3 行记录)

-- json对象或者所在位置不存在时，忽略值

demo=# SELECT jsonb_set('[{"f1":1,"f2":null},2,null,3]', '{0,f3}', '[2,3,4]', false);
              jsonb_set
-------------------------------------
 [{"f1": 1, "f2": null}, 2, null, 3]
(1 行记录)

demo=# SELECT jsonb_set('[{"f1":1,"f2":null},2,null,3]', '{8}', '[2,3,4]', false);
              jsonb_set
-------------------------------------
 [{"f1": 1, "f2": null}, 2, null, 3]
(1 行记录)

-- 指定的项不存在并且create_missing 为真（默认为真）则加上 new_value

demo=# SELECT jsonb_set('[{"f1":1,"f2":null},2,null,3]', '{0,f3}', '[2,3,4]', true);
                      jsonb_set
------------------------------------------------------
 [{"f1": 1, "f2": null, "f3": [2, 3, 4]}, 2, null, 3]
(1 行记录)

JSONB_INSERT

功能：

JSON处理函数，返回被插入了 new_value 的 target 。如果 path 指定的 target 节在一个JSONB数组中， new_value 将被插入到目标之前（ insert_after 默认为false）或者之后（ insert_after 为true）。如果 path 指定的 target 节在一个JSONB对象内，则只有当 target 不存在时才插入 new_value。对于面向路径的操作符来说，出现在 path 中的负整数表示从JSONB数组的末尾开始计数。

用法：

jsonb_insert(target jsonb, path text[], new_value jsonb [, insert_after boolean])

示例：

-- 插入新值数据
demo=# SELECT JSONB_INSERT('[{"f1":1,"f2":null},2,null,3]', '{0,f3}', '[2,3,4]', false);
                     JSONB_INSERT
------------------------------------------------------
 [{"f1": 1, "f2": null, "f3": [2, 3, 4]}, 2, null, 3]
(1 行记录)

-- 值存在时，不进行替换
demo=# SELECT JSONB_INSERT('[{"f1":1,"f2":null},2,null,3]', '{0,f2}', '[2,3,4]', false);
错误:  不能替换已经存在的键
提示:  尝试使用 jsonb_set 来替换键值。

-- 通过参数insert_after设置插入位置之前或之后

demo=# SELECT JSONB_INSERT('[{"f1":1,"f2":null},2,null,3]', '{1}', '[2,3,4]', false );
                  JSONB_INSERT
------------------------------------------------
 [{"f1": 1, "f2": null}, [2, 3, 4], 2, null, 3]
(1 行记录)

demo=# SELECT JSONB_INSERT('[{"f1":1,"f2":null},2,null,3]', '{1}', '[2,3,4]', true );
                  JSONB_INSERT
------------------------------------------------
 [{"f1": 1, "f2": null}, 2, [2, 3, 4], null, 3]
(1 行记录)

JSON_QUERY

功能：

JSON函数，用于从一个输入的json文本中根据指定的jsonpath路径检索所需的值（可以为标量值，也可以为对象或者数组）。

用法：

   json_query (
     expression [FORMAT JSON [ENCODING UTF8]],JSON_basic_path_expression
     [ PASSING { value AS varname } [, ...]]
     [ RETURNING data_type [ FORMAT JSON [ ENCODING UTF8 ] ]
     [ { WITHOUT | WITH { CONDITIONAL | [UNCONDITIONAL] } } [ ARRAY ] WRAPPER ]
     [ { KEEP | OMIT } QUOTES [ ON SCALAR STRING ] ]
     [{ERROR|NULL|EMPTY|EMPTY ARRAY|EMPTY OBJECT|DEFAULT expression } ON EMPTY ]
     [{ERROR|NULL|EMPTY|EMPTY ARRAY|EMPTY OBJECT|DEFAULT expression } ON ERROR ]
   )

   expression：输入的json文本，完整的支持可以为字符常量、函数、或者列名（数据类型为clob,blob或者varchar2），V8R6C7版本只支持输入类型为JSONB类型，其他类型后续补充；
   FORMAT JSON：是在expression为字符串类型时将expression格式化成json格式。
   ENCODING UTF8：指定输入为二进制类型时的字符集。
   json_basic_path_expression：用于指定json文件所要查询的路径。
   PASSING { value AS varname } [, ...]:将varname变量的值替换成value进行查询，需要注意
     a.varname为非限定标识符（不带双引号）时会自动转换为小写，为限定标识符（带双引号）时原样存储不进行大小写转换。
     b.varname的数据类型应与检索值相同。
   RETURNING data_type：指定返回值的数据类型。
   { WITHOUT | WITH { CONDITIONAL | [UNCONDITIONAL] } } [ ARRAY ] WRAPPER：控制JSON_QUERY函数返回值是否用方括号“[]”包围。
     a.WITHOUT WRAPPER：默认选项，返回值不用‘[]’包围。
     b.WITH WRAPPER:返回值用‘[]’包围，等价于WITH ARRAY WRAPPER。
     c.WITH UNCONDITIONAL WRAPPER:等价于WITH WRAPPER.
     d.WITH CONDITIONAL WRAPPER：
       * 如果匹配到多个值或单个标量值，与WITH WRAPPER相同；
       * 如果匹配到单个对象或者数组，与WITHOUT WRAPPER相同。
   { KEEP | OMIT } QUOTES [ ON SCALAR STRING ]:Quotes子句指定当返回值为标量字符串时是否保留双引号（“”）.
     a.指定KEEP时保留，此为默认选项；
     b.指定OMIT时不保留。
     c.QUOTES子句不能与WITH WRAPPER子句共用。
     d.ON SCALAR STRING关键字只为语法清晰，添加与否对结果无影响。
   {ERROR|NULL|EMPTY|EMPTY ARRAY|EMPTY OBJECT|DEFAULT expression } ON ERROR：指定错误发生时的返回值。
     a.NULL ON ERROR - 返回NULL,此为默认选项
     b.ERROR ON ERROR - 报错
     c.EMPTY ON ERROR - 等价于 EMPTY ARRAY ON ERROR.
     d.EMPTY ARRAY ON ERROR - 返回空数组 ([])
     e.EMPTY OBJECT ON ERROR - 返回空对象 ({})
   {ERROR|NULL|EMPTY|EMPTY ARRAY|EMPTY OBJECT|DEFAULT expression } ON EMPTY：指定没有结果相匹配时的返回值。
     a.NULL ON EMPTY - 返回NULL,此为默认选项
     b.ERROR ON EMPTY - 报错
     c.EMPTY ON EMPTY - 等价于 EMPTY ARRAY ON ERROR.
     d.EMPTY ARRAY ON EMPTY - 返回空数组 ([])
     e.EMPTY OBJECT ON EMPTY - 返回空对象 ({})

示例：

-- JSON_basic_path_expression支持部分函数的使用(size,type,double,ceiling,floor,abs)

demo=# select json_query('[1,2,3,4,5]'::jsonb,'$.size()') ;
 json_query
------------
 5
(1 行记录)

demo=# select json_query(' {"a":1,"b":"bcol","c":"cc"}'::jsonb,'$.b.type()') ;
 json_query
------------
 "string"
(1 行记录)

demo=# select json_query(' {"a":-1,"b":"bcol","c":"cc"}'::jsonb,'$.a.abs()') ;
 json_query
------------
 1
(1 行记录)

-- JSON_basic_path_expression数组数据检索

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.a');
   json_query
-----------------
 [1, 2, 3, 4, 5]
(1 行记录)

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.a[2]');
 json_query
------------
 3
(1 行记录)

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.a.size()');
 json_query
------------
 5
(1 行记录)

-- JSON_basic_path_expression 数据筛选，只能返回一条数据，多条数据返回空值

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.a[*] ? ( @ > 4)');
 json_query
------------
 5
(1 行记录)

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.a[*] ? ( @ > 3)');
 json_query
------------

(1 行记录)

-- 通过passing传递参数

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.a[*] ? ( @ > $x)' passing 4 as x);
 json_query
------------
 5
(1 行记录)

-- 通过returning返回值类型，并设置是否使用方括号“[]”包围（WITH WRAPPER）

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.a[*] ? ( @ > 4)' returning text);
 json_query
------------
 5
(1 行记录)

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.a[*] ? ( @ > 4)' returning text WITH WRAPPER);
 json_query
------------
 [5]
(1 行记录)

-- 指定当返回值为字符串时是否保留双引号（“”）.

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.c.e' KEEP QUOTES);
 json_query
------------
 "ab c"
(1 行记录)

-- 指定错误发生时的返回值。

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.c.e' returning int null on error);
 json_query
------------

(1 行记录)

-- 指定没有结果相匹配时的返回值

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.c.f' EMPTY ARRAY ON EMPTY);
 json_query
------------
 []
(1 行记录)

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.c.f' EMPTY OBJECT ON EMPTY);
 json_query
------------
 {}
(1 行记录)

demo=# select json_query('{"a": [1, 2, 3, 4, 5], "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}'::jsonb,'$.c.f' returning text DEFAULT 'emp' on empty);
 json_query
------------
 emp
(1 行记录)