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

JSON 函数和操作符概述

· 52CE 我爱测

JSON 查询函数和处理函数用于查询和处理 JSON 数据。例如,您可以使用路径表达式定位 JSON 对象中的元素。

JSON 函数和操作符概述

本主题提供了 StarRocks 支持的 JSON 构造函数、查询函数、处理函数、操作符和路径表达式的概述。

JSON 构造函数

JSON 构造函数用于构建 JSON 数据,例如 JSON 对象和 JSON 数组。

Function Description Example Return value
json_object 将一个或多个键值对转换为一个 JSON 对象,该对象由按字典顺序排序的键值对组成。 SELECT JSON_OBJECT('Daniel Smith', 26, 'Lily Smith', 25); {"Daniel Smith": 26, "Lily Smith": 25}
json_array 将 SQL 数组的每个元素转换为 JSON 值,并返回由这些 JSON 值组成的 JSON 数组。 SELECT JSON_ARRAY(1, 2, 3); [1,2,3]
parse_json 将字符串转换为 JSON 值。 SELECT PARSE_JSON('{"a": 1}'); {"a": 1}

JSON 查询函数和处理函数

JSON 查询函数和处理函数用于查询和处理 JSON 数据。例如,您可以使用路径表达式定位 JSON 对象中的元素。

Function Description Example Return value
arrow function 查询可以通过路径表达式定位的 JSON 对象中的元素。 SELECT parse_json('{"a": {"b": 1}}') -> '$.a.b'; 1
cast 在 JSON 数据类型和 SQL 数据类型之间转换数据。 SELECT CAST(1 AS JSON); 1
get_json_double 分析并从 JSON 字符串的指定路径中获取浮点值。 SELECT get_json_double('{"k1":1.3, "k2":"2"}', "$.k1"); 1.3
get_json_int 分析并从 JSON 字符串的指定路径中获取整数值。 SELECT get_json_int('{"k1":1, "k2":"2"}', "$.k1"); 1
get_json_string 分析并从 JSON 字符串的指定路径中获取字符串。 SELECT get_json_string('{"k1":"v1", "k2":"v2"}', "$.k1"); v1
json_query 查询可以通过路径表达式定位的 JSON 对象中元素的值。 SELECT JSON_QUERY('{"a": 1}', '$.a'); 1
json_each 将 JSON 对象的顶级元素展开为键值对。 SELECT * FROM tj_test, LATERAL JSON_EACH(j); !json_each
json_exists 检查 JSON 对象是否包含可以通过路径表达式定位的元素。如果元素存在,该函数返回 1。如果元素不存在,该函数返回 0。 SELECT JSON_EXISTS('{"a": 1}', '$.a'); 1
json_keys 返回 JSON 对象的顶级键作为 JSON 数组,或者如果指定了路径,则返回路径的顶级键。 SELECT JSON_KEYS('{"a": 1, "b": 2, "c": 3}'); ["a", "b", "c"]
json_length 返回 JSON 文档的长度。 SELECT json_length('{"Name": "Alice"}'); 1
json_string 将 JSON 对象转换为 JSON 字符串 SELECT json_string(parse_json('{"Name": "Alice"}')); {"Name": "Alice"}

JSON 操作符

StarRocks 支持以下 JSON 比较操作符:<、<=、>、>=、= 和 !=。您可以使用这些操作符查询 JSON 数据。但是,不允许使用 IN 查询 JSON 数据。有关 JSON 操作符的更多信息,请参见 JSON operators。

JSON 路径表达式

您可以使用 JSON 路径表达式查询 JSON 对象中的元素。JSON 路径表达式的数据类型为 STRING。在大多数情况下,它们与各种 JSON 函数一起使用,例如 JSON_QUERY。在 StarRocks 中,JSON 路径表达式不完全符合 SQL/JSON 路径规范。有关 StarRocks 支持的 JSON 路径语法的信息,请参见下表,其中使用以下 JSON 对象作为示例。

{
    "people": [{
        "name": "Daniel",
        "surname": "Smith"
    }, {
        "name": "Lily",
        "surname": "Smith",
        "active": true
    }]
}
JSON path symbol Description JSON path example Return value
$ 表示根 JSON 对象。 '$' { "people": [ { "name": "Daniel", "surname": "Smith" }, { "name": "Lily", "surname": Smith, "active": true } ] }
. 表示子 JSON 对象。 ' $.people' [ { "name": "Daniel", "surname": "Smith" }, { "name": "Lily", "surname": Smith, "active": true } ]
[] 表示一个或多个数组索引。[n] 表示数组中的第 n 个元素。索引从 0 开始。
StarRocks 2.5 支持查询多维数组,例如 ["Lucy", "Daniel"], ["James", "Smith"]。要查询 "Lucy" 元素,可以使用 $.people[0][0]。
'$.people [0]' { "name": "Daniel", "surname": "Smith" }
[*] 表示数组中的所有元素。 '$.people[*].name' ["Daniel", "Lily"]
[start: end] 表示数组中的一个子集。子集由 [start, end] 区间指定,不包括由结束索引表示的元素。 '$.people[0: 1].name' ["Daniel"]

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

资料来源与适用范围

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

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

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