NULLIF

설명

두 입력 값이 같으면 NULL을 반환하고, 그렇지 않으면 첫 번째 입력 값을 반환합니다. 이 함수는 다음 CASE WHEN 표현식과 동일합니다:

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

구문

NULLIF(<expr1>, <expr2>)

매개변수

• <expr1>: 비교할 첫 번째 입력 값입니다. 지원되는 타입은 아래 사용 시 참고 사항을 참조하세요.
• <expr2>: 첫 번째 입력 값과 비교할 두 번째 값입니다. 지원되는 타입은 아래 사용 시 참고 사항을 참조하세요.

사용 시 참고 사항

매개변수에서 지원하는 타입:

1. Boolean
2. 숫자 타입 (TinyInt, SmallInt, Int, BigInt, LargeInt, Float, Double, Decimal)
3. 날짜 타입 (Date, DateTime, Time)
4. 문자열 타입 (String, VARCHAR, CHAR)

반환 값

• <expr1>과 <expr2>가 같으면 NULL을 반환합니다.
• 그렇지 않으면 <expr1>의 값을 반환합니다.

예제

1. 예제 1

   SELECT NULLIF(1, 1);

   +--------------+
   | NULLIF(1, 1) |
   +--------------+
   |         NULL |
   +--------------+
2. 예제 2

   SELECT NULLIF(1, 0);

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