Udostępnij za pośrednictwem

Funkcja coalesce

  • Artykuł

Dotyczy: zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

Zwraca pierwszy argument inny niż null.

Składnia

coalesce(expr1 [, ...] )

Argumenty

Zwraca

Typ wyniku jest najmniej typowym typem argumentów.

Musi istnieć co najmniej jeden argument. W przeciwieństwie do zwykłych funkcji, w których wszystkie argumenty są oceniane przed wywołaniem funkcji, coalesce oblicza argumenty od lewej do prawej do momentu znalezienia wartości innej niż null. Jeśli wszystkie argumenty to NULL, wynik to NULL.

Specjalne zagadnienia dotyczą VARIANT typów. Aby uzyskać szczegółowe informacje, zobacz funkcja isnull.

Przykłady

> 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