数据库中的COALESCE函数用于返回参数列表中第一个非NULL值，若所有参数均为NULL则返回NULL

Oracle/MySQL/SQLServer/Postgres/openGauss等关系型数据库中的COALESCE函数用于返回参数列表中第一个非NULL值，若所有参数均为NULL则返回NULL。

1、基本语法

COALESCE(expr1, expr2, ..., exprn)，支持任意数量参数。

• 从左到右依次判断 value1, value2, value3, ...
• 返回 第一个不是 NULL 的值
• 所有都为 NULL，则返回 NULL

2、 典型应用场景包括‌：

2.1、示例1

• 给字段设置显示默认值

SELECT COALESCE(nick_name, real_name, '匿名用户') AS display_name
FROM users;

含义：

• 如果 nick_name 不为 NULL → 用 nick_name
• 否则如果 real_name 不为 NULL → 用 real_name
• 否则用 '匿名用户'

2.2、 避免聚合结果为 NULL

SELECT COALESCE(SUM(amount), 0) AS total_amount
FROM orders
WHERE user_id = 123;

如果这个用户没有订单，SUM(amount) 为 NULL，使用 COALESCE 返回 0。

2.3、构造带默认值的查询条件或字段

SELECT COALESCE(phone, '无手机号') AS phone_display
FROM customers;

3、和 NVL / IFNULL 的对比

• COALESCE：标准 SQL，支持多个参数，很多数据库（PostgreSQL/openGauss/GaussDB、MySQL、Oracle 等）都支持
• NVL(expr1, expr2)（Oracle）：只支持两个参数，相当于 COALESCE(expr1, expr2)
• IFNULL(expr1, expr2)（MySQL）：也只支持两个参数

4、小注意点

所有参数的数据类型要能相互兼容，否则会报类型错误

在 WHERE 里用时，只是返回值，不会"忽略 NULL 行"，要配合条件使用，例如：

SELECT *
FROM users
WHERE COALESCE(status, 'inactive') = 'active';

5、gaussdb中使用COALESCE

-- ============================================
-- 1. 函数测试
-- ============================================
-- 创建函数：计算用户总消费
CREATE OR REPLACE FUNCTION test_schema.get_user_total_spent(p_user_id INT)
RETURNS DECIMAL(10, 2) AS $$
DECLARE
    v_total DECIMAL(10, 2);
BEGIN
    SELECT COALESCE(SUM(total_amount), 0) INTO v_total
    FROM test_schema.tb_orders
    WHERE user_id = p_user_id AND order_status = 'completed';
    
    RETURN v_total;
END;
$$ LANGUAGE plpgsql;

-- 测试函数
SELECT test_schema.get_user_total_spent(1) AS user1_total_spent;

-- ============================================
-- 2. 视图测试
-- ============================================
-- 创建视图
CREATE OR REPLACE VIEW test_schema.v_user_order_summary AS
SELECT 
    u.user_id,
    u.username,
    u.email,
    COUNT(o.order_id) AS total_orders,
    COALESCE(SUM(CASE WHEN o.order_status = 'completed' THEN o.total_amount ELSE 0 END), 0) AS completed_amount,
    COALESCE(SUM(CASE WHEN o.order_status = 'pending' THEN o.total_amount ELSE 0 END), 0) AS pending_amount
FROM test_schema.tb_users u
LEFT JOIN test_schema.tb_orders o ON u.user_id = o.user_id
GROUP BY u.user_id, u.username, u.email;

-- 查询视图
SELECT * FROM test_schema.v_user_order_summary ORDER BY completed_amount DESC;