Delen via


coalesce-functie

Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime

Retourneert het eerste niet-null-argument.

Syntaxis

coalesce(expr1 [, ...] )

Argumenten

Retouren

Het resultaattype is het minst voorkomende type van de argumenten.

Er moet ten minste één argument zijn. In tegenstelling tot reguliere functies waarbij alle argumenten worden geëvalueerd voordat u de functie aanroept, coalesce evalueert u argumenten van links naar rechts totdat een niet-null-waarde wordt gevonden. Als alle argumenten zijn NULL, is NULLhet resultaat .

Speciale overwegingen zijn van toepassing op VARIANT typen. Zie de functie isnull voor meer informatie.

Voorbeelden

> 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