Compartilhar via

Função coalesce

  • Artigo

Aplica-se a: marca de seleção positiva SQL do Databricks marca de seleção positiva 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. Confira a função isnull 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