Функция coalesce

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

Возвращает первый аргумент, отличный от NULL.

Синтаксис

coalesce(expr1 [, ...] )

Аргументы

• exprN: любое выражение, которое обладает минимально общим типом среди всех exprN.

Возвраты

Тип результата является наименее распространенным типом аргументов.

Аргументов должно быть не меньше одного. В отличие от обычных функций, в которых все аргументы оцениваются перед вызовом функции, coalesce вычисляет аргументы слева направо до тех пор, пока не будет найдено ненулевое значение. Если все аргументы имеют значение 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

Связанные

• nvl функция
• nvl2 функция
• Правила типа данных SQL