从 MySQL 5.7.8 开始,MySQL 支持原生的 JSON 数据类型。
类似 varchar,设置 JSON 主要将字段的 type 是 json, 不能设置长度,可以是 NULL 但不能有默认值。
创建 JSON
CREATE TABLE test_json (
`id` INT(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`category` JSON,
`tags` JSON,
PRIMARY KEY (`id`)
);
插入 JSON
-- 就是插入 json 格式的字符串,可以是对象的形式,也可以是数组的形式
INSERT INTO `test_json` (category, tags) VALUES ('{"id": 1, "name": "itplh.com"}', '[1, 2, 3]');
-- MySQL 也有专门的函数 JSON_OBJECT,JSON_ARRAY 生成 json 格式的数据
INSERT INTO `test_json` (category, tags) VALUES (JSON_OBJECT("id", 2, "name", "java.net"), JSON_ARRAY(1, 3, 5));
-- 更多生成 JSON 值的函数请参考: http://dev.mysql.com/doc/refman/5.7/en/json-creation-functions.html
查询 JSON
-- 查询 json 中的数据用 column->path 的形式,其中对象类型 path 这样表示 .path, 而数组类型则是 *[index]
SELECT id, category->'$.id' AS categoryId, category->'$.name' AS categoryName, tags-'$[0]' AS tags1, tags->'$[2]' AS tags3 FROM test_json;
-- 可以看到对应字符串类型的 category->’$.name’ 中还包含着双引号,这其实并不是想要的结果,可以用 JSON_UNQUOTE 函数将双引号去掉
-- 从 MySQL 5.7.13 起也可以通过这个操作符 ->> 这个和 JSON_UNQUOTE 是等价的
SELECT id, category->'$.name' AS categoryName1, JSON_UNQUOTE(category->'$.name') AS categoryName2, category->>'$.name' AS categoryName3 FROM test_json;
-- 下面说下 JSON 作为条件进行搜索。因为 JSON 不同于字符串,所以如果用字符串和 JSON 字段比较,是不会相等的
SELECT * FROM test_json WHERE category = '{"id": 1, "name": "itplh.com"}';
-- 这时可以通过 CAST 将字符串转成 JSON 的形式
SELECT * FROM test_json WHERE category = CAST('{"id": 1, "name": "itplh.com"}' AS JSON);
-- 通过 JSON 中的元素进行查询, 对象型的查询同样可以通过 column->path
SELECT * FROM test_json WHERE category->'$.name' = 'itplh.com';
-- 上面有提到 column->path 形式从 select 中查询出来的字符串是包含双引号的,但作为条件这里其实没什么影响,-> 和 ->> 结果是一样的
SELECT * FROM test_json WHERE category->>'$.name' = 'itplh.com';
-- 要特别注意的是,JSON 中的元素搜索是严格区分变量类型的,比如说整型和字符串是严格区分的
SELECT * FROM test_json WHERE category->'$.id' = '1';
SELECT * FROM test_json WHERE category->'$.id' = 1; -- 可以看到搜索字符串 1 和整型 1 的结果是不一样的。
-- 除了用 column->path 的形式搜索,还可以用 JSON_CONTAINS 函数,
-- 但和 *column->path *的形式有点相反的是,JSON_CONTAINS 第二个参数是不接受整数的
-- 无论 json 元素是整型还是字符串,否则会出现这个错误
SELECT * FROM test_json WHERE JSON_CONTAINS(category, 1, '$.id'); -- 错误代码: 3146 Invalid DATA TYPE FOR JSON DATA IN argument 2 TO FUNCTION JSON_CONTAINS; a JSON STRING OR JSON TYPE IS required.
-- JSON_CONTAINS 第二个参数必须是要字符串 1
SELECT * FROM test_json WHERE JSON_CONTAINS(category, '1', '$.id');
-- 对于数组类型的 JSON 的查询,比如说 tags 中包含有 2 的数据,同样要用 JSON_CONTAINS 函数,同样第二个参数也需要是字符串
SELECT * FROM test_json WHERE JSON_CONTAINS(tags, '2');
-- 更多搜索 JSON 值的函数请参考:https://dev.mysql.com/doc/refman/5.7/en/json-function-reference.html
更新 JSON
-- 如果是整个 json 更新的话,和插入时类似的。
UPDATE test_json SET tags = '[1, 3, 4]' WHERE id = 1;
SELECT * FROM test_json;
-- 但如果要更新 JSON 下的元素,MySQL 并不支持 column->path 的形式
UPDATE test_json SET category->'$.name' = 'test_json', tags-'$[0]' = 2 WHERE id = 1; -- 错误代码: 1064 You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '->'$.name' = 'test_json', tags-'$[0]' = 2 WHERE id = 1' at line 1
-- 则可能要用到以下几个函数
-- JSON_INSERT() 插入新值,但不会覆盖已经存在的值
UPDATE test_json SET category = JSON_INSERT(category, '$.name', 'test_json', '$.url', 'www.itplh.com') WHERE id = 1;
SELECT * FROM test_json; -- 可以看到 name 没有被修改,但新元素 url 已经添加进去
-- JSON_SET() 插入新值,并覆盖已经存在的值
UPDATE test_json SET category = JSON_SET(category, '$.host', 'www.itplh.com', '$.url', 'http://www.itplh.com') WHERE id = 1;
SELECT * FROM test_json; -- 可以看到 host 已经插入,url 已经被修改
-- JSON_REPLACE() 只替换存在的值
UPDATE test_json SET category = JSON_REPLACE(category, '$.name', 'java', '$.url', 'http://www.java.net') WHERE id = 1;
SELECT * FROM test_json; -- 可以看到 name 已经被替换,url 不存在被忽略。
-- JSON_REMOVE() 删除 JSON 元素
UPDATE test_json SET category = JSON_REMOVE(category, '$.url', '$.host') WHERE id = 1;
SELECT * FROM test_json;
-- 更多函数请参考:http://dev.mysql.com/doc/refman/5.7/en/json-modification-functions.html