描述
生成一个包含指定元素的 json 数组,未传入参数时返回空数组。
语法
JSON_ARRAY([<expression>, ...])
参数
可变参数:
<expression>: 要包含在 JSON 数组中的元素。可以是单个或者多种类型的值,包括NULL。
返回值
JSON: 返回由参数列表组成的 JSON 数组。
使用说明
- JSON_ARRAY 的实现是通过将不同类型的参数通过隐式调用
TO_JSON函数将其转换为 Json 值,所以参数必须是TO_JSON支持的类型 - NULL 会被转换为 Json 的 null, 如果不希望在数组中保留 null 值,可以使用函数
JSON_ARRAY_IGNORE_NULL. - 如果参数类型不被
TO_JSON支持,那么会得到错误,可以先将该参数转换为 String 类型,比如:select JSON_ARRAY(CAST(NOW() as String));NOW() 函数得到的是 DateTime 类型,需要通过 CAST 函数转换为 String 类型
- 如果参数是 Json 字符串并且希望将其作为 Json 对象加入到数组中,应该显式调用
JSON_PARSE函数将其解析为 Json 对象:select JSON_ARRAY(JSON_PARSE('{"key": "value"}'));
示例
-
常规参数
select json_array() as empty_array, json_array(1) v1, json_array(1, 'abc') v2;+-------------+------+-----------+ | empty_array | v1 | v2 | +-------------+------+-----------+ | [] | [1] | [1,"abc"] | +-------------+------+-----------+ -
NULL 参数
select json_array(null) v1, json_array(1, null, 'I am a string') v2;+--------+--------------------------+ | v1 | v2 | +--------+--------------------------+ | [null] | [1,null,"I am a string"] | +--------+--------------------------+ -
不支持的参数类型
select json_array('item1', map(123, 'abc'));ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: to_json(MAP<TINYINT,VARCHAR(3)>) -
Map 类型参数可以先显式转换为 JSON
select json_array(1, cast(map('key', 'value') as json));+--------------------------------------------------+ | json_array(1, cast(map('key', 'value') as json)) | +--------------------------------------------------+ | [1,{"key":"value"}] | +--------------------------------------------------+ -
Json 字符串会以字符串的形式被添加到数组中
select json_array('{"key1": "value", "key2": [1, "I am a string", 3]}');+------------------------------------------------------------------+ | json_array('{"key1": "value", "key2": [1, "I am a string", 3]}') | +------------------------------------------------------------------+ | ["{\"key1\": \"value\", \"key2\": [1, \"I am a string\", 3]}"] | +------------------------------------------------------------------+ -
Json 字符串可以用
json_parse解析之后传入到json_arrayselect json_array(json_parse('{"key1": "value", "key2": [1, "I am a string", 3]}'));+------------------------------------------------------------------------------+ | json_array(json_parse('{"key1": "value", "key2": [1, "I am a string", 3]}')) | +------------------------------------------------------------------------------+ | [{"key1":"value","key2":[1,"I am a string",3]}] | +------------------------------------------------------------------------------+
本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。
