Partilhar via

Função coalesce

  • Artigo

Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime

Retorna o primeiro argumento não nulo.

Sintaxe

coalesce(expr1 [, ...] )

Argumentos

  • exprN: Qualquer expressão que compartilhe um tipo menos comum em todos os exprN.

Devoluções

O tipo de resultado é o tipo menos comum dos argumentos.

Tem de haver pelo menos um argumento. Ao contrário das funções regulares, em que todos os argumentos são avaliados antes de invocar a função, coalesce avalia os argumentos da esquerda para a direita até que um valor não nulo seja encontrado. Se todos os argumentos forem NULL, o resultado será NULL.

Exemplos

> 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