parse_json

将字符串转换为 JSON 值。

提示

所有的 JSON 函数和运算符都列在导航栏和概述页面

通过生成列加速查询

语法

parse_json(string_expr)

参数

string_expr：表示字符串的表达式。仅支持 STRING、VARCHAR 和 CHAR 数据类型。

返回值

返回一个 JSON 值。

注意：如果字符串无法解析为标准 JSON 值，PARSE_JSON 函数将返回 NULL（参见示例 5）。有关 JSON 规范的信息，请参见 RFC 7159。

示例

示例 1：将 STRING 值 1 转换为 JSON 值 1。

mysql> SELECT parse_json('1');
+-----------------+
| parse_json('1') |
+-----------------+
| "1"             |
+-----------------+

示例 2：将 STRING 数据类型的数组转换为 JSON 数组。

mysql> SELECT parse_json('[1,2,3]');
+-----------------------+
| parse_json('[1,2,3]') |
+-----------------------+
| [1, 2, 3]             |
+-----------------------+ 

示例 3：将 STRING 数据类型的对象转换为 JSON 对象。

mysql> SELECT parse_json('{"star": "rocks"}');
+---------------------------------+
| parse_json('{"star": "rocks"}') |
+---------------------------------+
| {"star": "rocks"}               |
+---------------------------------+

示例 4：构造一个 JSON 值 NULL。

mysql> SELECT parse_json('null');
+--------------------+
| parse_json('null') |
+--------------------+
| "null"             |
+--------------------+

示例 5：如果字符串无法解析为标准 JSON 值，PARSE_JSON 函数将返回 NULL。在此示例中，star 未用双引号（"）括起来。因此，PARSE_JSON 函数返回 NULL。

mysql> SELECT parse_json('{star: "rocks"}');
+-------------------------------+
| parse_json('{star: "rocks"}') |
+-------------------------------+
| NULL                          |
+-------------------------------+

示例 6：如果 JSON 键包含 '.'，例如 'a.1'，则必须用 '\' 转义，或者需要将整个键值连同双引号一起用单引号括起来。

mysql> select parse_json('{"b":4, "a.1": "1"}')->"a\\.1";
+--------------------------------------------+
| parse_json('{"b":4, "a.1": "1"}')->'a\\.1' |
+--------------------------------------------+
| "1"                                        |
+--------------------------------------------+
mysql> select parse_json('{"b":4, "a.1": "1"}')->'"a.1"';
+--------------------------------------------+
| parse_json('{"b":4, "a.1": "1"}')->'"a.1"' |
+--------------------------------------------+
| "1"                                        |
+--------------------------------------------+

关键词

parse_json, parse json