CUME_DIST是窗口函数,返回当前行在分组内“小于等于当前值的行数占总行数的比例”,结果范围为(0,1];它必须配合ORDER BY使用,按值比较而非序号,相同值返回相同结果,且恒包含自身。

什么是 CUME_DIST,它返回什么值
CUME_DIST 是窗口函数,返回当前行在分组内的「小于等于当前值的行数」占总行数的比例,结果范围是 (0, 1]。注意它不是按顺序编号再除以总数,而是严格按值比较——相同值会得到相同结果,且一定包含自身。
比如三行值为 [10, 20, 20],排序后:
– 值 10:只有它自己 ≤ 10 → CUME_DIST = 1/3 ≈ 0.333
– 值 20(两行):≤ 20 的有全部 3 行 → 每行 CUME_DIST = 3/3 = 1.0
CUME_DIST 必须配合 ORDER BY 使用,不能单独写
不写 ORDER BY 会直接报错(如 PostgreSQL 报 ERROR: window function requires an ORDER BY clause,SQL Server 同样拒绝)。它依赖明确的排序逻辑来定义“累计”的基准。
- 必须写在
OVER()里,且括号内至少含ORDER BY column - 支持多列排序:
ORDER BY salary DESC, hire_date ASC - 不能只写
PARTITION BY而不写ORDER BY—— 这是常见语法错误 - 如果想按整个结果集计算(不分组),就只写
ORDER BY,不加PARTITION BY
和 PERCENT_RANK 的关键区别在哪
两者都算排名占比,但算法不同:
– CUME_DIST 是「≤ 当前值的行数 / 总行数」,最小值也 > 0,最大值恒为 1
– PERCENT_RANK 是「(当前排名 - 1) / (总行数 - 1)」,首行必为 0,末行必为 1(除非只有一行)
例如数据 [100, 200, 300, 300](共 4 行):
value | CUME_DIST | PERCENT_RANK 100 | 0.25 | 0.00 200 | 0.50 | 0.33 300 | 1.00 | 1.00 ← 注意:两行 300 都得 1.00(CUME_DIST);PERCENT_RANK 也都是 1.00,因排名为 4
实际选哪个,取决于业务定义:“覆盖到当前值为止的比例”用 CUME_DIST,“相对位置偏移比例”倾向 PERCENT_RANK。
实战中容易漏掉的兼容性细节
不是所有数据库都支持 CUME_DIST,而且行为略有差异:
- PostgreSQL、SQL Server、Oracle、Snowflake、BigQuery(标准 SQL 模式)都支持
- MySQL 8.0+ 支持,但 5.7 及更早版本不支持(会报错
FUNCTION xxx does not exist) - SQLite 不支持该函数
- 某些旧版 Hive 或 Spark SQL 需开启 ANSI SQL 模式,否则可能解析失败
- 值为
NULL时,默认排在最前(NULLS FIRST),若需调整,要显式写ORDER BY col NULLS LAST(PostgreSQL/Oracle 支持,MySQL 8.0.22+ 开始支持)
真正上线前,务必在目标环境执行 SELECT CUME_DIST() OVER (ORDER BY id) FROM (VALUES (1),(2)) t(id); 快速验证是否可用。










