メインコンテンツまでスキップ
バージョン: Latest-3.4

case

CASE は条件式です。WHEN 節の条件が真と評価されると、THEN 節の結果を返します。どの条件も真と評価されない場合、ELSE 節の結果を返します。ELSE が存在しない場合は、NULL が返されます。

構文​

CASE 式には 2 つの形式があります。

  • シンプル CASE
CASE expression
    WHEN expression1 THEN result1
    [WHEN expression2 THEN result2]
    ...
    [WHEN expressionN THEN resultN]
    [ELSE result]
END

この構文では、expression は WHEN 節の各式と比較されます。等しい式が見つかると、THEN 節の結果が返されます。等しい式が見つからない場合、ELSE 節が存在すれば ELSE 節の結果が返されます。

  • 検索 CASE
CASE WHEN condition1 THEN result1
    [WHEN condition2 THEN result2]
    ...
    [WHEN conditionN THEN resultN]
    [ELSE result]
END

この構文では、WHEN 節の各条件が評価され、真となる条件が見つかると、対応する THEN 節の結果が返されます。どの条件も真と評価されない場合、ELSE 節が存在すれば ELSE 節の結果が返されます。

最初の CASE は次のように 2 番目の CASE と等しいです。

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

パラメータ​

  • expressionN: 比較する式。複数の式はデータ型が互換性がある必要があります。

  • conditionN: BOOLEAN 値に評価される条件。

  • resultN はデータ型が互換性がある必要があります。

戻り値​

戻り値は THEN 節内のすべての型の共通の型です。

例​

テーブル 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     |
+--------+------------+

ELSE が指定されていない検索 CASE の使用​

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     |
+--------+------------+

キーワード​

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