GET_JSON_INT
描述
函数用于从 JSON 文档中提取一个字段的值并将其转换为 INT
类型。该函数会返回指定路径上的字段值,如果该值无法转换为 INT
类型,或者路径指向的字段不存在,则返回 NULL
。
语法
GET_JSON_INT( <json_str>, <json_path>)
必选参数
参数 | 描述 |
---|---|
<json_str> | 需要从中提取数据的 JSON 字符串。 |
<json_path> | JSON 路径,指定字段的位置。路径可以使用点号表示法。 |
注意事项
解析并获取 json 字符串内指定路径的整型内容。
其中 <json_path>
必须以 $ 符号作为开头,使用 . 作为路径分割符。如果路径中包含 . ,则可以使用双引号包围。
使用 [ ] 表示数组下标,从 0 开始。
path 的内容不能包含 ", [ 和 ]。
如果 <json_str>
格式不对,或 <json_path>
格式不对,或无法找到匹配项,则返回 NULL。
另外,推荐使用jsonb类型和jsonb_extract_XXX函数实现同样的功能。
特殊情况处理如下:
- 如果
<json_path>
指定的字段在JSON中不存在,返回NULL - 如果
<json_path>
指定的字段在JSON中的实际类型和json_extract_t指定的类型不一致,如果能无损转换成指定类型返回指定类型t,如果不能则返回NULL
示例
- 获取 key 为 "k1" 的 value
SELECT get_json_int('{"k1":1, "k2":"2"}', "$.k1");
+--------------------------------------------+
| get_json_int('{"k1":1, "k2":"2"}', '$.k1') |
+--------------------------------------------+
| 1 |
+--------------------------------------------+
- 获取 key 为 "my.key" 的数组中第二个元素
SELECT get_json_int('{"k1":"v1", "my.key":[1, 2, 3]}', '$."my.key"[1]');
+------------------------------------------------------------------+
| get_json_int('{"k1":"v1", "my.key":[1, 2, 3]}', '$."my.key"[1]') |
+------------------------------------------------------------------+
| 2 |
+------------------------------------------------------------------+
- 获取二级路径为 k1.key -> k2 的数组中,第一个元素
SELECT get_json_int('{"k1.key":{"k2":[1, 2]}}', '$."k1.key".k2[0]');
+--------------------------------------------------------------+
| get_json_int('{"k1.key":{"k2":[1, 2]}}', '$."k1.key".k2[0]') |
+--------------------------------------------------------------+
| 1 |
+--------------------------------------------------------------+