본문으로 건너뛰기
최종 수정: 에

COALESCE

설명​

인수 목록을 왼쪽에서 오른쪽으로 평가하여 NULL이 아닌 첫 번째 표현식을 반환합니다. 모든 인수가 NULL이면 NULL을 반환합니다.

구문​

COALESCE( <expr1> [ , ... , <exprN> ] )

매개변수​

필수 매개변수​

  • <expr1>: 임의의 타입을 갖는 표현식입니다.

가변 매개변수​

  • COALESCE 함수는 여러 개의 가변 매개변수를 지원합니다.

반환 값​

인수 목록에서 NULL이 아닌 첫 번째 표현식을 반환합니다. 모든 인수가 NULL이면 NULL을 반환합니다.

사용 시 참고 사항​

  1. 여러 인수의 타입은 가능한 한 동일하게 지정해야 합니다.
  2. 여러 인수의 타입이 서로 다르면 함수는 이를 동일한 타입으로 변환하려고 시도합니다. 변환 규칙은 타입 변환을 참조하세요.
  3. 현재 인수로 지원되는 타입은 다음과 같습니다.
    • 문자열 타입 (String/VARCHAR/CHAR)
    • Boolean 타입 (Boolean)
    • 숫자 타입 (TinyInt, SmallInt, Int, BigInt, LargeInt, Float, Double, Decimal)
    • 날짜 타입 (Date, DateTime)
    • Bitmap 타입 (Bitmap)
    • 반정형 타입 (JSON, Array, MAP, Struct)

예제​

  1. 인수 타입 변환

    select coalesce(null, 2, 1.234);
    +--------------------------+
    | coalesce(null, 2, 1.234) |
    +--------------------------+
    |                    2.000 |
    +--------------------------+

    세 번째 인수인 "1.234"가 Decimal 타입이므로 인수 "2"가 Decimal 타입으로 변환됩니다.

  2. 모든 인수가 NULL인 경우

    select coalesce(null, null, null);
    +----------------------------+
    | coalesce(null, null, null) |
    +----------------------------+
    | NULL                       |
    +----------------------------+
Report issue