Freigeben über

coalesce-Funktion

  • Artikel

Gilt für: durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Gibt das erste Argument zurück, das ungleich NULL ist.

Syntax

coalesce(expr1 [, ...] )

Argumente

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.

Bei VARIANT-Typen müssen Sie mehr beachten. Weitere Informationen finden Sie unter isnull-Funktion.

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