Funktionen coalesce

Gäller för: Databricks SQL Databricks Runtime

Returnerar det första argumentet som inte är null.

Syntax

coalesce(expr1 [, ...] )

Argumenten

• exprN: Alla uttryck som delar en minsta gemensamma typ över alla exprN.

Returer

Resultattypen är den minst vanliga typen av argument.

Det måste finnas minst ett argument. Till skillnad från vanliga funktioner där alla argument utvärderas innan funktionen anropas utvärderar coalesce argument från vänster till höger tills ett värde som inte är null hittas. Om alla argument är NULL är resultatet NULL.

Särskilda överväganden gäller för VARIANT typer. Mer information finns i funktionen isnull.

Exempel

> 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

Relaterade

• nvl-funktion
• nvl2-funktion
• REGLER FÖR SQL-datatyp