Query

SQL COALESCE / NULL handling

Return the first non-NULL value; NULL comparison rules require IS NULL / IS NOT NULL.

Availability: Common SQL with references for SQL standard, MySQL/MariaDB, PostgreSQL, SQL Server, SQLite and Oracle Database; syntax and feature support vary by engine and version.中文

Syntax

COALESCE(expression, fallback)

Examples

Return the first non-NULL value; NULL comparison rules require IS NULL / IS NOT NULL.

SELECT COALESCE(nickname, name) AS display_name FROM users WHERE deleted_at IS NULL;

SQLite-oriented example; consult the relevant dialect manual.

SELECT COALESCE(nickname, name) AS display_name FROM users WHERE deleted_at IS NULL;

Parameters, options and clauses

Option / clauseDescription
SELECT / expressionChoose output columns, expressions, aliases or functions.
FROM / JOINChoose source tables and combine related rows.
WHEREFilter rows before grouping; use IS NULL for null checks.
GROUP BY / HAVINGGroup rows and filter aggregate groups.
ORDER BYSort the result; ASC is commonly the default and DESC reverses it.
LIMIT / OFFSET / FETCHLimit or skip rows; syntax differs by database dialect.

Dialect references

Safety note

Review a command and its target before running it. Commands that alter files, services, accounts, disks, permissions or databases may be difficult to reverse. Test in a safe environment and keep backups.

Official reference ↗Back to directory