FILTER子句是SQL:2003标准特性,仅PostgreSQL 9.4+和SQL Server 2016+(限窗口函数)支持,语法为AGG(expr) FILTER (WHERE condition),不可用于COUNT(DISTINCT)或普通GROUP BY聚合。

FILTER 子句不是 SQL 标准的“通用语法”,而是 SQL:2003 标准中定义、但长期未被主流数据库广泛实现的特性。目前只有 PostgreSQL 9.4+ 和 SQL Server 2016+(仅限窗口函数)原生支持,且行为差异明显——别指望写一次就能跨库运行。
PostgreSQL 中 FILTER 的正确用法和限制
FILTER 必须紧贴聚合函数之后,且只能出现在 GROUP BY 查询中(不支持窗口函数场景),语法强制为 AGG(expr) FILTER (WHERE condition):
- COUNT(*) FILTER (WHERE status = 'completed') ✅
- AVG(salary) FILTER (WHERE salary > 0) ✅
- SUM(amount) FILTER (WHERE paid AND amount > 0) ✅
- AVG(salary FILTER (WHERE ...)) ❌(括号位置错,直接报错)
- COUNT(*) FILTER WHERE status = 'completed' ❌(缺括号,语法错误)
- COUNT(*) FILTER (WHERE status IN (?)) ❌(占位符不被接受,只支持列引用或常量)
多个 FILTER 可并存于同一 SELECT,互不影响,也不改变分组逻辑。它们共享外层 WHERE 和 GROUP BY,物理扫描只发生一次。
容易踩的坑:空集时 COUNT(*) FILTER 返回 0,但 SUM() 或 AVG() 返回 NULL;前端展示前必须用 COALESCE(SUM(...), 0) 显式兜底,否则可能误判为“无数据”。
SQL Server 2016+ 的 FILTER 只能用于窗口函数
SQL Server 的 FILTER 语义和 PostgreSQL 一致,但使用范围窄得多:
- COUNT(*) FILTER (WHERE active = 1) OVER (PARTITION BY dept) ✅
- SELECT dept, COUNT(*) FILTER (WHERE active = 1) FROM emp GROUP BY dept ❌(会报错,不支持普通聚合)
这意味着你无法用它替代 CASE WHEN 做分组条件统计。若需类似效果,必须用:
-
COUNT(CASE WHEN active = 1 THEN 1 END)(注意不要加ELSE 0,否则计数膨胀) - 或配合
OVER()先算窗口值,再在外层去重/聚合
性能上无优势,纯粹是语法糖;且旧版 SQL Server(FILTER 关键字,会直接报错。
MySQL、SQLite(旧版)、Oracle 等数据库根本不支持 FILTER
在这些系统里写 FILTER,结果只有一个:syntax error at or near "FILTER"。
替代方案统一用 CASE WHEN,但要注意三处细节:
- COUNT(CASE WHEN condition THEN 1 END) —— 不要加 ELSE 0,否则把不匹配行也计为 1
- AVG(CASE WHEN condition THEN value END) —— ELSE 分支留空(默认 NULL),让聚合函数自动跳过
- SUM(CASE WHEN condition THEN value END) 同理,避免 ELSE 0 扭曲均值分母
真正容易被忽略的是:当字段本身含 NULL 时,CASE WHEN col > 100 THEN col END 仍会把 col IS NULL 的行转成 NULL,而 FILTER 是先筛行再聚合——两者语义等价,但 FILTER 更难写错。
为什么不能在 COUNT(DISTINCT ...) 后加 FILTER
COUNT(DISTINCT col) FILTER (WHERE ...) 在所有数据库中都非法。因为 DISTINCT 是 COUNT 的修饰符,整个 COUNT(DISTINCT ...) 是一个原子函数调用,FILTER 语法上只能挂载在聚合函数“之后”,而非其内部。
MySQL 8.0+ 的等效写法是:
-
COUNT(DISTINCT CASE WHEN status = 'completed' THEN user_id END) - 注意:若
user_id本身为NULL,CASE返回NULL,DISTINCT会忽略它,效果符合预期
PostgreSQL 虽支持 FILTER,但同样不支持嵌套在 DISTINCT 内部——这点所有数据库保持一致,没有例外。

















