Sdílet prostřednictvím

Funkce coalesce

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime

Vrátí první argument, který není null.

Syntaxe

coalesce(expr1 [, ...] )

Argumenty

Návraty

Typ výsledku je nejmenším běžným typem argumentů.

Musí existovat alespoň jeden argument. Na rozdíl od běžných funkcí, kde jsou před vyvoláním funkce vyhodnoceny všechny argumenty, vyhodnotí argumenty zleva doprava, coalesce dokud se nenajde hodnota, která není null. Pokud jsou NULLvšechny argumenty , výsledek je NULL.

Zvláštní aspekty se vztahují na VARIANT typy. Podrobnosti najdete v funkci isnull.

Příklady

> 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