coalesce-Funktion
Gilt für:
Databricks SQL Databricks Runtime
Gibt das erste Argument zurück, das ungleich NULL ist.
Syntax
coalesce(expr1 [, ...] )
Argumente
exprN: Jeder Ausdruck, der einen am wenigsten gemeinsamen Typ für alleexprN-Elemente verwendet.
Gibt zurück
Der Ergebnistyp ist der kleinste gemeinsame Typ der Argumente.
Mindestens ein Argument muss angegeben werden.
Im Gegensatz zu regulären Funktionen, bei denen alle Argumente vor dem Aufrufen der Funktion ausgewertet werden, wertet coalesce Argumente von links nach rechts aus, bis ein Wert gefunden wird, der ungleich NULL ist.
Wenn alle Argumente NULL sind, ist das Ergebnis NULL.
Beispiele
> 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