KingbaseES Json 系列一：Json构造函数

KingbaseES Json 系列一--Json构造函数(JSON,ROW_TO_JSON,TO_JSON,TO_JSONB)

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
);

INSERT INTO public.jsontable ("id","jsondata","jsonvarchar","jsonarray") 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"]'),
	 (2,'{"a":[1,2,3,4,5]}','{"a": [1, 2, 3, 4, 5]}','[1,2,3,4,5]'),
	 (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]');

json函数列表

• JSON

• ROW_TO_JSON

• TO_JSON

• TO_JSONB

json函数简介

JSON

功能：

JSON函数，使用JSON数据类型构造函数来解析文档的JSON输入（标量、对象或者数组），返回一个JSON类型的实例。

用法：

json (
  expression [ FORMAT JSON [ ENCODING UTF8 ] ]
  [ { WITH | WITHOUT } UNIQUE [ KEYS ] ]
  [ RETURNING json_data_type ]
)
expression [ FORMAT JSON [ENCODING UTF8] ]：字符串expression提供了JSON的文本数据。可以是字符串类型：varchar、char、text、varchar2、nvarchar2、nvarchar、clob、nclob，或者UTF8编码的二进制类型（bytea、blob）。
{ WITH | WITHOUT } UNIQUE [ KEYS ]：定义是否允许重复键。
RETURNING json_data_type：指定生成的JSON对象的返回类型的输出子句。只能返回JSON或者JSONB类型。

示例：

demo=# select json('[1,2,3,4,5]') ;
    json
-------------
 [1,2,3,4,5]
(1 行记录)

demo=# select json(jsonvarchar) from jsontable ;
                          json
---------------------------------------------------------
 {"f2": {"f3": 1}, "f4": {"f5": 99, "f6": "foo"}}
 {"a": [1, 2, 3, 4, 5]}
 {"a": 1, "b": ["2", "a b"], "c": {"d": 4, "e": "ab c"}}
(3 行记录)

ROW_TO_JSON

功能：

把行作为一个 JSON对象返回。如果pretty_bool为真，将在第1层元素之间增加换行。

用法：

row_to_json(record [, pretty_bool])

示例：

demo=# select row_to_json(row(1,'foo'));
     row_to_json
---------------------
 {"f1":1,"f2":"foo"}
(1 行记录)

demo=# select row_to_json(row(id,jsonvarchar)) from jsontable;
                                       row_to_json
-----------------------------------------------------------------------------------------
 {"f1":1,"f2":"{\"f2\": {\"f3\": 1}, \"f4\": {\"f5\": 99, \"f6\": \"foo\"}}"}
 {"f1":2,"f2":"{\"a\": [1, 2, 3, 4, 5]}"}
 {"f1":3,"f2":"{\"a\": 1, \"b\": [\"2\", \"a b\"], \"c\": {\"d\": 4, \"e\": \"ab c\"}}"}
(3 行记录)

demo=# select row_to_json(row(id,jsonvarchar) , true) from jsontable;
                                   row_to_json
----------------------------------------------------------------------------------
 {"f1":1,                                                                        +
  "f2":"{\"f2\": {\"f3\": 1}, \"f4\": {\"f5\": 99, \"f6\": \"foo\"}}"}
 {"f1":2,                                                                        +
  "f2":"{\"a\": [1, 2, 3, 4, 5]}"}
 {"f1":3,                                                                        +
  "f2":"{\"a\": 1, \"b\": [\"2\", \"a b\"], \"c\": {\"d\": 4, \"e\": \"ab c\"}}"}
(3 行记录)

TO_JSON

功能：

to_json(anyelement) 把值返回为json。

用法：

to_json(anyelement)

示例：

demo=#  select to_json(true);
 to_json
---------
 true
(1 行记录)

demo=# select to_json('abcd'::text);
 to_json
---------
 "abcd"
(1 行记录)

demo=# select to_json(array['a','b']);
  to_json
-----------
 ["a","b"]
(1 行记录)

demo=#  select to_json(id) from jsontable ;
 to_json
---------
 1
 2
 3
(3 行记录)

TO_JSONB

功能：

to_json(anyelement) 把值返回为jsonb。

用法：

to_jsonb(anyelement)

示例：

demo=# select to_jsonb(true);
 to_jsonb
----------
 true
(1 行记录)

demo=# select to_jsonb('abcd'::text);
 to_jsonb
----------
 "abcd"
(1 行记录)

demo=# select to_jsonb(array['a','b']);
  to_jsonb
------------
 ["a", "b"]
(1 行记录)

demo=#  select to_jsonb(id) from jsontable ;
 to_jsonb
----------
 1
 2
 3
(3 行记录)