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

StarRocks 中文参考:case

· 52CE 我爱测

# case CASE 是一种条件表达式,有两种写法:简单 CASE 表达式和搜索 CASE 表达式。 - 在简单 CASE 表达式中,将一个表达式 与一个值比较。如果能找到匹配项,则返回 THEN 中的结果。如果未找到匹配项,则返回 ELSE 中的结果。如果未指定 ELSE,则返回 NULL。 - 在搜索 CASE 表达式中,会判断布尔表达式 的结果是否为 TRUE。为 TRUE 的话返回 THEN 中的结果,否则返回 ELSE 中的

case

CASE 是一种条件表达式,有两种写法:简单 CASE 表达式和搜索 CASE 表达式。

  • 在简单 CASE 表达式中,将一个表达式 expression 与一个值比较。如果能找到匹配项,则返回 THEN 中的结果。如果未找到匹配项,则返回 ELSE 中的结果。如果未指定 ELSE,则返回 NULL。

  • 在搜索 CASE 表达式中,会判断布尔表达式 condition 的结果是否为 TRUE。为 TRUE 的话返回 THEN 中的结果,否则返回 ELSE 中的结果。如果未指定 ELSE,则返回 NULL。

语法

  • 简单 CASE 表达式
CASE expression
    WHEN expression1 THEN result1
    [WHEN expression2 THEN result2]
    ...
    [WHEN expressionN THEN resultN]
    [ELSE result]
END
  • 搜索 CASE 表达式
CASE WHEN condition1 THEN result1
    [WHEN condition2 THEN result2]
    ...
    [WHEN conditionN THEN resultN]
    [ELSE result]
END

简单 CASE 表达式也可以用下面的搜索 CASE 表达式来表达,功能上对等。

CASE WHEN expression = expression1 THEN result1
    [WHEN expression = expression2 THEN result2]
    ...
    [WHEN expression = expressionN THEN resultN]
    [ELSE result]
END

参数说明

  • expressionN:要进行对比的表达式。多个表达式必须在数据类型上兼容。

  • conditionN:要进行判断的条件。

  • resultN:返回的结果。多个结果必须在数据类型上兼容。

返回值

返回值的类型是所有 THEN 子句结果中的公共类型 (common type)。

示例

假设有表 test_case,数据如下:

CREATE TABLE test_case(
    name          STRING,
    gender         INT,
    ) DISTRIBUTED BY HASH(name);

INSERT INTO test_case VALUES
    ("Andy",1),
    ("Jules",0),
    ("Angel",-1),
    ("Sam",null);

SELECT * FROM test_case;
+-------+--------+
| name  | gender |
+-------+--------+
| Angel |     -1 |
| Andy  |      1 |
| Sam   |   NULL |
| Jules |      0 |
+-------+--------+-------+

简单 CASE 表达式

  • 指定了 ELSE,找不到匹配项时返回 ELSE 中的结果。
mysql> select gender, case gender 
                    when 1 then 'male'
                    when 0 then 'female'
                    else 'error'
               end gender_str
from test_case;
+--------+------------+
| gender | gender_str |
+--------+------------+
|   NULL | error      |
|      0 | female     |
|      1 | male       |
|     -1 | error      |
+--------+------------+
  • 未指定 ELSE,找不到匹配项时返回 NULL。
select gender, case gender
                    when 1 then 'male'
                    when 0 then 'female'
               end gender_str
from test_case;
+--------+------------+
| gender | gender_str |
+--------+------------+
|      1 | male       |
|     -1 | NULL       |
|   NULL | NULL       |
|      0 | female     |
+--------+------------+

搜索 CASE 表达式(指定了 ELSE)

mysql> select gender, case when gender = 1 then 'male'
                           when gender = 0 then 'female'
                      end gender_str
from test_case;
+--------+------------+
| gender | gender_str |
+--------+------------+
|   NULL | NULL       |
|     -1 | NULL       |
|      1 | male       |
|      0 | female     |
+--------+------------+

Keywords

case when, case, case_when, case...when

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

资料来源与适用范围

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

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

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