Condividi tramite

Funzione coalesce

  • Articolo

Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime

Restituisce il primo argomento non Null.

Sintassi

coalesce(expr1 [, ...] )

Argomenti

  • exprN: qualsiasi espressione che condivide un tipo meno comune in tutto exprN.

Valori restituiti

Il tipo di risultato è il tipo meno comune degli argomenti.

Deve essere presente almeno un argomento. A differenza delle funzioni regolari in cui tutti gli argomenti vengono valutati prima di richiamare la funzione, coalesce valuta gli argomenti da sinistra a destra fino a quando non viene trovato un valore non Null. Se tutti gli argomenti sono NULL, il risultato è NULL.

Considerazioni speciali si applicano ai VARIANT tipi. Per informazioni dettagliate, vedere la funzione isnull.

Esempi

> 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