MySql json類型字段的使用

一,對記錄的操作

1.創建有json字段的表

-- 創建表
CREATE TABLE t_json(id INT PRIMARY KEY, sname VARCHAR(20) , info JSON);

2.插入記錄

-- 插入含有json數組的記錄
INSERT INTO t_json(id,sname,info) VALUES( 1, 'name1', JSON_ARRAY(1, "abc", NULL, TRUE, CURTIME()));
-- 插入含有json對象的記錄
INSERT INTO t_json(id,sname,info) VALUES( 2, 'name2', JSON_OBJECT("age", 20, "time", now()));
INSERT INTO t_json(id,sname,info) VALUES( 3, 'name3', '{"age":20, "time":"2018-07-14 10:52:00"}');

3.查詢記錄

-- 查詢記錄
SELECT sname,JSON_EXTRACT(info,'$.age') FROM t_json;
SELECT sname,info->'$.age' FROM t_json;
-- 查詢key
SELECT id,json_keys(info) FROM t_json;

4.修改記錄

-- 增加鍵
UPDATE t_json SET info = json_set(info,'$.ip','192.168.1.1') WHERE id = 2;
-- 變更值
UPDATE t_json SET info = json_set(info,'$.ip','192.168.1.2') WHERE id = 2;
-- 刪除鍵
UPDATE t_json SET info = json_remove(info,'$.ip') WHERE id = 2;

二,創建json值函數

1.JSON_ARRAY 生成json數組

-- JSON_ARRAY(val1,val2,val3...)
-- 生成一個包含指定元素的json數組。
SELECT JSON_ARRAY(1, "abc", NULL, TRUE, CURTIME()); -- [1, "abc", null, true, "10:37:08.000000"]

2.JSON_OBJECT 生成json對象

-- JSON_OBJECT(key1,val1,key2,val2...)
-- 生成一個包含指定K-V對的json object。如果有key為NULL或參數個數為奇數，則拋錯。
SELECT JSON_OBJECT('age', 20, 'time', now()); -- {"id": 87, "name": "carrot"}

3.JSON_QUOTE 加"號

-- JSON_QUOTE(json_val)
-- 將json_val用"號括起來。
SELECT JSON_QUOTE('[1,2,3]'); -- "[1,2,3]"

三,搜索json值函數

1.JSON_CONTAINS 指定數據是否存在

set @j = '{"a": 1, "b": 2, "c": {"d": 4}}';
-- JSON_CONTAINS(json_doc, val[, path])
-- 查詢json文檔是否在指定path包含指定的數據，包含則返回1，否則返回0。如果有參數為NULL或path不存在，則返回NULL。
SELECT JSON_CONTAINS(@j, '4', '$.c.d'); -- 1

2.JSON_CONTAINS_PATH 指定路徑是否存在

-- JSON_CONTAINS_PATH(json_doc, one_or_all, path[, path] ...)
-- 查詢是否存在指定路徑，存在則返回1，否則返回0。如果有參數為NULL，則返回NULL。
-- one_or_all只能取值"one"或"all"，one表示只要有一個存在即可；all表示所有的都存在才行。
SELECT JSON_CONTAINS_PATH(@j, 'one', '$.a', '$.e'); -- 1
SELECT JSON_CONTAINS_PATH(@j, 'all', '$.a', '$.c.d'); -- 1

3.JSON_EXTRACT 查找所有指定數據

-- JSON_EXTRACT(json_doc, path[, path] ...)
-- 從json文檔里抽取數據。如果有參數有NULL或path不存在，則返回NULL。如果抽取出多個path，則返回的數據封閉在一個json array里。
set @j2 = '[10, 20, [30, 40]]';
SELECT JSON_EXTRACT('[10, 20, [30, 40]]', '$[1]'); -- 20
SELECT JSON_EXTRACT('[10, 20, [30, 40]]', '$[1]', '$[0]'); -- [20, 10]
SELECT JSON_EXTRACT('[10, 20, [30, 40]]', '$[2][*]'); -- [30, 40]

4.JSON_KEYS 查找所有指定鍵值

-- JSON_KEYS(json_doc[, path])
-- 獲取json文檔在指定路徑下的所有鍵值，返回一個json array。如果有參數為NULL或path不存在，則返回NULL。
SELECT JSON_KEYS('{"a": 1, "b": {"c": 30}}'); -- ["a", "b"]
SELECT JSON_KEYS('{"a": 1, "b": {"c": 30}}', '$.b'); -- ["c"]
SELECT id,json_keys(info) FROM t_json;

5.JSON_SEARCH 查找所有指定值的位置

-- JSON_SEARCH(json_doc, one_or_all, search_str[, escape_char[, path] ...])
-- 查詢包含指定字符串的paths，并作為一個json array返回。如果有參數為NUL或path不存在，則返回NULL。
-- one_or_all："one"表示查詢到一個即返回；"all"表示查詢所有。
-- search_str：要查詢的字符串。 可以用LIKE里的'%'或‘_’匹配。
-- path：在指定path下查。
SET @j3 = '["abc", [{"k": "10"}, "def"], {"x":"abc"}, {"y":"bcd"}]';
SELECT JSON_SEARCH(@j3, 'one', 'abc'); -- "$[0]"
SELECT JSON_SEARCH(@j3, 'all', 'abc'); -- ["$[0]", "$[2].x"]
SELECT JSON_SEARCH(@j3, 'all', 'abc', NULL, '$[2]'); -- "$[2].x"
SELECT JSON_SEARCH(@j3, 'all', '10'); -- "$[1][0].k"
SELECT JSON_SEARCH(@j3, 'all', '%b%'); -- ["$[0]", "$[2].x", "$[3].y"]
SELECT JSON_SEARCH(@j3, 'all', '%b%', NULL, '$[2]'); -- "$[2].x"

四,修改json值函數

1.JSON_ARRAY_AppEND 指定位置追加數組元素

-- JSON_ARRAY_APPEND(json_doc, path, val[, path, val] ...)
-- 在指定path的json array尾部追加val。如果指定path是一個json object，則將其封裝成一個json array再追加。如果有參數為NULL，則返回NULL。
SET @j4 = '["a", ["b", "c"], "d"]';
-- SELECT JSON_ARRAY_APPEND(@j4, '$[1][0]', 3); -- ["a", [["b", 3], "c"], "d"]
SET @j5 = '{"a": 1, "b": [2, 3], "c": 4}';
SELECT JSON_ARRAY_APPEND(@j5, '$.b', 'x'); -- {"a": 1, "b": [2, 3, "x"], "c": 4} 
SELECT JSON_ARRAY_APPEND(@j5, '$.c', 'y'); -- {"a": 1, "b": [2, 3], "c": [4, "y"]}
SELECT JSON_ARRAY_APPEND(@j5, '$', 'z'); -- [{"a": 1, "b": [2, 3], "c": 4}, "z"]

2.JSON_ARRAY_INSERT 指定位置插入數組元素

-- JSON_ARRAY_INSERT(json_doc, path, val[, path, val] ...)
-- 在path指定的json array元素插入val，原位置及以右的元素順次右移。如果path指定的數據非json array元素，則略過此val；如果指定的元素下標超過json array的長度，則插入尾部。
SET @j6 = '["a", {"b": [1, 2]}, [3, 4]]';
SELECT JSON_ARRAY_INSERT(@j6, '$[1]', 'x'); -- ["a", "x", {"b": [1, 2]}, [3, 4]]
SELECT JSON_ARRAY_INSERT(@j6, '$[100]', 'x'); -- ["a", {"b": [1, 2]}, [3, 4], "x"]
SELECT JSON_ARRAY_INSERT(@j6, '$[1].b[0]', 'x'); -- ["a", {"b": ["x", 1, 2]}, [3, 4]]
SELECT JSON_ARRAY_INSERT(@j6, '$[0]', 'x', '$[3][1]', 'y'); -- ["x", "a", {"b": [1, 2]}, [3, "y", 4]]

3.JSON_INSERT 指定位置插入

-- JSON_INSERT(json_doc, path, val[, path, val] ...)
-- 在指定path下插入數據，如果path已存在，則忽略此val（不存在才插入）。
SET @j7 = '{ "a": 1, "b": [2, 3]}';
SELECT JSON_INSERT(@j7, '$.a', 10, '$.c', '[true, false]'); -- {"a": 1, "b": [2, 3], "c": "[true, false]"}

4.JSON_REPLACE 指定位置替換

-- JSON_REPLACE(json_doc, path, val[, path, val] ...)
-- 替換指定路徑的數據，如果某個路徑不存在則略過（存在才替換）。如果有參數為NULL，則返回NULL。
SELECT JSON_REPLACE(@j7, '$.a', 10, '$.c', '[true, false]'); -- {"a": 10, "b": [2, 3]}

5.JSON_SET 指定位置設置

-- JSON_SET(json_doc, path, val[, path, val] ...)
-- 設置指定路徑的數據（不管是否存在）。如果有參數為NULL，則返回NULL。
SELECT JSON_SET(@j7, '$.a', 10, '$.c', '[true, false]'); -- {"a": 10, "b": [2, 3], "c": "[true, false]"}

6.JSON_MERGE 合并

-- JSON_MERGE(json_doc, json_doc[, json_doc] ...)
-- merge多個json文檔。規則如下：
-- 如果都是json array，則結果自動merge為一個json array；
-- 如果都是json object，則結果自動merge為一個json object；
-- 如果有多種類型，則將非json array的元素封裝成json array再按照規則一進行mege。
SELECT JSON_MERGE('[1, 2]', '[true, false]'); -- [1, 2, true, false]
SELECT JSON_MERGE('{"name": "x"}', '{"id": 47}'); -- {"id": 47, "name": "x"}
SELECT JSON_MERGE('1', 'true'); -- [1, true]
SELECT JSON_MERGE('[1, 2]', '{"id": 47}'); -- [1, 2, {"id": 47}]

7.JSON_REMOVE 指定位置移除

-- JSON_REMOVE(json_doc, path[, path] ...)
-- 移除指定路徑的數據，如果某個路徑不存在則略過此路徑。如果有參數為NULL，則返回NULL。
SET @j8 = '["a", ["b", "c"], "d"]';
SELECT JSON_REMOVE(@j8, '$[1]'); -- ["a", "d"]

8.JSON_UNQUOTE 去"號

-- JSON_UNQUOTE(val)
-- 去掉val的引號。如果val為NULL，則返回NULL。
SELECT JSON_UNQUOTE(""123""); -- 123

五,返回json值屬性的函數

1.JSON_DEPTH 深度

-- JSON_DEPTH(json_doc)
-- 獲取json文檔的深度。如果參數為NULL，則返回NULL。
-- 空的json array、json object或標量的深度為1。
SELECT JSON_DEPTH('{}'), JSON_DEPTH('[]'), JSON_DEPTH('true'); -- 1 1 1
SELECT JSON_DEPTH('[10, 20]'), JSON_DEPTH('[[], {}]'); -- 2 2
SELECT JSON_DEPTH('[10, {"a": 20}]'); -- 3

2.JSON_LENGTH 長度

-- JSON_LENGTH(json_doc[, path])
-- 獲取指定路徑下的長度。如果參數為NULL，則返回NULL。　
-- 長度的計算規則：
-- 標量的長度為1；
-- json array的長度為元素的個數；
-- json object的長度為key的個數。
SELECT JSON_LENGTH('[1, 2, {"a": 3}]'); -- 3
SELECT JSON_LENGTH('{"a": 1, "b": {"c": 30}}'); -- 2
SELECT JSON_LENGTH('{"a": 1, "b": {"c": 30}}', '$.b'); -- 1

3.JSON_TYPE 類型

-- JSON_TYPE(json_val)
-- 獲取json文檔的具體類型。如果參數為NULL，則返回NULL。
select JSON_TYPE('[1,2]'); -- ARRAY

4.JSON_VALID 是否有效json格式

-- JSON_VALID(val)
-- 判斷val是否為有效的json格式，是為1，不是為0。如果參數為NUL，則返回NULL。
SELECT JSON_VALID('{"a": 1}'); -- 1
SELECT JSON_VALID('hello'), JSON_VALID('"hello"'); -- 1

附錄:

JSON_ARRAY 生成json數組
JSON_OBJECT 生成json對象
JSON_QUOTE 加"號
JSON_CONTAINS 指定數據是否存在
JSON_CONTAINS_PATH 指定路徑是否存在
JSON_EXTRACT 查找所有指定數據
JSON_KEYS 查找所有指定鍵值
JSON_SEARCH 查找所有指定值的位置
JSON_ARRAY_APPEND 指定位置追加數組元素
JSON_ARRAY_INSERT 指定位置插入數組元素
JSON_INSERT 指定位置插入
JSON_REPLACE 指定位置替換
JSON_SET 指定位置設置
JSON_MERGE 合并
JSON_REMOVE 指定位置移除
JSON_UNQUOTE 去"號
JSON_DEPTH 深度
JSON_LENGTH 長度
JSON_TYPE 類型
JSON_VALID 是否有效json格式