filter子句必须紧贴聚合函数后并用括号包裹,仅接受布尔表达式,不可用于窗口函数或distinct,不满足条件的行被真正剔除,空集时多数聚合返回null(count(*)除外)。

FILTER子句必须紧贴聚合函数后,且括号不可省
写成 AVG(salary) FILTER (WHERE salary > 10000) 才合法;漏掉括号、写成 AVG(salary) FILTER WHERE salary > 10000 或 AVG(salary FILTER (WHERE ...)) 都会直接报错 syntax error at or near "WHERE"。它不是函数参数,也不是独立子句,而是聚合表达式的语法修饰部分。
- WHERE 后只能跟布尔表达式,不能含子查询、
ORDER BY、参数占位符(如?或$1) - 条件中涉及可能为 NULL 的列时,需显式判断:例如
WHERE score IS NOT NULL AND score >= 90,否则 NULL 行会被整行滤掉(这是设计行为) - 多个聚合可各自带不同
FILTER,比如COUNT(*) FILTER (WHERE status = 'paid')和SUM(amount) FILTER (WHERE refunded = false)可并存,互不干扰
FILTER 不等于 CASE WHEN,语义和行为有本质区别
FILTER 是行级过滤:不满足条件的行从当前聚合的输入集中被真正剔除;而 CASE WHEN 是值级映射,不匹配分支默认为 NULL,但若误加 ELSE 0 就会污染结果——尤其对 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 active)统计 active 为 true 的行数;COUNT(CASE WHEN active THEN 1 END)效果一致,但前者语义直白、无缩进负担 -
AVG(salary) FILTER (WHERE salary > 5000)分母是 >5000 的非空行数;AVG(CASE WHEN salary > 5000 THEN salary ELSE 0 END)会把低薪员工全算作 0,严重拉低均值 -
STRING_AGG(name, ', ') FILTER (WHERE active)比嵌套CASE清晰得多,且不会因 NULL 处理出错
FILTER 不能用于窗口函数,也不能嵌套或混用 DISTINCT
PostgreSQL 当前(v16)明确不支持在窗口函数中使用 FILTER。写 AVG(sales) FILTER (WHERE region = 'US') OVER (PARTITION BY year) 会报错 FILTER is not allowed in window function calls。
- 替代方案只能是预处理:用 CTE 先过滤出目标行,再开窗;或用
CASE WHEN+ 窗口函数组合(注意 NULL 处理) -
COUNT(DISTINCT col) FILTER (WHERE ...)语法非法,FILTER不支持与DISTINCT共用 - 不允许嵌套:
COUNT(*) FILTER (WHERE a) FILTER (WHERE b)直接报错 - 不能引用外部别名:
SELECT x AS val FROM t GROUP BY x HAVING COUNT(*) FILTER (WHERE val > 0)会提示列不存在
空集返回值和执行顺序容易被忽略
FILTER 筛不出任何行时,多数聚合函数返回 NULL(COUNT(*) 例外,返回 0)。这在报表中容易被前端误判为“无数据”,实际是“该条件下无匹配行”。另外,执行顺序是 WHERE → GROUP BY → FILTER → HAVING,顺序错了统计就偏了——比如想查「至少有 5 笔已支付订单的用户中,其未退款订单的平均金额」,必须用 HAVING COUNT(*) FILTER (WHERE status = 'paid') >= 5,而不是先 WHERE status = 'paid' 再 FILTER。










