跳到主要内容
版本:Stable-3.1

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