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

Apache Doris 中文参考:JSON_ARRAY

· 52CE 我爱测

## 描述 生成一个包含指定元素的 json 数组,未传入参数时返回空数组。 ## 语法 ## 参数 ### 可变参数: - : 要包含在 JSON 数组中的元素。可以是单个或者多种类型的值,包括NULL。 ## 返回值 : 返回由参数列表组成的 JSON 数组。 ## 使用说明 - JSON_ARRAY 的实现是通过将不同类型的参数通过隐式调用 函数将其转换为 Json 值,所以参数必须是 支持的类型 - NULL 会被转换为 Jso

描述

生成一个包含指定元素的 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"}'));
    

示例

  1. 常规参数

    select json_array() as empty_array, json_array(1) v1, json_array(1, 'abc') v2;
    
    +-------------+------+-----------+
    | empty_array | v1   | v2        |
    +-------------+------+-----------+
    | []          | [1]  | [1,"abc"] |
    +-------------+------+-----------+
    
  2. NULL 参数

    select json_array(null) v1, json_array(1, null, 'I am a string') v2;
    
    +--------+--------------------------+
    | v1     | v2                       |
    +--------+--------------------------+
    | [null] | [1,null,"I am a string"] |
    +--------+--------------------------+
    
  3. 不支持的参数类型

    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)>)
    
  4. Map 类型参数可以先显式转换为 JSON

    select json_array(1, cast(map('key', 'value') as json));
    
    +--------------------------------------------------+
    | json_array(1, cast(map('key', 'value') as json)) |
    +--------------------------------------------------+
    | [1,{"key":"value"}]                              |
    +--------------------------------------------------+
    
  5. 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]}"]   |
    +------------------------------------------------------------------+
    
  6. Json 字符串可以用 json_parse 解析之后传入到 json_array

    select 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 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

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

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

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