Como usar a função COALESCE() no SQL (com exemplos)

Sintaxe de COALESCE()

COALESCE(value_1, value_2, ...., value_n)

A função COALESCE() recebe pelo menos um valor (value_1). Ele retornará o primeiro valor não nulo da lista, da esquerda para a direita.

Por exemplo, ele verificará primeiro se value_1 é nulo. Caso contrário, ele retorna value_1. Caso contrário, ele verifica se value_2 é nulo. O processo continua até que a lista esteja completa. 

COALESCE() pode ser usado com colunas, expressões ou constantes.

Exemplos práticos de COALESCE()

Exemplo 1: Substituição de null por uma constante

Considere a tabela countries com uma lista de países e seus dias nacionais. Alguns valores de dias nacionais são nulos. COALESCE() preenche os valores ausentes em national_day com a string constante 'Unknown'.

SELECT
   country_id,
   name, 
   national_day,
   COALESCE(national_day, 'Unknown') AS national_day_coalesced
FROM countries
ORDER BY country_id

Os resultados são os seguintes:

Observe como o valor null em national_day é substituído por uma constante Unknown. 

Exemplo 2: Escolher entre duas colunas

Temos uma tabela chamada products. Ele contém o nome do produto e sua descrição. Algumas descrições são muito longas (mais de 60 caracteres). Nesse caso, substituímos a descrição pelo nome do produto.

A consulta a seguir usa CASE para converter descrições longas em NULL e, em seguida, usa COALESCE() para retornar ao nome do produto.

SELECT DISTINCT
   product_name,
   description,
   COALESCE(
      CASE WHEN 
         LENGTH(description) >= 60 
         THEN NULL 
         ELSE description 
         END, 
      product_name) product_name_or_description
FROM products

Os resultados são os seguintes:

Observe como a coluna product_name_or_description exibe o product_name se o description for longo. Caso contrário, ele exibe o endereço description.

Exemplo 3: Lógica de fallback com várias colunas

Podemos levar o exemplo 2 um passo adiante. Suponha que existam atualmente dois requisitos:

• Se o comprimento do description for menor que 60, exiba o description.
• Caso contrário, verifique se o comprimento do endereço product_name é menor que 20. Em caso afirmativo, exibimos o endereço product_name.
• Caso contrário, exiba product.

SELECT DISTINCT
   product_name,
   description,
   COALESCE(
      CASE 
         WHEN LENGTH(description) > 50
         THEN NULL
         ELSE description
      END,
   CASE 
      WHEN LENGTH(product_name) > 14
      THEN NULL
      ELSE product_name
   END,
'product') AS product_name_or_description
FROM products
ORDER BY product_name

Os resultados são os seguintes:

Observe como a coluna product_name_or_description exibe o product_name ou o description, dependendo dos comprimentos do product_name ou do description.

Mecanismos SQL compatíveis

COALESCE() você trabalha no SQL Server (a partir de 2008), no banco de dados SQL do Azure, no Azure SQL Data Warehouse, no Parallel Data Warehouse, no BigQuery e no Amazon RedShift.

Funções SQL relacionadas

• Função SQL FORMAT()
• Função SQL DATEDIFF()
• Função SQL INSERT INTO
• Função SQL COUNT()

Considerações finais

A função COALESCE() é uma ferramenta versátil para lidar com valores nulos e simplificar suas consultas SQL. Se você estiver substituindo dados ausentes por padrões ou combinando várias colunas em uma, o site COALESCE() ajuda a manter sua lógica limpa e legível.

Você está pronto para aprofundar suas habilidades em SQL? Confira esses cursos para iniciantes e para impulsionar a carreira no DataCamp:

• Introdução ao SQL

• SQL intermediário

• Programa de carreira de fundamentos de SQL