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

Apache Doris 中文参考:TO_JSON

· 52CE 我爱测

函数将 Doris 内部数据类型转换为 JSONB 类型。该函数允许将兼容的 Doris 数据类型转换为 JSON 表示形式,并且在转换过程中不会丢失精度。

描述

TO_JSON 函数将 Doris 内部数据类型转换为 JSONB 类型。该函数允许将兼容的 Doris 数据类型转换为 JSON 表示形式,并且在转换过程中不会丢失精度。

语法

TO_JSON(value)

参数

value - 要转换为 JSONB 类型的值。

以下类型都有一一对应的 JSONB 类型,可以直接转换成 JSONB:

  • 数字类型:TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、DECIMAL
  • 布尔类型:BOOLEAN
  • 字符串类型:STRING、VARCHAR、CHAR
  • 复杂类型:ARRAY、STRUCT

此外,函数还支持以下类型的转换:

  • 日期类型:DATETIME、TIMESTAMP_NS、DATE、TIME
  • IP类型:IPV4、IPV6
  • 复杂类型:MAP

DATETIME、TIMESTAMP_NS、DATE、TIME、IPV4 和 IPV6 在 JSONB 中没有对应的原生类型,因此会转换为 JSONB 字符串。 对于 MAP 类型,会被转换成 JSONB 的 Object 类型。其中 Map 的键必须为STRING类型,这是因为JSON的标准规定,Object的Key只能为字符串。

返回值

返回 JSONB 类型的值。

当输入的 value 为 SQL NULL 时,函数返回 SQL NULL(不是 JSON null 值)。当 NULL 值出现在数组或结构体内部时,它们会被转换为 JSON null 值。

示例

基本标量值

SELECT to_json(1), to_json(3.14), to_json("12345");
+------------+---------------+------------------+
| to_json(1) | to_json(3.14) | to_json("12345") |
+------------+---------------+------------------+
| 1          | 3.14          | "12345"          |
+------------+---------------+------------------+

日期类型

SELECT 
     to_json(cast('2020-01-01' as date)) , 
     to_json(cast('2020-01-01 12:00:00' as datetime)),
     to_json(cast('2020-01-01 12:00:00.123' as datetime(3))),
     to_json(cast('2020-01-01 12:00:00.123456' as datetime(6))),
     to_json(cast('8:23:45' as time));
+-------------------------------------+--------------------------------------------------+---------------------------------------------------------+------------------------------------------------------------+----------------------------------+
| to_json(cast('2020-01-01' as date)) | to_json(cast('2020-01-01 12:00:00' as datetime)) | to_json(cast('2020-01-01 12:00:00.123' as datetime(3))) | to_json(cast('2020-01-01 12:00:00.123456' as datetime(6))) | to_json(cast('8:23:45' as time)) |
+-------------------------------------+--------------------------------------------------+---------------------------------------------------------+------------------------------------------------------------+----------------------------------+
| "2020-01-01"                        | "2020-01-01 12:00:00"                            | "2020-01-01 12:00:00.123"                               | "2020-01-01 12:00:00.123456"                               | "08:23:45"                       |
+-------------------------------------+--------------------------------------------------+---------------------------------------------------------+------------------------------------------------------------+----------------------------------+

IP类型

SELECT 
     to_json(cast('192.168.0.1' as ipv4)) , 
     to_json(cast('2001:0db8:85a3:0000:0000:8a2e:0370:7334' as ipv6));
+--------------------------------------+------------------------------------------------------------------+
| to_json(cast('192.168.0.1' as ipv4)) | to_json(cast('2001:0db8:85a3:0000:0000:8a2e:0370:7334' as ipv6)) |
+--------------------------------------+------------------------------------------------------------------+
| "192.168.0.1"                        | "2001:db8:85a3::8a2e:370:7334"                                   |
+--------------------------------------+------------------------------------------------------------------+

数组转换

SELECT to_json(array(array(1,2,3),array(4,5,6)));
+-------------------------------------------+
| to_json(array(array(1,2,3),array(4,5,6))) |
+-------------------------------------------+
| [[1,2,3],[4,5,6]]                         |
+-------------------------------------------+
SELECT to_json(array(12,34,null));
+----------------------------+
| to_json(array(12,34,null)) |
+----------------------------+
| [12,34,null]               |
+----------------------------+

访问转换后 JSON 中的数组元素

SELECT json_extract(to_json(array(array(1,2,3),array(4,5,6))), '$.[1].[2]');
+----------------------------------------------------------------------+
| json_extract(to_json(array(array(1,2,3),array(4,5,6))), '$.[1].[2]') |
+----------------------------------------------------------------------+
| 6                                                                    |
+----------------------------------------------------------------------+

结构体转换

SELECT to_json(struct(123,array(4,5,6),"789"));
+------------------------------------------+
| to_json(struct(123,array(4,5,6),"789"))  |
+------------------------------------------+
| {"col1":123,"col2":[4,5,6],"col3":"789"} |
+------------------------------------------+

访问转换后 JSON 中的对象属性

SELECT json_extract(to_json(struct(123,array(4,5,6),"789")),"$.col2");
+----------------------------------------------------------------+
| json_extract(to_json(struct(123,array(4,5,6),"789")),"$.col2") |
+----------------------------------------------------------------+
| [4,5,6]                                                        |
+----------------------------------------------------------------+

MAP转换

SELECT to_json(map(1,2));  
to_json only support map with string-like key type
SELECT to_json(map("1",2,"abc",3));  
+-----------------------------+
| to_json(map("1",2,"abc",3)) |
+-----------------------------+
| {"1":2,"abc":3}             |
+-----------------------------+

处理 NULL 值

-- SQL NULL 作为输入返回 SQL NULL
SELECT to_json(null);
+---------------+
| to_json(null) |
+---------------+
| NULL          |
+---------------+
-- 数组内的 NULL 值转换为 JSON null 值
SELECT to_json(array(12,34,null));
+----------------------------+
| to_json(array(12,34,null)) |
+----------------------------+
| [12,34,null]               |
+----------------------------+

不支持的 Doris 类型

SELECT to_json(makedate(2025,5));
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: to_json(DATE)
-- 可以先转换成 string 再去执行 to_json
SELECT to_json(cast(makedate(2025,5) as string));
+-------------------------------------------+
| to_json(cast(makedate(2025,5) as string)) |
+-------------------------------------------+
| "2025-01-05"                              |
+-------------------------------------------+

注意事项

  1. 某些类型没有直接的 JSON 映射(如 DATE 类型)。对于这些类型,需要先将其转换为 STRING 类型,然后再使用 TO_JSON。

  2. 使用 TO_JSON 将 Doris 内部类型转换为 JSONB 类型时不会出现精度损失,这与通过文本表示进行转换不同。

  3. Doris 中的 JSONB 对象默认大小限制为 1,048,576 字节(1 MB),可通过 BE 配置 string_type_length_soft_limit_bytes 参数调整,最大可调整至 2,147,483,643 字节(约 2 GB)。

  4. Doris JSON 类型的对象中,键的长度不能超过 255 个字节。

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

资料来源与适用范围

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

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

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