Mysql中的JSON系列操作函數

一、方法羅列:

分類 函數 描述
創建json
json_array 創建json數組
json_object 創建json對象
json_quote 將json轉成json字符串類型
查詢json 
json_contains 判斷是否包含某個json值
json_contains_path 判斷某個路徑下是否包json值
json_extract 提取json值
column->path        json_extract的簡潔寫法,MySQL 5.7.9開始支持
column->>path      json_unquote(column -> path)的簡潔寫法
json_keys 提取json中的鍵值爲json數組
json_search 按給定字符串關鍵字搜索json,返回匹配的路徑
修改json 
json_append 廢棄,MySQL 5.7.9開始改名爲json_array_append
json_array_append 末尾添加數組元素,如果原有值是數值或json對 象,則轉成數組後,再添加元素
json_array_insert 插入數組元素
json_insert 插入值(插入新值,但不替換已經存在的舊值)
json_merge 合併json數組或對象
json_remove 刪除json數據
json_replace 替換值(只替換已經存在的舊值)
json_set 設置值(替換舊值,並插入不存在的新值)
json_unquote 去除json字符串的引號,將值轉成string類型
返回json屬性 
json_depth 返回json文檔的最大深度
json_length 返回json文檔的長度
json_type 返回json值得類型
json_valid 判斷是否爲合法json文檔

二、使用例子:

MySQL 5.7.8開始支持 json類型.

 

create table t(id int,js json,PRIMARY KEY (`id`))

插入數據
insert into t values(1,'{"a":1,"s":"abc"}')
insert into t values(2,'[1,2,{"a":123}]')
insert into t values(3,'"str"')
insert into t values(4,'123')

直接提供字符串即可。還可以用JSON_Array和JSON_Object函數來構造
insert into t values(5,JSON_Object('key1',v1,'key2',v2))
insert into t values(4,JSON_Array(v1,v2,v3))

JSON_OBJECT([key, val[, key, val] ...])
JSON_ARRAY([val[, val] ...])

 


JSON_SET(json_doc, path, val[, path, val] ...)
修改數據

update t set js=json_set('{"a":1,"s":"abc"}','$.a',456,'$.b','bbb') where id=1

結果js={"a":456,"s":"abc","b":"bbb"}

path中$就代表整個doc,然後可以用JavaScript的方式指定對象屬性或者數組下標等.
執行效果,類似json的語法
$.a=456
$.b="bbb"

存在就修改,不存在就設置.

$.c.c=123
這個在javascript中會出錯,因爲.c爲null。
但是在json_set('{}','$.c.c',123)中,不存在的路徑將直接被忽略。

特殊的對於數組,如果目標doc不是數組則會被轉換成[doc],然後再執行set,
如果set的下標超過數組長度,只會添加到數組結尾。

select json_set('{"a":456}','$[1]',123)
結果[{"a":456},123]。目標現被轉換成[{"a":456}],然後應用$[1]=123。

select json_set('"abc"','$[999]',123)
結果["abc",123]。

 

再舉幾個例子
select json_set('[1,2,3]','$[0]',456,'$[3]','bbb')
結果[456,2,3,'bbb']

注意:
對於javascript中
var a=[1,2,3]
a.a='abc'
是合法的,但是一旦a轉成json字符串,a.a就丟失了。

而在mysql中,這種算作路徑不存在,因此
select json_set('[1,2,3]','$.a',456)
結果還是[1,2,3]

 

然後還有另外兩個版本
JSON_INSERT(json_doc, path, val[, path, val] ...)
如果不存在對應屬性則插入,否則不做任何變動

JSON_REPLACE(json_doc, path, val[, path, val] ...)
如果存在則替換,否則不做任何變動

這兩個操作倒是沒有javascript直接對應的操作
select json_insert('{"a":1,"s":"abc"}','$.a',456,'$.b','bbb')
結果{"a":1,"s":"abc","b":"bbb"}

select json_replace('{"a":1,"s":"abc"}','$.a',456,'$.b','bbb')
結果{"a":456,"s":"abc"}

加上刪除節點
JSON_REMOVE(json_doc, path[, path] ...)
如果存在則刪除對應屬性,否則不做任何變動
select json_replace('{"a":1,"s":"abc"}','$.a','$.b')
結果{"s":"abc"}

涉及數組時,三個函數與json_set基本一樣
select json_insert('{"a":1}','$[0]',456)
結果不變,認爲0元素已經存在了,注意這裏結果不是[{"a":1}]

select json_insert('{"a":1}','$[999]',456)
結果追加到數組結尾[{"a":1},456]


select json_replace('{"a":1}','$[0]',456)
結果456!而非[456]

select json_replace('{"a":1}','$[1]',456)
結果不變。

其實對於json_insert和json_replace來說一般情況沒必要針對數組使用。

 


select json_remove('{"a":1}','$[0]')
結果不變!

select json_remove('[{"a":1}]','$[0]')
結果[]

總之涉及數組的時候要小心。


JSON_MERGE(json_doc, json_doc[, json_doc] ...)
將多個doc合併

select json_merge('[1,2,3]','[4,5]')
結果[1,2,3,4,5]。數組簡單擴展

select json_merge('{"a":1}','{"b":2}')
結果{"a":1,"b":2}。兩個對象直接融合。

特殊的還是在數組
select json_merge('123','45')
結果[123,45]。兩個常量變成數組

select json_merge('{"a":1}','[1,2]')
結果[{"a":1},1,2]。目標碰到數組,先轉換成[doc]

select json_merge('[1,2]','{"a":1}')
結果[1,2,{"a":1}]。非數組都追加到數組後面。

 

JSON_ARRAY_APPEND(json_doc, path, val[, path, val] ...)
給指定的節點,添加元素,如果節點不是數組,則先轉換成[doc]

select json_Array_append('[1,2]','$','456')
結果[1,2,456]

select json_Array_append('[1,2]','$[0]','456')
結果[[1,456],2]。指定插在$[0]這個節點,這個節點非數組,所以等效爲
select json_Array_append('[[1],2]','$[0]','456')


JSON_ARRAY_INSERT(json_doc, path, val[, path, val] ...)
在數組的指定下標處插入元素

SELECT JSON_ARRAY_INSERT('[1,2,3]','$[1]',4)
結果[1,4,2,3]。在$數組的下標1處插入

SELECT JSON_ARRAY_INSERT('[1,[1,2,3],3]','$[1][1]',4)
結果[1,[1,4,2,3],3]。在$[1]數組的下標1處插入

SELECT JSON_ARRAY_INSERT('[1,2,3]','$[0]',4,'$[1]',5)
結果[4,5,1,2,3]。注意後續插入是在前面插入基礎上的,而非[4,1,5,2,3]

 

提取json信息的函數
JSON_KEYS(json_doc[, path])
返回指定path的key

select json_keys('{"a":1,"b":2}')
結果["a","b"]

select json_keys('{"a":1,"b":[1,2,3]}','$.b')
結果null。數組沒有key

 

JSON_CONTAINS(json_doc, val[, path])
是否包含子文檔

select json_contains('{"a":1,"b":4}','{"a":1}')
結果1

select json_contains('{"a":2,"b":1}','{"a":1}')
結果0

select json_contains('{"a":[1,2,3],"b":1}','[1,2]','$.a')
結果1。數組包含則需要所有元素都存在。

select json_contains('{"a":[1,2,3],"b":1}','1','$.a')
結果1。元素存在數組元素中。


JSON_CONTAINS_PATH(json_doc, one_or_all, path[, path] ...)
檢查路徑是否存在

select JSON_CONTAINS_PATH('{"a":1,"b":1}', 'one','$.a','$.c')
結果1。只要存在一個

select JSON_CONTAINS_PATH('{"a":1,"b":1}', 'all','$.a','$.c')
結果0。必須全部存在。


select JSON_CONTAINS_PATH('{"a":1,"b":{"c":{"d":1}}}', 'one','$.b.c.d')
結果1。

select JSON_CONTAINS_PATH('{"a":1,"b":{"c":{"d":1}}}', 'one','$.a.c.d')
結果0。


JSON_EXTRACT(json_doc, path[, path] ...)
獲得doc中某個或多個節點的值。

select json_extract('{"a":1,"b":2}','$.a')
結果1

select json_extract('{"a":[1,2,3],"b":2}','$.a[1]')
結果2


select json_extract('{"a":{"a":1,"b":2,"c":3},"b":2}','$.a.*')
結果[1,2,3]。a.*通配a所有屬性的值返回成數組。


select json_extract('{"a":{"a":1,"b":2,"c":3},"b":4}','$**.b')
結果[2,4]。通配$中所有層次下的屬性b的值返回成數組。

mysql5.7.9開始增加了一種簡寫方式:column->path

select id,js->'$.id' from t where js->'$.a'=1 order by js->'$.b'
等價於
select id,json_extract(js,'$.id') 
from t where json_extract(js,'$.a')=1
order by json_extract(js,'$.b')

 

 

JSON_SEARCH(json_doc, one_or_all, search_str[, escape_char[, path] ...])
強大的查詢函數,用於在doc中返回符合條件的節點,select則是在表中返回符合要求的紀錄。

select json_search('{"a":"abc","b":{"c":"dad"}}','one','%a%')

結果$.a。和like一樣可以用%和_匹配,在所有節點的值中匹配,one只返回一個。

select json_search('{"a":"abc","b":{"c":"dad"}}','all','%a%')
結果["$.a","$.b.c"]


select json_search('{"a":"abc","b":{"c":"dad"}}','all','%a%',null,'$.b')
結果["$.b.c"]。限制查找範圍。

select json_search('{"a":"abc","b":{"c":"dad"},"c":{"b":"aaa"}}','all','%a%',null,'$**.b')
結果["$.b.c","$.c.b"]。查找範圍還可使用通配符!在每個匹配節點和其下查找。


注意,只有json_extract和json_search中的path才支持通配,其他json_set,json_insert等都不支持。


JSON_LENGTH(json_doc[, path])
返回數組的長度,如果是object則是屬性個數,常量則爲1

select json_length('[1,2,3]')
結果3

select json_length('123')
結果1

select json_length('{"a":1,"b":2}')
結果2

可再跟path參數
select json_length('{"a":1,"b":[1,2,3]}','$.b')
結果3


JSON_DEPTH(json_doc)
返回doc深度


select json_depth('{}'),json_depth('[]'),json_depth('123')
結果1,1,1

select json_depth('[1,2,3,4,5,6]')
結果2

select json_depth('{"a":{"b":{"c":1}}}')
結果4

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章