FILTER子句在PostgreSQL 14中完全支持,必须紧贴聚合函数写作“AGG() FILTER (WHERE cond)”,括号不可省、不可嵌套、不兼容窗口函数;多FILTER可并行共存,共享扫描,各自独立过滤输入行,空集时除COUNT(*)返回0外均返回NULL。

FILTER子句在 PostgreSQL 14 中完全支持,且语法、行为与 9.4+ 一致;它不是“多条件聚合”的开关,而是让多个独立条件聚合共存于同一查询的最简方式——关键不在“多条件”,而在“多 FILTER 并行”。
FILTER 必须紧贴聚合函数,括号一个都不能少
PostgreSQL 14 严格校验语法,漏括号、错位置、多嵌套都会直接报 syntax error at or near "WHERE" 或 syntax error at or near "FILTER"。
-
COUNT(*) FILTER (WHERE status = 'paid')✅ 正确:FILTER 是聚合表达式的后缀修饰,括号包裹完整布尔表达式 -
COUNT(*) FILTER WHERE status = 'paid'❌ 报错:缺( ) -
COUNT(*) FILTER (WHERE status = 'paid' AND paid_at > '2023-01-01')✅ 合法:WHERE 内允许多条件逻辑组合 -
COUNT(*) FILTER (WHERE status = 'paid') FILTER (WHERE amount > 100)❌ 报错:FILTER 不可嵌套
多个 FILTER 可并列,但各自条件互不干扰
你不需要写子查询或 JOIN 来实现“已支付订单数”“已发货订单数”“平均退款金额”——它们可以共享一次扫描,各自过滤各自的输入行。
- 每个
FILTER (WHERE ...)只影响它前面那个聚合函数,不影响其他列或后续聚合 - 所有 FILTER 共享外层
WHERE和GROUP BY,物理扫描只发生一次,性能优于多次子查询 - 条件中若涉及可能为 NULL 的字段(如
refunded_at),必须显式判断:WHERE refunded_at IS NOT NULL AND refunded_at ,否则整行被滤掉 - 不能用别名:
SELECT amount * 1.1 AS adj_amount FROM orders GROUP BY adj_amount HAVING AVG(adj_amount) FILTER (WHERE adj_amount > 100)会报错 ——adj_amount在 HAVING 中不可见
空集返回 NULL 而非 0,报表里容易误判
这是最常被忽略的行为细节:除 COUNT(*) 外,所有聚合函数在 FILTER 筛不出任何行时,返回 NULL,不是 0 或空字符串。
-
COUNT(*) FILTER (WHERE false)→0(COUNT 对空集定义为 0) -
SUM(amount) FILTER (WHERE false)→NULL -
AVG(amount) FILTER (WHERE false)→NULL -
STRING_AGG(name, ', ') FILTER (WHERE false)→NULL - 前端或 BI 工具若把
NULL当作“无数据”,可能掩盖真实语义:“有数据,但不满足该条件” - 需兜底时用
COALESCE(SUM(amount) FILTER (WHERE paid), 0),但注意:补 0 可能混淆“零值”和“无匹配”
不能和窗口函数混用,也不能替代 WHERE 或 HAVING
FILTER 既不是 WHERE 的子集,也不是 HAVING 的简化版——它只做一件事:从当前聚合函数的输入行中剔除不满足条件的行。执行顺序固定为:WHERE → GROUP BY → FILTER(每组内)→ HAVING。
-
AVG(sales) FILTER (WHERE region = 'US') OVER (PARTITION BY year)❌ 报错:FILTER is not allowed in window function calls—— PostgreSQL 14 仍不支持 - 想对窗口结果再过滤?只能先 CTE 过滤,再开窗:
WITH us_sales AS (SELECT * FROM sales WHERE region = 'US') SELECT AVG(sales) OVER (PARTITION BY year) FROM us_sales - 想查“至少有 3 笔成功订单的客户”,必须用
HAVING COUNT(*) FILTER (WHERE status = 'success') >= 3,而不是把条件塞进 WHERE——否则会漏掉该客户其他状态的订单(影响后续聚合) - FILTER 中不能引用聚合结果:
COUNT(*) FILTER (WHERE COUNT(*) > 5)❌ 直接报错,聚合别名在 FILTER 作用域外

















