다음을 통해 공유

coalesce 기능

  • 아티클

적용 대상: 예(예)로 표시된 확인 Databricks SQL 예(예)로 표시된 확인 Databricks 런타임

Null이 아닌 첫 번째 인수를 반환합니다.

구문

coalesce(expr1 [, ...] )

인수

  • exprN: 모든 에서 가장 일반적인 형식을 공유하는 식exprN입니다.

반품

결과 형식은 인수의 최소 공통 형식입니다.

적어도 한 개의 인수가 있어야 합니다. 함수를 호출하기 전에 모든 인수를 평가하는 일반 함수와 달리 coalesce는 Null이 아닌 값을 찾을 때까지 인수를 왼쪽에서 오른쪽으로 계산합니다. 모든 인수가 NULL이면 결과는 NULL입니다.

형식에는 특별한 고려 사항이 적용됩니다 VARIANT . 자세한 내용은 isnull 함수를 참조하세요.

예제

> SELECT coalesce(NULL, 1, NULL);
 1

-- The following example raises a runtime error because the second argument is evaluated.
>  SELECT coalesce(NULL, 5 / 0);
 Error: DIVISION_BY_ZERO

-- The following example raises no runtime error because the second argument is not evaluated.
> SELECT coalesce(2, 5 / 0);
 2

> SELECT coalesce(NULL, 'hello');
 hello