Поделиться через

Функция coalesce

  • Статья

Область применения: флажок Databricks SQL флажок Databricks Runtime

Возвращает первый аргумент, отличный от 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