跳到主要内容
版本:2.5

json_query

功能

查询 JSON 对象中指定路径(json_path)的值,并输出 JSON 类型。

语法

JSON_QUERY(json_object_expr, json_path)

参数说明

  • json_object_expr:JSON 对象的表达式,可以是 JSON 类型的列,或者 PARSE_JSON 等 JSON 函数构造的 JSON 对象。

  • json_path: 查询 JSON 对象时的路径。支持的数据类型为字符串。StarRocks 支持的 JSON Path 的语法,请参见 JSON Path 语法

返回值说明

返回 JSON 类型的值。

如果查询的字段不存在,返回 SQL 类型的 NULL。

示例

示例一:查询 JSON 对象中路径表达式 '$.a.b' 指定的值,返回 JSON 类型的 1。

mysql> SELECT JSON_QUERY(PARSE_JSON('{"a": {"b": 1}}'), '$.a.b') ;
-> 1

示例二:查询 JSON 对象中路径表达式 '$.a.c' 指定的值,由于不存在该值,因此返回 SQL 类型的 NULL。

mysql> SELECT JSON_QUERY(PARSE_JSON('{"a": {"b": 1}}'), '$.a.c') ;
-> NULL

示例三:查询 JSON 对象中路径表达式 '$.a[2]' (a 数组的第 2 个元素)指定的值,返回 JSON 类型的 3。

mysql> SELECT JSON_QUERY(PARSE_JSON('{"a": [1,2,3]}'), '$.a[2]') ;
-> 3

示例四:查询 JSON 对象中路径表达式 '$.a[3]' (a 数组的第 3 个元素)指定的值,由于不存在该值,因此返回 SQL 类型的 NULL。

mysql> SELECT JSON_QUERY(PARSE_JSON('{"a": [1,2,3]}'), '$.a[3]') ;
-> NULL