【MySQL】JSON相关
一些概念
MySQL里的json分为json array和json object。
$表示整个json对象,在索引数据时用下标(对于json array,从0开始)或键值(对于json object,含有特殊字符的key要用"括起来,比如$."my name")。
JSON_ARRAY函数 ,返回一个JSON数组,参数支持各种类型
mysql> SELECT JSON_ARRAY(1376, '字符', NULL, FALSE, NOW()); +-----------------------------------------------------------+ | JSON_ARRAY(1376, '字符', NULL, FALSE, NOW()) | +-----------------------------------------------------------+ | [1376, "字符", null, false, "2021-07-09 10:47:33.000000"] | +-----------------------------------------------------------+ 1 row in set (0.03 sec) mysql>
JSON_OBJECT函数,返回一个JSON对象,要求KV参数必须成双入参
mysql> SELECT JSON_OBJECT('name', '张三', 'gender', TRUE, 'age', 24); +--------------------------------------------------------+ | JSON_OBJECT('name', '张三', 'gender', TRUE, 'age', 24) | +--------------------------------------------------------+ | {"age": 24, "name": "张三", "gender": true} | +--------------------------------------------------------+ 1 row in set (0.03 sec) mysql>
JSON_QUOTE函数,追加双引号修饰
JSON_QUOTE(json_val)
案例
mysql> SELECT JSON_QUOTE('12321'), JSON_QUOTE('"12321"'), '12321',JSON_QUOTE('[1, 2, 3]'); +---------------------+-----------------------+-------+-------------------------+ | JSON_QUOTE('12321') | JSON_QUOTE('"12321"') | 12321 | JSON_QUOTE('[1, 2, 3]') | +---------------------+-----------------------+-------+-------------------------+ | "12321" | "\"12321\"" | 12321 | "[1, 2, 3]" | +---------------------+-----------------------+-------+-------------------------+ 1 row in set (0.02 sec) mysql>
JSON_UNQUOTE函数,移除双引号修饰
JSON_QUOTE(json_val)
去掉val的引号。如果val为NULL,则返回NULL。
mysql> SET @j = '"abc"'; Query OK, 0 rows affected (0.00 sec) mysql> SELECT @j, JSON_UNQUOTE(@j); +-------+------------------+ | @j | JSON_UNQUOTE(@j) | +-------+------------------+ | "abc" | abc | +-------+------------------+ 1 row in set (0.01 sec) mysql> SET @j = '[1, 2, 3]'; Query OK, 0 rows affected (0.00 sec) mysql> SELECT @j, JSON_UNQUOTE(@j); +-----------+------------------+ | @j | JSON_UNQUOTE(@j) | +-----------+------------------+ | [1, 2, 3] | [1, 2, 3] | +-----------+------------------+ 1 row in set (0.02 sec) mysql>
CONVERT函数,将JSON字符串转换为JSON
CONVERT(json_string,JSON)
案例
mysql> SELECT CONVERT('{"NAME": "MIKE", "AGE": 29, "GENDER": true}', JSON); +--------------------------------------------------------------+ | CONVERT('{"NAME": "MIKE", "AGE": 29, "GENDER": true}', JSON) | +--------------------------------------------------------------+ | {"AGE": 29, "NAME": "MIKE", "GENDER": true} | +--------------------------------------------------------------+ 1 row in set (0.02 sec) mysql>
JSON_CONTAINS函数
JSON_CONTAINS(json_doc, val[, path])
查询json文档是否在指定path包含指定的数据,包含则返回1,否则返回0。
如果有参数为NULL或path不存在,则返回NULL。
-- 声明一个JSON字符串 SET @j = '{"a": 1, "b": 2, "c": {"d": 4}}'; -- 声明一个1的变量 SET @j2 = '1'; -- 查询JSON是否包含参数值函数(参数1 JSON字符串, 参数2 Value值, 参数3 Key值[语法格式:'$.keyname']) SELECT JSON_CONTAINS(@j, @j2, '$.a'); -- 查询的是JSON对象的a属性,a属性的值是1,符合函数的包含条件,所以返回1表示结果TRUE SELECT JSON_CONTAINS(@j, @j2, '$.b'); -- 查询的是JSON对象的b属性,a属性的值是2,不符合函数包含条件,所以返回0表示结果FALSE
结果:
+-------------------------------+ | JSON_CONTAINS(@j, @j2, '$.a') | +-------------------------------+ | 1 | +-------------------------------+ 1 row in set (0.06 sec) +-------------------------------+ | JSON_CONTAINS(@j, @j2, '$.b') | +-------------------------------+ | 0 | +-------------------------------+ 1 row in set (0.05 sec)
JSON_CONTAINS_PATH函数,查询是否存在一个或多个K键
JSON_CONTAINS_PATH(json_doc, one_or_all, path[, path] ...)
查询是否存在指定路径,存在则返回1,否则返回0。如果有参数为NULL,则返回NULL。
one_or_all只能取值"one"或"all",one表示只要有一个存在即可;all表示所有的都存在才行。
-- 定义一个JSON字符串 SET @j = '{"a": 1, "b": 2, "c": {"d": 4}}'; -- 查询是否包含a键和e键,只要存在其中一个就返回1表示结果TRUE SELECT JSON_CONTAINS_PATH(@j, 'one', '$.a', '$.e'); -- 查询是否包含a键和e键,必须全部存在才返回1表示结果TRUE SELECT JSON_CONTAINS_PATH(@j, 'all', '$.a', '$.e'); -- 查询是否包含c键下面的d键,只要存在其中一个就返回1表示结果TRUE SELECT JSON_CONTAINS_PATH(@j, 'one', '$.c.d'); -- 查询是否包含a键下面的d键,只要存在其中一个就返回1表示结果TRUE SELECT JSON_CONTAINS_PATH(@j, 'one', '$.a.d');
JSON_EXTRACT抽取JSON数据
JSON_EXTRACT(json_doc, path[, path] ...)
从json文档里抽取数据。如果有参数有NULL或path不存在,则返回NULL。
如果抽取出多个path,则返回的数据封闭在一个json array里。
-- 抽取参数一的JSON数组,取值是数组的索引1 SELECT JSON_EXTRACT('[10, 20, [30, 40]]', '$[1]'); -- 抽取多个,且合并成数组返回 SELECT JSON_EXTRACT('[10, 20, [30, 40]]', '$[1]', '$[0]'); -- 抽取索引2的全部元素 SELECT JSON_EXTRACT('[10, 20, [30, 40]]', '$[2][*]');
在MySQL5.7.9版本中,支持使用【->】代替JSON_EXRACT表示
在MySQL5.7.13+版本中,支持使用【->>】代替JSON_EXRACT和JSON_UNQUOTE表示
语法演变:
JSON_UNQUOTE( JSON_EXTRACT(column, path) ) JSON_UNQUOTE(column -> path) column->>path
JSON_KEYS 获取指定K键下的所有K值
JSON_KEYS(json_doc[, path])
获取json文档在指定路径下的所有键值,返回一个json array。
如果有参数为NULL或path不存在,则返回NULL。
-- 直接对这个JSON对象获取所有K键【无论是一个还是多个,返回的都是JSON数组】 SELECT JSON_KEYS('{"a": 1, "b": {"c": 30}}'); -- 获取B键下的C键 SELECT JSON_KEYS('{"a": 1, "b": {"c": 30}}', '$.b');
JSON_SEARCH 查询K键的索引
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下查。
-- 声明一个JSON数组 SET @j = '["abc", [{"k": "10"}, "def"], {"x":"abc"}, {"y":"bcd"}]'; -- 查询字符串‘abc’是否存在,如果不存在返回NULL,存在则返回所在的索引位置或者是K键名称,参数'one'表示查找第一个立刻返回(忽略后面相同的) SELECT JSON_SEARCH(@j, 'one', 'abc'); -- 查询字符串‘abc’是否存在,如果不存在返回NULL,存在则返回所在的索引位置或者是K键名称,参数'all'表示查找JSON对象中所有的 SELECT JSON_SEARCH(@j, 'all', 'abc');
JSON_APPEND/JSON_ARRAY_APPEND
JSON_ARRAY_APPEND(json_doc, path, val[, path, val] ...)
在指定path的json array尾部追加val。
如果指定path是一个json object,则将其封装成一个json array再追加。
如果有参数为NULL,则返回NULL。
-- 设置JSON数组 SET @j = '["a", ["b", "c"], "d"]'; -- 对JSON数组的索引1的元素追加值1 SELECT JSON_ARRAY_APPEND(@j, '$[1]', 1); -- 对JSON数组的索引0的元素追加值2 SELECT JSON_ARRAY_APPEND(@j, '$[0]', 2); -- 对JSON数组的索引1下的元素索引0追加值3 SELECT JSON_ARRAY_APPEND(@j, '$[1][0]', 3);
命令行执行效果:
-> SET @j = '["a", ["b", "c"], "d"]'; Query OK, 0 rows affected (0.00 sec) mysql> SELECT JSON_ARRAY_APPEND(@j, '$[1]', 1); +----------------------------------+ | JSON_ARRAY_APPEND(@j, '$[1]', 1) | +----------------------------------+ | ["a", ["b", "c", 1], "d"] | +----------------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_ARRAY_APPEND(@j, '$[0]', 2); +----------------------------------+ | JSON_ARRAY_APPEND(@j, '$[0]', 2) | +----------------------------------+ | [["a", 2], ["b", "c"], "d"] | +----------------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_ARRAY_APPEND(@j, '$[1][0]', 3); +-------------------------------------+ | JSON_ARRAY_APPEND(@j, '$[1][0]', 3) | +-------------------------------------+ | ["a", [["b", 3], "c"], "d"] | +-------------------------------------+ 1 row in set (0.03 sec) mysql>
JSON_ARRAY_INSERT
JSON_ARRAY_INSERT(json_doc, path, val[, path, val] ...)
在path指定的json array元素插入val,原位置及以右的元素顺次右移。
如果path指定的数据非json array元素,则略过此val;
如果指定的元素下标超过json array的长度,则插入尾部。
-- 设置JSON数组 SET @j = '["a", {"b": [1, 2]}, [3, 4]]'; -- 向索引1的位置上插入元素'x', 原先索引1及其后面的元素都会被后置 SELECT JSON_ARRAY_INSERT(@j, '$[1]', 'x'); -- 在索引100的位置上插入元素'x',实际上JSON数组长度不够100,则直接在最后处插入'x'元素 SELECT JSON_ARRAY_INSERT(@j, '$[100]', 'x'); -- 索引1的元素是JSON对象,b属性又是一个JSON数组,在这个B属性索引0上插入'x'元素 SELECT JSON_ARRAY_INSERT(@j, '$[1].b[0]', 'x'); -- 数组下的索引2数组,索引1插入元素'x' SELECT JSON_ARRAY_INSERT(@j, '$[2][1]', 'y'); -- 插入两个元素,并设置了不同位置 SELECT JSON_ARRAY_INSERT(@j, '$[0]', 'x', '$[2][1]', 'y');
命令行效果:
mysql> SET @j = '["a", {"b": [1, 2]}, [3, 4]]'; Query OK, 0 rows affected (0.00 sec) mysql> SELECT JSON_ARRAY_INSERT(@j, '$[1]', 'x'); +------------------------------------+ | JSON_ARRAY_INSERT(@j, '$[1]', 'x') | +------------------------------------+ | ["a", "x", {"b": [1, 2]}, [3, 4]] | +------------------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_ARRAY_INSERT(@j, '$[100]', 'x'); +--------------------------------------+ | JSON_ARRAY_INSERT(@j, '$[100]', 'x') | +--------------------------------------+ | ["a", {"b": [1, 2]}, [3, 4], "x"] | +--------------------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_ARRAY_INSERT(@j, '$[1].b[0]', 'x'); +-----------------------------------------+ | JSON_ARRAY_INSERT(@j, '$[1].b[0]', 'x') | +-----------------------------------------+ | ["a", {"b": ["x", 1, 2]}, [3, 4]] | +-----------------------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_ARRAY_INSERT(@j, '$[2][1]', 'y'); +---------------------------------------+ | JSON_ARRAY_INSERT(@j, '$[2][1]', 'y') | +---------------------------------------+ | ["a", {"b": [1, 2]}, [3, "y", 4]] | +---------------------------------------+ 1 row in set (0.03 sec) mysql> SELECT JSON_ARRAY_INSERT(@j, '$[0]', 'x', '$[2][1]', 'y'); +----------------------------------------------------+ | JSON_ARRAY_INSERT(@j, '$[0]', 'x', '$[2][1]', 'y') | +----------------------------------------------------+ | ["x", "a", {"b": [1, 2]}, [3, 4]] | +----------------------------------------------------+ 1 row in set (0.03 sec) mysql>
JSON_INSERT/JSON_REPLACE/JSON_SET
插入数据
JSON_INSERT(json_doc, path, val[, path, val] ...)
在指定path下插入数据,如果path已存在,则忽略此val(不存在才插入)。
mysql> SET @j = '{ "a": 1, "b": [2, 3]}'; Query OK, 0 rows affected (0.00 sec) mysql> SELECT JSON_INSERT(@j, '$.a', 10, '$.c', '[true, false]'); +----------------------------------------------------+ | JSON_INSERT(@j, '$.a', 10, '$.c', '[true, false]') | +----------------------------------------------------+ | {"a": 1, "b": [2, 3], "c": "[true, false]"} | +----------------------------------------------------+ 1 row in set (0.02 sec) mysql>
替换数据
JSON_REPLACE(json_doc, path, val[, path, val] ...)
替换指定路径的数据,如果某个路径不存在则略过(存在才替换)。
如果有参数为NULL,则返回NULL。
mysql> SET @j = '{ "a": 1, "b": [2, 3]}'; Query OK, 0 rows affected (0.00 sec) mysql> SELECT JSON_REPLACE(@j, '$.a', 10, '$.c', '[true, false]'); +-----------------------------------------------------+ | JSON_REPLACE(@j, '$.a', 10, '$.c', '[true, false]') | +-----------------------------------------------------+ | {"a": 10, "b": [2, 3]} | +-----------------------------------------------------+ 1 row in set (0.01 sec) mysql>
设置指定的数据:
JSON_SET(json_doc, path, val[, path, val] ...)
设置指定路径的数据(不管是否存在)。如果有参数为NULL,则返回NULL。
mysql> SET @j = '{ "a": 1, "b": [2, 3]}'; Query OK, 0 rows affected (0.00 sec) mysql> SELECT JSON_SET(@j, '$.a', 10, '$.c', '[true, false]'); +-------------------------------------------------+ | JSON_SET(@j, '$.a', 10, '$.c', '[true, false]') | +-------------------------------------------------+ | {"a": 10, "b": [2, 3], "c": "[true, false]"} | +-------------------------------------------------+ 1 row in set (0.01 sec) mysql> SELECT JSON_INSERT(@j, '$.a', 10, '$.c', '[true, false]'); +----------------------------------------------------+ | JSON_INSERT(@j, '$.a', 10, '$.c', '[true, false]') | +----------------------------------------------------+ | {"a": 1, "b": [2, 3], "c": "[true, false]"} | +----------------------------------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_REPLACE(@j, '$.a', 10, '$.c', '[true, false]'); +-----------------------------------------------------+ | JSON_REPLACE(@j, '$.a', 10, '$.c', '[true, false]') | +-----------------------------------------------------+ | {"a": 10, "b": [2, 3]} | +-----------------------------------------------------+ 1 row in set (0.03 sec) mysql>
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。
mysql> SELECT JSON_MERGE('[1, 2]', '[true, false]'); +---------------------------------------+ | JSON_MERGE('[1, 2]', '[true, false]') | +---------------------------------------+ | [1, 2, true, false] | +---------------------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_MERGE('{"name": "x"}', '{"id": 47}'); +-------------------------------------------+ | JSON_MERGE('{"name": "x"}', '{"id": 47}') | +-------------------------------------------+ | {"id": 47, "name": "x"} | +-------------------------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_MERGE('1', 'true'); +-------------------------+ | JSON_MERGE('1', 'true') | +-------------------------+ | [1, true] | +-------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_MERGE('[1, 2]', '{"id": 47}'); +------------------------------------+ | JSON_MERGE('[1, 2]', '{"id": 47}') | +------------------------------------+ | [1, 2, {"id": 47}] | +------------------------------------+ 1 row in set (0.02 sec) mysql>
JSON_REMOVE
移除数据
JSON_REMOVE(json_doc, path[, path] ...)
移除指定路径的数据,如果某个路径不存在则略过此路径。如果有参数为NULL,则返回NULL。
mysql> SET @j = '["a", ["b", "c"], "d"]'; Query OK, 0 rows affected (0.00 sec) mysql> SELECT JSON_REMOVE(@j, '$[1]'); +-------------------------+ | JSON_REMOVE(@j, '$[1]') | +-------------------------+ | ["a", "d"] | +-------------------------+ 1 row in set (0.01 sec) mysql>
JSON_DEEPTH
查询JSON文档的深度
JSON_DEPTH(json_doc)
获取json文档的深度。如果参数为NULL,则返回NULL。
空的json array、json object或标量的深度为1。
mysql> SELECT JSON_DEPTH('{}'), JSON_DEPTH('[]'), JSON_DEPTH('true'); +------------------+------------------+--------------------+ | JSON_DEPTH('{}') | JSON_DEPTH('[]') | JSON_DEPTH('true') | +------------------+------------------+--------------------+ | 1 | 1 | 1 | +------------------+------------------+--------------------+ 1 row in set (0.01 sec) mysql> SELECT JSON_DEPTH('[10, 20]'), JSON_DEPTH('[[], {}]'); +------------------------+------------------------+ | JSON_DEPTH('[10, 20]') | JSON_DEPTH('[[], {}]') | +------------------------+------------------------+ | 2 | 2 | +------------------------+------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_DEPTH('[10, {"a": 20}]'); +-------------------------------+ | JSON_DEPTH('[10, {"a": 20}]') | +-------------------------------+ | 3 | +-------------------------------+ 1 row in set (0.02 sec) mysql>
JSON_LENGTH
JSON_LENGTH(json_doc[, path])
获取指定路径下的长度。如果参数为NULL,则返回NULL。
长度的计算规则:
- 标量的长度为1;
- json array的长度为元素的个数;
- json object的长度为key的个数。
mysql> SELECT JSON_LENGTH('[1, 2, {"a": 3}]'); +---------------------------------+ | JSON_LENGTH('[1, 2, {"a": 3}]') | +---------------------------------+ | 3 | +---------------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_LENGTH('{"a": 1, "b": {"c": 30}}'); +-----------------------------------------+ | JSON_LENGTH('{"a": 1, "b": {"c": 30}}') | +-----------------------------------------+ | 2 | +-----------------------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_LENGTH('{"a": 1, "b": {"c": 30}}', '$.b'); +------------------------------------------------+ | JSON_LENGTH('{"a": 1, "b": {"c": 30}}', '$.b') | +------------------------------------------------+ | 1 | +------------------------------------------------+ 1 row in set (0.03 sec) mysql>
JSON_TYPE
JSON_TYPE(json_val)
获取json文档的具体类型。如果参数为NULL,则返回NULL。
https://www.cnblogs.com/waterystone/p/5626098.html
json中的数据可以用 =, <, <=, >, >=, <>, !=, and <=> 进行比较。
但json里的数据类型可以是多样的,那么在不同类型之间进行比较时,就有优先级了,高优先级的要大于低优先级的(可以用JSON_TYPE()函数查看类型)。
优先级从高到低如下:
BLOB BIT OPAQUE DATETIME TIME DATE BOOLEAN ARRAY OBJECT STRING INTEGER, DOUBLE NULL
JSON_VALID
JSON_VALID(val)
判断val是否为有效的json格式,是为1,不是为0。
如果参数为NUL,则返回NULL。
mysql> SELECT JSON_VALID('{"a": 1}'); +------------------------+ | JSON_VALID('{"a": 1}') | +------------------------+ | 1 | +------------------------+ 1 row in set (0.02 sec) mysql> SELECT JSON_VALID('hello'), JSON_VALID('"hello"'); +---------------------+-----------------------+ | JSON_VALID('hello') | JSON_VALID('"hello"') | +---------------------+-----------------------+ | 0 | 1 | +---------------------+-----------------------+ 1 row in set (0.02 sec) mysql>