Fonction coalesce

  • Article

S’applique à : case marquée oui Databricks SQL case marquée oui Databricks Runtime

Retourne le premier argument non null.

Syntaxe

coalesce(expr1 [, ...] )

Arguments

Retours

Le type du résultat est le type le moins courant des arguments.

Il doit y avoir au moins un argument. Contrairement aux fonctions régulières où tous les arguments sont évalués avant d’appeler la fonction, coalesce évalue les arguments de gauche à droite jusqu’à ce qu’une valeur non null soit trouvée. Si tous les arguments ont la valeur NULL , le résultat est NULL.

Les considérations spéciales s’appliquent aux types VARIANT. Pour plus d’informations, consultez la fonction isnull.

Exemples

> 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