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

Apache Doris 中文参考:JSON_OBJECT

· 52CE 我爱测

当向该函数传入通配符时,可以用表的名称或别名对通配符进行限定。例如,若要传入名为 mytable 的表中的所有列,请按如下方式指定:

描述

生成一个包含指定 Key-Value 对的 json object, 当 Key 值为 NULL 或者传入参数为奇数个时,返回异常错误。

语法

JSON_OBJECT (<key>, <value>[, <key>, <value>, ...])
JSON_OBJECT(*)

参数

  • <key> String 类型

  • <value> 多种类型,Doris 会自动将非 Json 类型的参数通过 TO_JSON 函数将其转换为 Json 类型。 :* 当使用星号(通配符)调用时,会使用指定数据中的引用名成作为键(key),对应的值作为值(value),从而构造出一个 JSON 类型的值。

    当向该函数传入通配符时,可以用表的名称或别名对通配符进行限定。例如,若要传入名为 mytable 的表中的所有列,请按如下方式指定:

    (mytable.*)
    

注意事项

  • 参数数量必须为偶数个,可以是 0 个参数(返回一个空的 Json 对象)。
  • 按照惯例,参数列表由交替的键和值组成。
  • Key 按照JSON 定义强制转换为文本。
  • 如果传入的 Key 为 NULL,返回异常错误。
  • Value 参数按照可以转换为 json 的方式进行转换,必须是 TO_JSON 支持的类型。
  • 如果传入的 Value 为 NULL,返回的 json object 中该 Key-Value 对的 Value 值为 Json 的 null 值。
  • 如果支持其他类型的作为 value,可以使用 CAST 将其转换为 Json/String.
  • Doris 目前没有对 Json 对象去重,也就是允许重复的 key。但是重复 key 可能会引起意外的结果:
    1. 其他系统中可能会丢掉重复的 key 对应的值,或者报错。
    2. JSON_EXTRACT 返回的结果不确定。

返回值

JSON: 返回由参数列表组成的 JSON 对象。

示例

  1. 没有参数的情况

    select json_object();
    
    +---------------+
    | json_object() |
    +---------------+
    | {}            |
    +---------------+
    
  2. 不支持的 value 类型

    select json_object('time',curtime());
    
    ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: to_json(TIMEV2(0))
    

    可以通过 cast 将其转换为 String

    select json_object('time', cast(curtime() as string));
    
    +------------------------------------------------+
    | json_object('time', cast(curtime() as string)) |
    +------------------------------------------------+
    | {"time":"17:09:42"}                            |
    +------------------------------------------------+
    
  3. 非 String 类型的 key 会被转换为 String

    SELECT json_object(123, 456);
    
    +-----------------------+
    | json_object(123, 456) |
    +-----------------------+
    | {"123":456}           |
    +-----------------------+
    
  4. Null 不能作为 key

    select json_object(null, 456);
    
    ERROR 1105 (HY000): errCode = 2, detailMessage = json_object key can't be NULL: json_object(NULL, 456)
    

    Null 可以做为 value

    select json_object('key', null);
    
    +--------------------------+
    | json_object('key', null) |
    +--------------------------+
    | {"key":null}             |
    +--------------------------+
    
  5. Json 字符串可以通过 JSON_PARSE 解析为 Json 对象后传入到 JSON_OBJECT

    select json_object(123, json_parse('{"key": "value"}'));
    
    +--------------------------------------------------+
    | json_object(123, json_parse('{"key": "value"}')) |
    +--------------------------------------------------+
    | {"123":{"key":"value"}}                          |
    +--------------------------------------------------+
    

    否则将作为字符串处理

    select json_object(123,'{"key": "value"}');
    
    +-------------------------------------+
    | json_object(123,'{"key": "value"}') |
    +-------------------------------------+
    | {"123":"{\"key\": \"value\"}"}      |
    +-------------------------------------+
    
  6. TO_JSON 不支持的类型

    select json_object('key', map('abc', 'efg'));
    
    ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: to_json(MAP<VARCHAR(3),VARCHAR(3)>)
    

    可以通过 CAST 语句将其转换为 Json 再传入:

    select json_object('key', cast(map('abc', 'efg') as json));
    
    +-----------------------------------------------------+
    | json_object('key', cast(map('abc', 'efg') as json)) |
    +-----------------------------------------------------+
    | {"key":{"abc":"efg"}}                               |
    +-----------------------------------------------------+
    
  7. 重复 key 的情况

    select
        json_object('key', 123, 'key', 4556) v1
        , jsonb_extract(json_object('key', 123, 'key', 4556), '$.key') v2
        , jsonb_extract(json_object('key', 123, 'key', 4556), '$.*') v3;
    
    +------------------------+------+------------+
    | v1                     | v2   | v3         |
    +------------------------+------+------------+
    | {"key":123,"key":4556} | 123  | [123,4556] |
    +------------------------+------+------------+
    

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

资料来源与适用范围

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

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

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