https://www.cnblogs.com/alianbog/p/5658156.html
postgresql支持兩種json數據類型：json和jsonb，而兩者唯一的區別在於效率,json是對輸入的完整拷貝，使用時再去解析，所以它會保留輸入的空格，重複鍵以及順序等。而jsonb是解析輸入後保存的二進制，它在解析時會刪除不必要的空格和重複的鍵，順序和輸入可能也不相同。使用時不用再次解析。兩者對重複鍵的處理都是保留最後一個鍵值對。效率的差別：json類型存儲快，使用慢，jsonb類型存儲稍慢，使用較快。
注意：鍵值對的鍵必須使用雙引號
示例：
test=# SELECT '{"bar": "baz", "balance": 7.77, "active":false}'::json;
json
------------------------------------------------------
{"bar": "baz", "balance": 7.77, "active":false}
(1 row)
test=# SELECT '{"bar": "baz", "balance": 7.77, "active":false}'::jsonb;
jsonb
--------------------------------------------------
{"bar": "baz", "active": false, "balance": 7.77}
(1 row)
測試表：
create table api(jdoc jsonb);
insert into api values('{
"guid": "9c36adc1-7fb5-4d5b-83b4-90356a46061a",
"name": "Angela Barton",
"is_active": true,
"company": "Magnafone",
"address": "178 Howard Place, Gulf, Washington, 702",
"registered": "2009-11-07T08:53:22 +08:00",
"latitude": 19.793713,
"longitude": 86.513373,
"tags": [
"enim",
"aliquip",
"qui"
]}');
test=# SELECT jdoc->'guid', jdoc->'name' FROM api WHERE jdoc @> '{"company": "Magnafone"}';
?column? | ?column?
----------------------------------------+-----------------
"9c36adc1-7fb5-4d5b-83b4-90356a46061a" | "Angela Barton"
(1 row)
jsonb缺省的GIN操作符類支持使用@>、?、?&和?|操作符查詢，在api的jdoc上創建一個gin索引。
test=# CREATE INDEX idxgin ON api USING gin (jdoc); CREATE INDEX
json和jsonb的操作符
| 操作符 | 右操作數類型 | 描述 | 示例 | 結果 |
| -> | int | 獲取JSON數組元素（索引從0開始） | select '[{"a":"foo"},{"b":"bar"},{"c":"baz"}]'::json->2; | {"c":"baz"} |
| -> | text | 通過鍵獲取值 | select '{"a": {"b":"foo"}}'::json->'a'; | {"b":"foo"} |
| ->> | int |
獲取JSON數組元素爲 text |
select '[1,2,3]'::json->>2; | 3 |
| ->> | text | 通過鍵獲取值爲text | select '{"a":1,"b":2}'::json->>'b'; | 2 |
| #> | text[] |
在指定的路徑獲取JSON對象 |
select '{"a": {"b":{"c": "foo"}}}'::json#>'{a,b}'; | {"c": "foo"} |
| #>> | text[] |
在指定的路徑獲取JSON對象爲 text |
select '{"a":[1,2,3],"b":[4,5,6]}'::json#>>'{a,2}'; | 3 |
jsonb額外操作符
| 操作符 | 右操作數類型 | 描述 | 示例 | 結果 |
| @> | jsonb | 左側json最上層的值是否包含右邊json對象 |
select '{"a":{"b":2}}'::jsonb @> '{"b":2}'::jsonb; select '{"a":1, "b":2}'::jsonb @> '{"b":2}'::jsonb; |
f t |
| <@ | jsonb | 左側json對象是否包含於右側json最上層的值內 | select '{"b":2}'::jsonb <@ '{"a":1, "b":2}'::jsonb; | t |
| ? | text | text是否作爲左側Json對象最上層的鍵 | select '{"a":1, "b":2}'::jsonb ? 'b'; | t |
| ?| | text[] | text[]中的任一元素是否作爲左側Json對象最上層的鍵 | select '{"a":1, "b":2, "c":3}'::jsonb ?| array['b', 'c']; | t |
| ?& | text[] | text[]中的所有元素是否作爲左側Json對象最上層的鍵 | select '["a", "b"]'::jsonb ?& array['a', 'b']; | t |
| || | jsonb | 連接兩個json對象，組成一個新的json對象 | select '["a", "b"]'::jsonb || '["c", "d"]'::jsonb; | ["a", "b", "c", "d"] |
| - | text | 刪除左側json對象中鍵爲text的鍵值對 | select '{"a": "b"}'::jsonb - 'a'; | {} |
| - | integer |
刪除數組指定索引處的元素，如果索引值爲負數，則從右邊計算索引值。 如果最上層容器內不是數組，則拋出錯誤。 |
select '["a", "b"]'::jsonb - 1; | ["a"] |
| #- | text[] |
刪除指定路徑下的域或元素（如果是json數組，且整數值是負的， 則索引值從右邊算起） |
select '["a", {"b":1}]'::jsonb #- '{1,b}'; | ["a", {}] |
json創建函數
| 函數 | 描述 | 示例 | 結果 |
|
to_json(anyelement) to_jsonb(anyelement) |
返回json或jsonb類型的值。數組和複合被轉換（遞歸）成數組和對象。另外除數字、 布爾、NULL值（直接使用NULL拋出錯誤）外，其他標量必須有類型轉換。（此處請參考原文） |
select to_json('3'::int); | 3 |
|
array_to_json(anyarray [, pretty_bool]) |
以JSON數組返回該數組。PostgreSQL多維數組變成JSON數組中的數組。 |
select array_to_json('{{1,5},{99,100}}'::int[],true); |
[[1,5], + |
| row_to_json(record [, pretty_bool]) | 以JSON對象返回行。如果pretty_bool 爲真，則在級別1元素之間添加換行。 | select row_to_json(row(1,'foo'),true); |
{"f1":1, + |
|
json_build_array(VARIADIC "any") jsonb_build_array(VARIADIC "any") |
建立一個由可變參數列表組成的不同類型的JSON數組 | select json_build_array(1,2,'3',4,5); | [1, 2, "3", 4, 5] |
|
json_build_object(VARIADIC "any") jsonb_build_object(VARIADIC "any") |
建立一個由可變參數列表組成的JSON對象。參數列表參數交替轉換爲鍵和值。 | select json_build_object('foo',1,'bar',2); | {"foo" : 1, "bar" : 2} |
|
json_object(text[]) jsonb_object(text[]) |
根據text[]數組建立一個json對象，如果是一維數組，則必須有偶數個 元素，元素交替組成鍵和值。如果是二維數組，則每個元素必須有2個元素，可以組成鍵值對。 |
select json_object('{a, 1, b, "def", c, 3.5}'); select json_object('{{a, 1},{b, "def"},{c, 3.5}}'); |
{"a" : "1", "b" : "def", "c" : "3.5"} |
|
json_object(keys text[], values text[]) jsonb_object(keys text[], values text[]) |
分別從兩組text[]中獲取鍵和值，與一維數組類似。 | select json_object('{a, b}', '{1,2}'); | {"a" : "1", "b" : "2"} |
json處理函數
| 函數 | 返回類型 | 描述 | 示例 | 結果 |
|
json_array_length(json) jsonb_array_length(jsonb) |
int | 返回Json數組最外層元素個數 | select json_array_length('[1,2,3,{"f1":1,"f2":[5,6]},4]'); | 5 |
|
json_each(json) jsonb_each(jsonb) |
setof key text, value json setof key text, value jsonb |
將最外層Json對象轉換爲鍵值對集合 | select json_each('{"a":"foo", "b":"bar"}'); |
(a,"""foo""") |
|
json_each_text(json) jsonb_each_text(jsonb) |
setof key text, value text | 將最外層Json對象轉換爲鍵值對集合，且value爲text類型 | select json_each_text('{"a":"foo", "b":"bar"}'); |
(a,foo) |
|
json_extract_path(from_json json, VARIADIC path_elems text[])
jsonb_extract_path(from_json jsonb, VARIADIC path_elems text[]) |
json jsonb |
返回path_elems指向的value，同操作符#> | select json_extract_path('{"f2":{"f3":1},"f4":{"f5":99,"f6":"foo"}}','f4'); | {"f5":99,"f6":"foo"} |
|
json_extract_path_text(from_json json, VARIADIC path_elems text[])
jsonb_extract_path_text(from_json jsonb, VARIADIC path_elems text[]) |
text | 返回path_elems指向的value，並轉爲text類型，同操作符#>> | select json_extract_path_text('{"f2":{"f3":1},"f4":{"f5":99,"f6":"foo"}}','f4', 'f6'); | foo |
|
json_object_keys(json) jsonb_object_keys(jsonb) |
setof text | 返回json對象最外層的key | select json_object_keys('{"f1":"abc","f2":{"f3":"a", "f4":"b"}}'); |
f1 |
|
json_populate_record(base anyelement, from_json json)
jsonb_populate_record(base anyelement, from_json jsonb) |
anyelement | 將json對象的value以base定義的行類型返回，如果行類型字段比json對象鍵值少，則多出的鍵值將被拋棄；如果行類型字段多，則多出的字段自動填充NULL。 |
表tbl_test定義：
Table "public.tbl_test" c | character varying(32) |
select * from json_populate_record(null::tbl_test, '{"a":1,"b":2}');
|
a | b | c |
|
json_populate_recordset(base anyelement, from_json json)
jsonb_populate_recordset(base anyelement, from_json jsonb) |
setof anyelement | 將json對象最外層數組以base定義的行類型返回 |
表定義同上 select * from json_populate_recordset(null::tbl_test, '[{"a":1,"b":2},{"a":3,"b":4}]'); |
a | b | c |
|
json_array_elements(json) jsonb_array_elements(jsonb) |
setof json setof jsonb |
將json數組轉換成json對象value的集合 | select json_array_elements('[1,true, [2,false]]'); |
1 |
|
json_array_elements_text(json) jsonb_array_elements_text(jsonb) |
setof text | 將json數組轉換成text的value集合 | select json_array_elements_text('["foo", "bar"]'); |
foo |
|
json_typeof(json) jsonb_typeof(jsonb) |
text |
返回json最外層value的數據類型，可能的類型有 object, array, string, number, boolean, 和null. |
select json_typeof('-123.4') | number |
|
json_to_record(json) jsonb_to_record(jsonb) |
record | 根據json對象創建一個record類型記錄，所有的函數都返回record類型，所以必須使用as明確定義record的結構。 | select * from json_to_record('{"a":1,"b":[1,2,3],"c":"bar"}') as x(a int, b text, d text); |
a | b | d |
|
json_to_recordset(json) jsonb_to_recordset(jsonb) |
setof record | 根據json數組創建一個record類型記錄，所有的函數都返回record類型，所以必須使用as明確定義record的結構。 | select * from json_to_recordset('[{"a":1,"b":"foo"},{"a":"2","c":"bar"}]') as x(a int, b text); |
a | b |
|
json_strip_nulls(from_json json) jsonb_strip_nulls(from_json jsonb) |
json jsonb |
返回json對象中所有非null的數據，其他的null保留。 |
select json_strip_nulls('[{"f1":1,"f2":null},2,null,3]'); |
[{"f1":1},2,null,3] |
|
jsonb_set(target jsonb, path text[],new_value jsonb[,create_missing boolean]) |
jsonb | 如果create_missing爲true，則將在target的path處追加新的jsonb；如果爲false，則替換path處的value。 |
select jsonb_set('[{"f1":1,"f2":null},2,null,3]', '{0,f1}','[2,3,4]', false);
select jsonb_set('[{"f1":1,"f2":null},2]', '{0,f3}','[2,3,4]'); |
[{"f1": [2, 3, 4], "f2": null}, 2, null, 3]
[{"f1": 1, "f2": null, "f3": [2, 3, 4]}, 2] |
|
jsonb_insert(target jsonb, path text[], new_value jsonb, [insert_after boolean]) |
jsonb | 如果insert_after是true，則在target的path後面插入新的value，否則在path之前插入。 |
select jsonb_insert('{"a": [0,1,2]}', '{a, 1}', '"new_value"');
select jsonb_insert('{"a": [0,1,2]}', '{a, 1}', '"new_value"', true); |
{"a": [0, "new_value", 1, 2]}
{"a": [0, 1, "new_value", 2]} |
| jsonb_pretty(from_json jsonb) | text | 以縮進的格式更容易閱讀的方式返回json對象 | select jsonb_pretty('[{"f1":1,"f2":null},2,null,3]'); |
[ |
原文鏈接：https://www.postgresql.org/docs/9.6/static/functions-json.html