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 文档中访问某个值的路径。一次只能接收一个路径,路径以 |
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)