Compartir vía

Función coalesce

  • Artículo

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

Devuelve el primer argumento que no es NULL.

Sintaxis

coalesce(expr1 [, ...] )

Argumentos

Devoluciones

El tipo del resultado es el tipo menos común de los argumentos.

Debe haber al menos un argumento. A diferencia de las funciones normales en las que se evalúan todos los argumentos antes de invocar la función, coalesce evalúa los argumentos de izquierda a derecha hasta que se encuentra un valor distinto de NULL. Si todos los argumentos son NULL, el resultado es NULL.

Se aplican consideraciones especiales a los tipos de VARIANT. Consulte Función isnull para más información.

Ejemplos

> 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