NULLIF

デスクリプション

2つの入力値が等しい場合はNULLを返し、そうでなければ最初の入力値を返します。この関数は以下のCASE WHEN式と同等です：

CASE
    WHEN <expr1> = <expr2> THEN NULL
    ELSE <expr1>
END

構文

NULLIF(<expr1>, <expr2>)

パラメータ

Parameter	デスクリプション
<expr1>	比較する最初の入力値。
<expr2>	最初の値と比較する2番目の入力値。

Return Value

• <expr1>が<expr2>と等しい場合はNULLを返します。
• そうでない場合は、<expr1>の値を返します。

Examples

SELECT NULLIF(1, 1);

+--------------+
| NULLIF(1, 1) |
+--------------+
|         NULL |
+--------------+

SELECT NULLIF(1, 0);

+--------------+
| NULLIF(1, 0) |
+--------------+
|            1 |
+--------------+