Função coalesce

Aplica-se a: SQL do Databricks Runtime do Databricks

Retorna o primeiro argumento não nulo.

Sintaxe

coalesce(expr1 [, ...] )

Argumentos

• exprN: qualquer expressão que compartilha um tipo menos comum entre todos exprN.

Retornos

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

Precisa haver, no mínimo, um arquivo. 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 seja encontrado um valor não nulo. Se todos os argumentos forem NULL, o resultado será NULL.

Considerações especiais se aplicam aos tipos VARIANT. Consulte isnull a função para obter detalhes.

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

Relacionados

• nvl função
• nvl2 função
• Regras de tipo de dados SQL