MySQL 函数分为四类
- 创建(Create JSON Values)
- 修改(Modify JSON Values)
- 查询(Search JSON Values)
- 返回json相关属性(Return JSON Value Attributes)的方法。
创建类的方法
JSON_ARRAY([val[, val] …])
创建JSON数组形式的数据
SELECT JSON_ARRAY(1, "abc", NULL, TRUE, CURTIME());
[1, "abc", null, true, "11:30:24.000000"]
JSON_OBJECT([key, val[, key, val] …])
创建一个JSON对象
SELECT JSON_OBJECT('id', 87, 'name', 'carrot');
{"id": 87, "name": "carrot"}
修改类的方法
JSON_ARRAY_APPEND(json_doc, path, val[, path, val] …)
在JSON数组后增加新的数据
mysql> SET @j = '["a", ["b", "c"], "d"]';
mysql> SELECT JSON_ARRAY_APPEND(@j, '$[1]', 1);
["a", ["b", "c", 1], "d"]
JSON_ARRAY_INSERT(json_doc, path, val[, path, val] …)
插入数据到JSON中,path为插入的路径
mysql> SET @j = '["a", {"b": [1, 2]}, [3, 4]]';
mysql> SELECT JSON_ARRAY_INSERT(@j, '$[1]', 'x');
["a", "x", {"b": [1, 2]}, [3, 4]]
JSON_MERGE(json_doc, json_doc[, json_doc] …)
合并JSON数据
SELECT JSON_MERGE('[1, 2]', '[true, false]');
[1, 2, true, false]
JSON_REMOVE(json_doc, path[, path] …)
删除一部分JSON数据
mysql> SET @j = '["a", ["b", "c"], "d"]';
mysql> SELECT JSON_REMOVE(@j, '$[1]');
["a", "d"]
JSON_REPLACE(json_doc, path, val[, path, val] …)
替换一部分JSON数据
mysql> SET @j = '{ "a": 1, "b": [2, 3]}';
mysql> SELECT JSON_REPLACE(@j, '$.a', 10, '$.c', '[true, false]');
{"a": 10, "b": [2, 3]}
JSON_SET(json_doc, path, val[, path, val] …)
有存在的数据就替换,没有就插入
mysql> SET @j = '{ "a": 1, "b": [2, 3]}';
mysql> SELECT JSON_SET(@j, '$.a', 10, '$.c', '[true, false]');
{"a": 10, "b": [2, 3], "c": "[true, false]"}
查询类方法
JSON_CONTAINS(json_doc, val[, path])
查找是否包含
mysql> SET @j = '{"a": 1, "b": 2, "c": {"d": 4}}';
mysql> SET @j2 = '1';
mysql> SELECT JSON_CONTAINS(@j, @j2, '$.a');
1
mysql> SELECT JSON_CONTAINS(@j, @j2, '$.b');
0
JSON_CONTAINS_PATH(json_doc, one_or_all, path[, path] …)
查找path(一般就是key)是否存在
mysql> SET @j = '{"a": 1, "b": 2, "c": {"d": 4}}';
mysql> SELECT JSON_CONTAINS_PATH(@j, 'one', '$.a', '$.e');
1
mysql> SELECT JSON_CONTAINS_PATH(@j, 'all', '$.a', '$.e');
0
JSON_EXTRACT(json_doc, path[, path] …)
分解JSON 并查询,实际上就是在提供的path下查找值
mysql> SELECT JSON_EXTRACT('[10, 20, [30, 40]]', '$[1]');
20
mysql> SELECT JSON_EXTRACT('[10, 20, [30, 40]]', '$[1]', '$[0]');
[20, 10]
JSON_EXTRACT 的替代语法 column->path
以下两种方式等价
mysql> SELECT c, JSON_EXTRACT(c, "$.id"), g
> FROM jemp
> WHERE JSON_EXTRACT(c, "$.id") > 1
> ORDER BY JSON_EXTRACT(c, "$.name");
mysql> SELECT c, c->"$.id", g
> FROM jemp
> WHERE c->"$.id" > 1
> ORDER BY c->"$.name";
JSON_KEYS(json_doc[, path])
提出当前提供path下的key值
SELECT JSON_KEYS('{"a": 1, "b": {"c": 30}}');
["a", "b"]
JSON_SEARCH(json_doc, one_or_all, search_str[, escape_char[, path] …])
按着提供的值去查询,返回path数组
mysql> SET @j = '["abc", [{"k": "10"}, "def"], {"x":"abc"}, {"y":"bcd"}]';
mysql> SELECT JSON_SEARCH(@j, 'one', 'abc');
"$[0]"
mysql> SELECT JSON_SEARCH(@j, 'all', 'abc');
["$[0]", "$[2].x"]
查询JSON自有属性的方法
JSON_DEPTH(json_doc)
查询当前JSON深度
SELECT JSON_DEPTH('[10, {"a": 20}]');
3
JSON_LENGTH(json_doc[, path])
查询当前层级(path)下对象或者数组的元素数量
mysql> SELECT JSON_LENGTH('{"a": 1, "b": {"c": 30}}');
2
JSON_TYPE(json_val)
返回JSON值类型
mysql> SET @j = '{"a": [10, true]}';
mysql> SELECT JSON_TYPE(@j);
OBJECT
SELECT JSON_TYPE(JSON_EXTRACT(@j, '$.a'));
ARRAY
JSON_VALID(val)
验证是否是JSON
mysql> SELECT JSON_VALID('{"a": 1}');
1
SELECT JSON_VALID('hello'), JSON_VALID('"hello"');
0,1
以上内容参考自官方文档:https://dev.mysql.com/doc/refman/5.7/en/json-functions.html