本文介绍 JSON 函数的基本语法及示例。
函数名称 | 语句 | 含义 |
json_array_contains(x,value) | 判断 JSON 数组中是否包含某个值。 | |
json_array_get(x,index) | 获取 JSON 数组中某个下标对应的元素。 | |
json_array_length(x) | 计算 JSON 数组中元素的数量。x 不是 JSON 数组时，返回 null。 | |
json_extract(x,json_path) | 从 JSON 对象或 JSON 数组中提取一组 JSON 值（数组或对象）。 | |
json_extract_scalar(x,json_path) | 从 JSON 对象或 JSON 数组中提取一组标量值（字符串、整数或布尔值）。类似于 json_extract 函数。 | |
json_format(x) | 把 JSON 类型转化成字符串类型。 | |
json_parse(x) | 把字符串类型转化成 JSON 类型。 | |
json_size(x,json_path) | 计算 JSON 对象或数组中元素的数量。 |
json_array_contains 函数
json_array_contains 函数用于判断 JSON 数组中是否包含某个值。
语法
json_array_contains(x, value)
参数说明
参数 | 说明 |
x | 参数值为 JSON 数组。 |
value | 数值。 |
返回值类型
boolean 类型。
示例
判断 JSON 字符[1，2，3]中是否包含2。
查询和分析语句
* | SELECT json_array_contains('[1, 2, 3]', 2)
查询和分析结果
TRUE
json_array_get 函数
json_array_get 函数用于获取 JSON 数组中某个下标对应的元素。
语法
json_array_get(x, index)
参数说明
参数 | 说明 |
x | 参数值为 JSON 数组。 |
index | JSON 下标，从0开始。 |
返回值类型
varchar类型。
示例
返回 JSON 数组["a", [3, 9], "c"]下标为1的元素。
查询和分析语句
* | SELECT json_array_get('["a", [3, 9], "c"]', 1)
查询和分析结果
[3,9]
json_array_length 函数
json_array_length 函数用于计算 JSON 数组中元素的数量。x 不是 JSON 数组时，返回 null。
语法
json_array_length(x)
参数说明
参数 | 说明 |
x | 参数值为 JSON 数组。 |
返回值类型
bigint 类型。
示例
示例1：计算 apple.message 字段值中 JSON 元素的数量。
apple.message:[{"traceName":"StoreMonitor"},{"topicName":"persistent://apache/pulsar/test-partition-17"},{"producerName":"pulsar-mini-338-36"},{"localAddr":"pulsar://pulsar-mini-broker-5.pulsar-mini-broker.pulsar.svc.cluster.local:6650"},{"sequenceId":826},{"storeTime":1635905306062},{"messageId":"19422-24519"},{"status":"SUCCESS"}]
查询和分析语句
* | SELECT json_array_length(apple.message)
查询和分析结果
8
json_extract 函数
json_extract 函数用于从 JSON 对象或 JSON 数组中提取一组 JSON 值（数组或对象）。
语法
json_extract(x, json_path)
参数说明
参数 | 说明 |
x | 参数值为 JSON 对象或 JSON 数组。 |
json_path | 注意： 不支持需要遍历数组元素的 JSON 语法，例如 $.store.book[*].author、$..book[(@.length-1)]、$..book[?(@.price<10)]等。元素名称包含特殊字符时，使用 []语法代替.语法并用双引号包裹元素名称，例如$.store["book name"]。 |
返回值类型
JSON 格式的 string 类型。
示例
获取 apple.instant 字段中 epochSecond 的值。
字段样例
apple.instant:{"epochSecond":1635905306,"nanoOfSecond":63001000}
查询和分析语句
* | SELECT json_extract(apple.instant, '$.epochSecond')
查询和分析结果
1635905306
json_extract_scalar 函数
json_extract_scalar 函数用于从 JSON 对象或 JSON 数组中提取一组标量值（字符串、整数或布尔值）。
语法
json_extract_scalar(x, json_path)
参数说明
参数 | 说明 |
x | 参数值为 JSON 数组。 |
json_path | 注意： 不支持需要遍历数组元素的 JSON 语法，例如 $.store.book[*].author、$..book[(@.length-1)]、$..book[?(@.price<10)] 等。元素名称包含特殊字符时，使用 []语法代替.语法并用双引号包裹元素名称，例如$.store["book name"]。 |
返回值类型
varchar 类型。
示例
从 apple.instant 字段中获取 epochSecond 字段的值，并将该值转换为 bigint 类型进行求和。
字段样例
apple.instant:{"epochSecond":1635905306,"nanoOfSecond":63001000}
查询和分析语句
* | SELECT sum(cast(json_extract_scalar(apple.instant,'$.epochSecond') AS bigint) )
查询和分析结果
1635905306
json_format 函数
json_format 函数用于将 JSON 类型转化成字符串类型。
语法
json_format(x)
参数说明
参数 | 说明 |
x | 参数值为 JSON 类型。 |
返回值类型
varchar 类型。
示例
将 JSON 数组[1,2,3]转换为字符串。
查询和分析语句
* | SELECT json_format(json_parse('[1, 2, 3]'))
查询和分析结果
[1, 2, 3]
json_parse 函数
json_parse 函数只用于将字符串类型转化成 JSON 类型，判断是否符合 JSON 格式。
语法
json_parse(x)
参数说明
参数 | 说明 |
x | 参数值为字符串。 |
返回值类型
JSON 类型。
示例
将字符串[1, 2, 3]转换为JSON数组。
查询和分析语句
* | SELECT json_parse('[1, 2, 3]')
查询和分析结果
[1, 2, 3]
json_size 函数
json_size 函数用于计算 JSON 对象或 JSON 数组中元素的数量。
语法
json_size(x, json_path)
参数说明
参数 | 说明 |
x | 参数值为 JSON 对象或 JSON 数组。 |
json_path | 注意： 不支持需要遍历数组元素的 JSON 语法，例如 $.store.book[*].author、$..book[(@.length-1)]、$..book[?(@.price<10)]等。元素名称包含特殊字符时，使用 []语法代替.语法并用双引号包裹元素名称，例如$.store["book name"]。 |
返回值类型
bigint 类型。
示例
获取JSON 数组[1,2,3]的长度。
查询和分析语句
* | SELECT json_size(json_parse('[1, 2, 3]'),'$')
查询和分析结果
3
