在关系型数据库中,很多业务场景会把半结构化数据存储为JSON格式,比如用户的扩展属性、商品的动态规格等,这类数据通常存放在JSON类型的字段中。要从中获取需要的具体信息,就需要用到专门的JSON解析函数,JSON_EXTRACT就是MySQL中常用的这类函数。

JSON_EXTRACT基本语法
JSON_EXTRACT函数的作用是从JSON文档中提取指定路径的数据,基本语法格式如下:
JSON_EXTRACT(json_doc, path[, path] ...)
其中json_doc是待解析的JSON字段或者JSON格式的字符串,path是要提取的数据的路径,路径以$开头,表示整个JSON文档的根节点。如果要提取对象中的某个属性,路径格式为$.属性名;如果要提取数组中的某个元素,路径格式为$[数组索引],数组索引从0开始。
提取JSON对象中的属性
假设我们有一张用户表user,其中ext_info字段存储用户的扩展信息,结构如下:
CREATE TABLE user (
id INT PRIMARY KEY,
name VARCHAR(50),
ext_info JSON
);
INSERT INTO user VALUES
(1, '张三', '{"age": 25, "city": "北京", "hobby": ["篮球", "阅读"]}'),
(2, '李四', '{"age": 30, "city": "上海", "hobby": ["足球", "旅行"]}');
如果要提取所有用户的年龄和城市,SQL语句可以这样写:
SELECT
id,
name,
JSON_EXTRACT(ext_info, '$.age') AS age,
JSON_EXTRACT(ext_info, '$.city') AS city
FROM user;
执行上述语句后,会返回每个用户对应的年龄和城市信息,提取出来的JSON属性值默认会带双引号,如果需要去掉双引号,可以结合JSON_UNQUOTE函数使用,或者直接用->>操作符,写法如下:
SELECT
id,
name,
ext_info->>'$.age' AS age,
ext_info->>'$.city' AS city
FROM user;
提取JSON数组中的元素
如果JSON字段中包含数组类型的数据,比如上面用户表中的hobby属性是数组,要提取第一个爱好可以这样写:
SELECT
id,
name,
JSON_EXTRACT(ext_info, '$.hobby[0]') AS first_hobby
FROM user;
如果要提取整个爱好数组,路径可以直接写$.hobby:
SELECT
id,
name,
JSON_EXTRACT(ext_info, '$.hobby') AS all_hobby
FROM user;
多路径提取与条件过滤
JSON_EXTRACT支持同时传入多个路径,返回多个提取结果,另外也可以结合WHERE子句对提取出来的JSON数据进行过滤。比如要查询年龄大于25岁的用户的城市信息:
SELECT
id,
name,
ext_info->>'$.city' AS city
FROM user
WHERE JSON_EXTRACT(ext_info, '$.age') > 25;
这里需要注意,提取出来的年龄是JSON数值类型,直接和数值比较即可,不需要额外转换类型。
注意事项
- 路径中的属性名如果包含特殊字符,需要用双引号包裹,比如路径为
$."user-name" - 如果提取的路径不存在,JSON_EXTRACT会返回NULL,不会报错
- 不同数据库的JSON解析函数语法可能有差异,本文示例基于MySQL 5.7及以上版本,其他数据库需要参考对应文档调整语法
使用JSON_EXTRACT函数可以有效减少应用层解析JSON的压力,让数据提取逻辑在数据库层完成,提升整体处理效率。
JSON_EXTRACTSQLJSON字段解析MySQL修改时间:2026-07-06 23:33:11