Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

COALESCE

Retorna o primeiro argumento que não é NULL em uma série de dois ou mais argumentos; pode ser usada para substituir um valor NULL por um valor padrão.

A função COALESCE equivale à função NVL do Oracle ou à função IFNULL do MySQL.

Veja também:
[SELECT] [IFNULL] [NULLIF]


Sintaxe​

SELECT COALESCE(expression1, expression2 [, ..]) FROM <multipartIdentifier>;

Argumentos​

expression
Duas ou mais expressões de qualquer tipo de dados que resultam em um valor NULL ou não NULL.

Se todos os argumentos expression forem NULL, a função COALESCE retorna NULL.

Valor(es) retornado(s)​

Retorna o primeiro valor não NULL da série de argumentos expression.


Exemplos​

Substituir um valor NULL por um valor padrão​

SELECT name, coalesce(website, cors, 'not hosting shared resources') AS website_or_cors_config
FROM google.storage.buckets where project = 'stackql';

Para obter mais informações, consulte https://www.sqlite.org/lang_corefunc.html#coalesce