Função SQL COALESCE

O que é o COALESCE() função?

Coalesce retorna o primeiro valor não nulo em uma lista. Se todos os valores da lista forem NULL, a função retornará null. 

Quando usar COALESCE()?

Essa função é útil para combinar os valores de várias colunas em uma só. 

Por exemplo, uma tabela chamada usuários contém valores de work_email e personal_email dos usuários.

Usando a função COALESCE(), podemos criar uma coluna chamada e-mail, que mostra o endereço work_email do usuário se ele não for nulo. Caso contrário, ele mostra personal_email.

COALESCE() syntax

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

A função COALESCE() recebe pelo menos um valor (value_1). Ele retornará o primeiro valor da lista que não for nulo. 

Por exemplo, primeiro ele verificará 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() exemplos

Exemplo 1: COALESCE() uma coluna com uma constante

Considere a tabela countries com uma lista de países e seus dias nacionais. Alguns dias nacionais estão vazios. Para linhas com dias nacionais vazios, podemos preenchê-los com o valor 'Unknown'. 

A consulta e o resultado são os seguintes. 

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

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

Exemplo 2: COALESCE() 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 e o resultado são os seguintes.

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

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: COALESCE() três colunas ou mais

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 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

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

Requisitos técnicos

COALESCE() funciona 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.

Veja também

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

Saiba mais sobre o SQL

• Como aprender SQL
• Tutorial de SQL para iniciantes
• Folhas de dicas de SQL