大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:json_query

· 52CE 我爱测

示例 2:查询可以通过指定 JSON 对象中的 表达式定位的元素值。在此示例中,元素不存在。因此,json_query 函数返回 SQL 值 。

json_query

查询可以通过 JSON 对象中的 json_path 表达式定位的元素值,并返回一个 JSON 值。

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

通过生成列加速查询

语法

json_query(json_object_expr, json_path)

参数

  • json_object_expr:表示 JSON 对象的表达式。该对象可以是一个 JSON 列,或者是由诸如 PARSE_JSON 之类的 JSON 构造函数生成的 JSON 对象。

  • json_path:表示 JSON 对象中元素路径的表达式。此参数的值是一个字符串。有关 StarRocks 支持的 JSON 路径语法的信息,请参见JSON 函数和操作符概述。

返回值

返回一个 JSON 值。

如果元素不存在,json_query 函数返回 SQL 值 NULL。

示例

示例 1:查询可以通过指定 JSON 对象中的 '$.a.b' 表达式定位的元素值。在此示例中,json_query 函数返回 JSON 值 1。

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

       -> 1

示例 2:查询可以通过指定 JSON 对象中的 '$.a.c' 表达式定位的元素值。在此示例中,元素不存在。因此,json_query 函数返回 SQL 值 NULL。

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

       -> NULL

示例 3:查询可以通过指定 JSON 对象中的 '$.a[2]' 表达式定位的元素值。在此示例中,JSON 对象是一个名为 a 的数组,包含索引 2 处的元素,元素值为 3。因此,JSON_QUERY 函数返回 JSON 值 3。

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

       -> 3

示例 4:查询可以通过指定 JSON 对象中的 '$.a[3]' 表达式定位的元素。在此示例中,JSON 对象是一个名为 a 的数组,不包含索引 3 处的元素。因此,json_query 函数返回 SQL 值 NULL。

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

       -> NULL

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。