JSON_EXTRACT_STRING()

JSON_EXTRACT_STRING() 用于从 JSON 数据中提取指定路径的字符串值。

函数说明

JSON_EXTRACT_STRING() 用于从 JSON 数据中提取指定路径的字符串值。

如果在 where 条件中进行比较:

  • 如果类型为 json 对象比较,使用 JSON EXTRACT();

  • 如果类型是字符串类型,使用 JSON_EXTRACT_STRING();

  • 如果类型为 float 或者 int,使用 JSON_EXTRACT_FLOAT64()。

语法结构

select col_name from tab_name where json_extract_string(jsonDoc, pathExpression)= 'string';

参数释义

参数

说明

jsonDoc

这是包含 JSON 数据的列或表达式。

pathExpression

表示在 JSON 文档中访问某个值的路径。一次只能接收一个路径,路径以 $ 开始,表示 JSON 文档的根,后面可以跟随点号 . 和键名或用方括号 [ ] 访问数组的元素。

string

指定与函数结果比较的字符串值,位于函数调用之外。

路径表达式必须以 $ 字符开头:

  • . 后跟键名,使用给定键访问对象成员。包含空格或其他非标识符字符的键必须使用双引号;普通标识符键可以不加引号。

  • [N]:选择数组的 path 后,将数组中位置 N 处的值命名。数组位置是从零开始的整数。如果数组是负数,则产生报错。

  • JSON_EXTRACT_STRING() 只接受选取单个值的简单路径,不支持 .*、[*] 或递归 ** 等通配符路径。

  • 文档中不存在的路径(或不存在的数据)评估为 NULL。

示例

-- 创建测试表
CREATE TABLE student(
    id INT,
    info JSON
);

-- 插入测试数据
INSERT INTO student VALUES
    (1, '{"name": "tom", "age": 18, "scores": [85, 90, 78]}'),
    (2, '{"name": "bob", "age": 20, "scores": [75, 82, 91]}');

-- 提取字符串值
mysql> SELECT id FROM student WHERE json_extract_string(info, '$.name') = 'tom';
+------+
| id   |
+------+
|    1 |
+------+
1 row in set (0.01 sec)

-- 不存在的路径返回 NULL
mysql> SELECT json_extract_string(info, '$.address') FROM student;
+--------------------------------------+
| json_extract_string(info, $.address) |
+--------------------------------------+
| NULL                                 |
| NULL                                 |
+--------------------------------------+
2 rows in set (0.00 sec)