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

Apache Doris 中文参考:COALESCE

· 52CE 我爱测

## 描述 返回参数列表中从左到右第一个非空表达式。如果所有参数都为 NULL,则返回 NULL。 ## 语法 ## 参数 ### 必须参数 - 任意类型的表达式。 ### 可变参数 - 函数支持多个可变参数。 ## 返回值 参数列表中第一个非空表达式。如果所有参数都为 NULL,则返回 NULL。 ## 使用说明 1. 多个参数的类型应该尽量统一。 2. 如果多个参数的类型不一致,会尝试转换为同一类型,转换规则参考:类型转换 3. 目

描述

返回参数列表中从左到右第一个非空表达式。如果所有参数都为 NULL,则返回 NULL。

语法

COALESCE( <expr1> [ , ... , <exprN> ] )

参数

必须参数

  • <expr1> 任意类型的表达式。

可变参数

  • COALESCE 函数支持多个可变参数。

返回值

参数列表中第一个非空表达式。如果所有参数都为 NULL,则返回 NULL。

使用说明

  1. 多个参数的类型应该尽量统一。
  2. 如果多个参数的类型不一致,会尝试转换为同一类型,转换规则参考:类型转换
  3. 目前参数仅支持部分类型:
    • 字符串类型(String/VARCHAR/CHAR)
    • 布尔类型(Boolean)
    • 数字类型(TinyInt、SmallInt、Int、BigInt、LargeInt、Float、Double、Decimal)
    • 日期类型(Date、DateTime、TimestampNs)
    • 位图类型(Bitmap)
    • 半结构化类型(JSON、Array、MAP、Struct)

示例

  1. 参数类型转换

    select coalesce(null, 2, 1.234);
    
    +--------------------------+
    | coalesce(null, 2, 1.234) |
    +--------------------------+
    |                    2.000 |
    +--------------------------+
    

    因为第三个参数 "1.234" 是 Deciaml 类型, 参数 "2" 被转换为了 Decimal 类型。

  2. 所有参数都是 NULL

    select coalesce(null, null, null);
    
    +----------------------------+
    | coalesce(null, null, null) |
    +----------------------------+
    | NULL                       |
    +----------------------------+
    

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

资料来源与适用范围

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

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

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