Tratando NULL em cálculos com COALESCE()

Hoje a gente vai se aprofundar mais no assunto de tratamento de NULL e conhecer uma função super útil — COALESCE(). Essa função deixa a vida muito mais fácil quando você precisa lidar com valores NULL nos seus dados.

Bora ver um exemplo: imagina que você tem uma tabela com dados dos funcionários, mas alguns deles não têm informação de salário. O que rola se a gente tentar aumentar todos os salários? Nada de bom. Não dá pra fazer operações com NULL. E se a gente quiser trocar os salários NULL por, sei lá, 0? É aí que entra a COALESCE().

COALESCE() é uma função que retorna o primeiro valor que não é NULL da lista de argumentos que você passar. Se tudo na lista for NULL, ela devolve NULL. Em outras palavras, ela fala: "Me dá o primeiro valor decente que você achar, por favor!"

Sintaxe

COALESCE(valor1, valor2, ..., valor_n)

valor1, valor2, ..., valor_n — são os argumentos que você passa pra função. Ela vai devolver o primeiro valor que não for NULL.

Exemplos de uso do COALESCE()

Vamos ver uns exemplos.

Exemplo 1: Trocando NULL por 0

Imagina que temos uma tabela salaries:

A gente quer calcular o total dos salários - isso é fácil:

SELECT SUM(salary) AS total_salary
FROM salaries;

A função SUM() ignora NULL, então tá de boa.

Mas aí queremos calcular o total dos salários se a gente der um bônus de 1000 pra cada funcionário.

SELECT SUM(salary+1000) AS total_salary
FROM salaries;

E aí o resultado começa a dar ruim. O melhor é já trocar os valores NULL usando a função COALESCE e botar 0 no lugar. Olha só como faz:

SELECT SUM(COALESCE(salary, 0)) AS total_salary
FROM salaries;

Resultado:

Bem melhor e mais seguro.

Exemplo 2: Trocando NULL por um valor padrão

Agora, imagina que temos uma tabela students com nomes e endereços:

A gente quer trocar NULL nos endereços por "Não informado":

SELECT name, COALESCE(address, 'Não informado') AS resolved_address
FROM students;

Resultado da consulta:

Exemplo 3: Usando vários valores

Às vezes, você quer trocar NULL não só por um valor, mas por uma sequência de valores. Por exemplo, queremos pegar o nome, o nome de amigo ou usar "Sem nome" se nenhum deles estiver preenchido. Tabela users:

Consulta:

SELECT user_id,
       COALESCE(first_name, short_name, 'Sem nome') AS display_name
FROM users;

Resultado:

Uso prático do COALESCE()

No dia a dia, COALESCE() é tipo um salva-vidas pra trabalhar com dados que não estão perfeitos.

Vamos ver como ela ajuda em várias situações.

Exemplo 1: Trocando valores em campos de texto

Tabela original customers:

Consulta:

SELECT name, COALESCE(address, 'Não informado') AS address
FROM customers;

Resultado:

Exemplo 2: Preparando dados pra relatórios

Tabela original sales:

Consulta:

SELECT SUM(COALESCE(price, 0)) AS total_sales
FROM sales;

Resultado:

Erros comuns ao usar COALESCE()

Apesar de COALESCE() parecer simples e universal, dá pra cair em umas armadilhas com ela.

Tipos de dados incompatíveis. Todos os argumentos que você passa pra COALESCE() precisam ser compatíveis no tipo de dado. Por exemplo, não dá pra misturar string e número.

-- Erro
SELECT COALESCE(salary, 'Não informado') FROM employees; 
-- salary é campo numérico, e 'Não informado' é texto.

Ignorar a ordem dos argumentos. COALESCE() devolve o primeiro valor que não for NULL, então a ordem dos argumentos faz toda a diferença.