filter子句不是语法糖，而是postgresql中真正筛选聚合输入行的机制，必须紧贴聚合函数后写作“agg(expr) filter (where cond)”，括号不可省略，不兼容窗口函数和嵌套使用，且与case when存在语义本质差异——前者筛行，后者映射值。
FILTER 子句不是语法糖，它是 PostgreSQL 中真正筛选聚合输入行的机制——不靠转 NULL，而是从源头排除不满足条件的行。
FILTER 必须紧贴聚合函数后，括号不能省
常见错误是写成 AVG(salary) FILTER WHERE salary > 10000 或 AVG(salary FILTER (WHERE salary > 10000))，这两种都直接报错：syntax error at or near "FILTER" 或 syntax error at or near "WHERE"。FILTER 是聚合表达式的修饰子句，不是函数参数，也不是独立语句。
- ✅ 正确写法：
AVG(salary) FILTER (WHERE salary > 10000) - ✅ 多个并列也合法：
COUNT(*) FILTER (WHERE status = 'success'), SUM(amount) FILTER (WHERE paid) - ❌ 不能嵌套：
COUNT(*) FILTER (WHERE status = 'success') FILTER (WHERE created_at > '2023-01-01')会报错 - ❌ 不能用于窗口函数：
AVG(salary) FILTER (WHERE active) OVER (PARTITION BY dept)会提示FILTER is not allowed in window function calls
与 CASE WHEN 的关键行为差异
FILTER 和 CASE WHEN 看似都能实现条件聚合，但语义不同：FILTER 是“筛行”，CASE 是“映射值”。这对 AVG、STDDEV、STRING_AGG 等函数影响明显。
PostgreSQL 18.4 官方 Ubuntu 安装包现已发布，这是目前最新的稳定版本。推荐通过官方 APT 仓库安装：先执行 sudo apt update 更新索引，再运行 sudo apt install postgresql-18 即可完成部署。新版本引入了异步 I/O 子系统，在顺序扫描与 VACUUM 场景下性能提升显著，同时支持 UUID v7 原生生成函数与虚拟生成列。
-
COUNT(*) FILTER (WHERE flag)统计满足flag为 true 的行数；COUNT(CASE WHEN flag THEN 1 END)效果相同，但若误写成COUNT(CASE WHEN flag THEN 1 ELSE 0 END)，就会把 false 行也计为 1 -
AVG(x) FILTER (WHERE x > 0)只基于正数计算，分母是这些正数的行数；AVG(CASE WHEN x > 0 THEN x END)等效，但AVG(CASE WHEN x > 0 THEN x ELSE 0 END)会把负数/NULL 行全算作 0，严重拉低均值 -
STRING_AGG(name, ', ') FILTER (WHERE active)更直观安全；STRING_AGG(CASE WHEN active THEN name END, ', ')在 name 为 NULL 时可能产生多余逗号，且逻辑冗长
NULL 值和空结果需显式兜底
FILTER 条件求值为 FALSE 或 NULL 时，该行都会被排除——这是设计行为，不是 bug。但容易忽略两点：
- 条件中涉及的列本身为 NULL 时（如
salary IS NULL），整行会被滤掉，不会参与任何聚合。若本意是“只过滤非 NULL 且达标者”，得显式写WHERE salary IS NOT NULL AND salary > 10000 - 当某组内无一行满足 FILTER 条件时，结果为
NULL（如SUM(amount) FILTER (WHERE false)→NULL，COUNT(*) FILTER (WHERE false)→0）。报表场景下常需COALESCE(SUM(...), 0)防止前端误判 - 不能在 FILTER 中引用外部别名，例如
AVG(salary) FILTER (WHERE total_salary > 100000)（total_salary是 SELECT 列别名）会报错：别名在 FILTER 执行时尚未生成
哪些聚合函数支持 FILTER？不是所有都行
PostgreSQL 文档明确列出支持 FILTER 的聚合函数，包括 COUNT、SUM、AVG、MIN、MAX、STRING_AGG、BOOL_AND、BOOL_OR 等。但像 JSON_AGG、ARRAY_AGG 虽然常用，却**不支持** FILTER 修饰（截至 v16）。尝试使用会报错：function json_agg(text) does not exist —— 因为系统找不到带 FILTER 语义的重载版本。
- ✅ 安全可用：
COUNT(*) FILTER (WHERE status = 'done')、STRING_AGG(name, '; ') FILTER (WHERE priority = 'high') - ❌ 不支持：
JSON_AGG(row_to_json(t)) FILTER (WHERE t.active)→ 改用子查询或 CTE 预过滤 - ⚠️ 注意兼容性：MySQL、SQL Server（除窗口场景）、Oracle、旧版 SQLite 均不支持 FILTER；硬套会直接报语法错误
最易被忽略的是：FILTER 不改变聚合函数自身的 NULL 处理规则，它只是前置筛行。你仍需清楚每个聚合函数对 NULL 的默认行为（比如 AVG 自动跳过 NULL，COUNT(*) 不关心字段值），否则即使用了 FILTER，结果也可能不符合业务预期。
