GBase 8c 数据类型——JSON/JSONB类型

JSON/JSONB类型
 

JSON(JavaScript Object Notation)数据，可以是单独的一个标量，也可以是一个数组，也可以是一个键值对象。其中数组和对象可以统称容器(container)：

l 标量(scalar)：单一的数字、bool、string、null都可以叫做标量。

l 数组(array)：[]结构，里面存放的元素可以是任意类型的JSON，并且不要求数组内所有元素都是同一类型。

l 对象(object)：{}结构，存储key:value的键值对，其键只能是用“”包裹起来的字符串，值可以是任意类型的JSON，对于重复的键，按最后一个键值对为准。

GBase 8c支持两种存储JSON数据的类型：JSON和JSONB。其中JSON是对输入的字符串的完整拷贝，使用时再去解析，所以它会保留输入的空格、重复键以及顺序等；JSONB解析输入后保存的二进制，它在解析时会删除语义无关的细节和重复的键，对键值也会进行排序，使用时不用再次解析。

二者接受输入相同的字符串。但差别在于处理效率：JSON数据类型存储输入文本的精确拷贝，处理函数必须在每个执行上重新解析；而JSONB数据类型以分解的二进制格式存储，这使得由于转换机制而在输入过程略慢些，但是在处理过程明显更快，因为不需要重新解析。同时，由于JSONB类型存在解析后的格式归一化等操作，同等语义下只会有一种格式。因此，JSONB能够更好地支持一些额外操作，如按照特定规则进行大小比较等。此外，JSONB还支持索引。

输入格式

输入必须是一个符合JSON数据格式的字符串，此字符串用单引号''声明。

null (null-json)：仅null，全小写。

gbase=# select 'null'::json;

json

------

 null

(1 row)

gbase=# select 'NULL'::jsonb;

ERROR:  invalid input syntax for type json

LINE 1: select 'NULL'::jsonb;

               ^

DETAIL:  Token "NULL" is invalid.

CONTEXT:  JSON data, line 1: NULL

referenced column: jsonb

数字 (num-json)：正负整数、小数、0，支持科学计数法。

gbase=# select '1'::json;

json

------

 1

(1 row)

gbase=# select '-1.5'::json;

json

------

 -1.5

(1 row)

gbase=# select '-1.5e-5'::jsonb, '-1.5e+2'::jsonb;

  jsonb   | jsonb

----------+-------

 -.000015 | -150

(1 row)

gbase=# select '001'::json, '+15'::json, 'NaN'::json;

ERROR:  invalid input syntax for type json

LINE 1: select '001'::json, '+15'::json, 'NaN'::json;

               ^

DETAIL:  Token "001" is invalid.

CONTEXT:  JSON data, line 1: 001

referenced column: json

-- 结果表明，JSON数据类型格式不支持多余的前导0，正数的+号，以及NaN和infinity。

布尔(bool-json)：仅true、false，全小写。

gbase=# select 'true'::json;

json

------

 true

(1 row)

gbase=# select 'false'::jsonb;

jsonb

-------

 false

(1 row)

字符串(str-json)：必须是加双引号的字符串。

gbase=# select '"a"'::json;

json

------

 "a"

(1 row)

gbase=# select '"abc"'::jsonb;

jsonb

-------

 "abc"

(1 row)

数组(array-json)：使用中括号[]包裹，满足数组书写条件。数组内元素类型可以是任意合法的JSON，且不要求类型一致。

gbase=# select '[1, 2, "foo", null]'::json;

        json

---------------------

 [1, 2, "foo", null]

(1 row)

gbase=# select '[]'::json;

json

------

 []

(1 row)

gbase=# select '[1, 2, "foo", null, [[]], {}]'::jsonb;

             jsonb

-------------------------------

 [1, 2, "foo", null, [[]], {}]

(1 row)

对象(object-json)：使用大括号{}包裹，键必须是满足JSON字符串规则的字符串，值可以是任意合法的JSON。

gbase=# select '{}'::json;

json

------

 {}

(1 row)

gbase=# select '{"a": 1, "b": {"a": 2, "b": null}}'::json;

                json

------------------------------------

 {"a": 1, "b": {"a": 2, "b": null}}

(1 row)

gbase=# select '{"foo": [true, "bar"], "tags": {"a": 1, "b": null}}'::jsonb;

                        jsonb

-----------------------------------------------------

 {"foo": [true, "bar"], "tags": {"a": 1, "b": null}}

(1 row)

l 'null'::json 和 null::json 是两个不同的概念，类似字符串 str="" 和str=null的区别。

l 对于数字，当使用科学计数法的时候，jsonb类型会将其展开，而json会精准拷贝输入。