GaussDB数据库JSON(JavaScript Object Notation)数据类型介绍

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

• 标量(scalar)：单一的数字、bool、string和null都可以称作标量。
• 数组(array)：[]结构，里面存放的元素可以是任意类型的JSON，并且不要求数组内所有元素都是同一类型。
• 对象(object)：{}结构，存储key:value的键值对，其键只能是用""包裹起来的字符串，值可以是任意类型的JSON，对于重复的键，按最后一个键值为准。

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

因此可以发现，两者其实都是JSON，它们接受相同的字符串作为输入。它们实际的主要差别是效率。JSON数据类型存储输入文本的精确复制，处理函数必须在每个执行上重新解析；而JSONB数据以解析的二进制格式存储，由于添加了解析机制，因此在输入上稍微慢些，但是在处理上明显更快， 因为不需要重新解析。同时由于JSONB类型存在解析后的格式归一化等操作，同等的语义下只会有一种格式，因此可以更好更强大的支持很多其他额外的操作，比如按照一定的规则进行大小比较等。JSONB也支持索引，这也是一个明显的优势。

输入格式

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

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

gaussdb=# SELECT 'null'::json;   -- suc
 json 
------
 null
(1 row)

gaussdb=# SELECT 'NULL'::jsonb;  -- err
ERROR:  invalid input syntax for type json

 

 

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

gaussdb=# SELECT '1'::json;
 json 
------
 1
(1 row)

gaussdb=# SELECT '-1.5'::json;
 json 
------
 -1.5
(1 row)

gaussdb=# SELECT '-1.5e-5'::jsonb, '-1.5e+2'::jsonb;
   jsonb   | jsonb 
-----------+-------
 -0.000015 | -150
(1 row)

gaussdb=# SELECT '001'::json, '+15'::json, 'NaN'::json;  -- 不支持多余的前导0，正数的+号，以及NaN和infinity。
ERROR:  invalid input syntax for type json

 

 

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

gaussdb=# SELECT 'true'::json;
 json 
------
 true
(1 row)

gaussdb=# select 'false'::jsonb;  
 jsonb 
-------
 false
(1 row)

 

 

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

gaussdb=# SELECT '"a"'::json;
 json 
------
 "a"
(1 row)

gaussdb=# select '"abc"'::jsonb;  
 jsonb 
-------
 "abc"
(1 row)

 

 

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

gaussdb=# SELECT '[1, 2, "foo", null]'::json;
        json         
---------------------
 [1, 2, "foo", null]
(1 row)

gaussdb=# SELECT '[]'::json;
 json 
------
 []
(1 row)

gaussdb=# SELECT '[1, 2, "foo", null, [[]], {}]'::jsonb; 
             jsonb             
-------------------------------
 [1, 2, "foo", null, [[]], {}]
(1 row)

 

 

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

gaussdb=# SELECT '{}'::json; json 
------
 {}
(1 row)

gaussdb=# SELECT '{"a": 1, "b": {"a": 2,  "b": null}}'::json;
                json                 
-------------------------------------
 {"a": 1, "b": {"a": 2,  "b": null}}
(1 row)

gaussdb=# SELECT '{"foo": [true, "bar"], "tags": {"a": 1, "b": null}}'::jsonb;  
                        jsonb                        
-----------------------------------------------------
 {"foo": [true, "bar"], "tags": {"a": 1, "b": null}}
(1 row)

 

 

须知：

• 区分 'null'::json 和 null::json 是两个不同的概念，类似于字符串 str="null" 和 str=null。
• 对于数字，当使用科学计数法的时候，jsonb类型会将其展开，而json会精确复制输入。

更多详情请参考GaussDB 文档中心：https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/productdesc/qlh_03_0001.html