Умовністандарт SQL

COALESCE

Повертає перше значення зі списку, яке не NULL.

Синтаксис

COALESCE(<значення1>, <значення2>, …)

Перевіряє аргументи зліва направо й повертає перший, що не NULL. Якщо NULL усі — результат теж NULL. Найчастіше цю функцію використовують для підставлення значення за замовчуванням, наприклад: «телефону нема — показати прочерк».

Дані для прикладів

employees

name	department	salary	bonus	phone
Emma	backend	1200	300	+44 7700 900123
Liam	backend	1000	NULL	NULL
Olivia	frontend	1350	150	+44 7700 900456
Noah	frontend	950	NULL	+44 7700 900789
Sophia	design	1200	200	NULL

Ці таблиці вже створено в пісочниці — приклади нижче працюють із ними. Хочеш повторити у своїй базі — скопіюй SQL.

Перше значення, що не NULL

SELECT COALESCE(NULL, NULL, 42) AS result;

result
42

Прочерк замість порожнього телефону

SELECT name, COALESCE(phone, '—') AS phone

FROM employees;

name	phone
Emma	+44 7700 900123
Liam	—
Olivia	+44 7700 900456
Noah	+44 7700 900789
Sophia	—

NULL «з'їдає» арифметику

SELECT name,

salary + bonus AS without_coalesce,

salary + COALESCE(bonus, 0) AS total

FROM employees;

name	without_coalesce	total
Emma	1500	1500
Liam	NULL	1000
Olivia	1500	1500
Noah	NULL	950
Sophia	1400	1400

Будь-яка дія з NULL дає NULL: у Liam і Noah бонусу нема, тож без COALESCE їхня сума зникла б зовсім.

Зверни увагу

Аргументи мають бути сумісного типу. COALESCE(bonus, 'n/a') для числового бонусу дасть помилку: PostgreSQL спробує перетворити 'n/a' на число. Приведи до тексту: COALESCE(bonus::text, 'n/a').

Порожній рядок '' — це не NULL, тож COALESCE його не замінить. Для такого поєднують із NULLIF: COALESCE(NULLIF(phone, ''), '—').

Схожі функції

NULLIF CASE

Детально в курсі

Обробка NULL: COALESCE та NULLIF