选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

9.21. 窗口函数 #

窗口函数提供了对与当前查询行相关的一组行执行计算的能力。 该特性的介绍请参见Section 3.5,语法细节请参见Section 4.2.8

内置的窗口函数列在Table 9.57中。注意,这些函数必须使用窗口函数语法调用,也就是说,需要一个OVER子句。

除了这些函数外,任何内置或用户定义的通用或统计聚合函数(即不属于有序集或假想集聚合的函数)都可以用作窗口函数;内置聚合函数列表见Section 9.20。聚合函数只有在调用后跟随 OVER 子句时才作为窗口函数;否则作为非窗口聚合,为整个集合返回一行。

Table 9.57. 通用窗口函数

函数 返回类型 描述
row_number() bigint 当前行在其分区内的编号,从 1 开始计数
rank() bigint 当前行的排名,允许空缺;等于其第一个同等行的 row_number
dense_rank() bigint 当前行的排名,没有空缺;此函数对同等行组计数
percent_rank() double precision 当前行的相对排名:(rank - 1)/(分区总行数 - 1)
cume_dist() double precision 累积分布:(分区中位于当前行之前或与之同等的行数)/ 分区总行数
ntile(num_buckets integer) integer 范围为 1 到参数值的整数,将分区尽可能均等地划分
lag(value anyelement [, offset integer [, default anyelement ]]) same type as value 返回在分区内当前行之前 offset 行处计算的 value;如果没有这样的行,则返回 default(其类型必须与 value 相同)。offsetdefault 都针对当前行求值。如果省略,offset 默认为 1,default 默认为 null
lead(value anyelement [, offset integer [, default anyelement ]]) same type as value 返回在分区内当前行之后 offset 行处计算的 value;如果没有这样的行,则返回 default(其类型必须与 value 相同)。offsetdefault 都针对当前行求值。如果省略,offset 默认为 1,default 默认为 null
first_value(value any) same type as value 返回在窗口帧第一行处计算的 value
last_value(value any) same type as value 返回在窗口帧最后一行处计算的 value
nth_value(value any, nth integer) same type as value 返回在窗口帧第 nth 行处计算的 value(从 1 开始计数);没有这样的行时返回 null

Table 9.57中列出的所有函数都依赖于相关窗口定义的ORDER BY子句指定的排序顺序。 仅考虑ORDER BY列时不能区分的行被称为是同等行。 定义的这四个排名函数(包括 cume_dist),对于同等行组的所有行的答案相同。

注意first_valuelast_valuenth_value只考虑窗口帧内的行,它默认情况下包含从分区的开始行直到当前行的最后一个同等行。 这对last_value可能不会给出有用的结果,有时对nth_value也一样。 你可以通过向OVER子句增加一个合适的帧声明(RANGEROWSGROUPS)来重定义帧。 关于帧声明的更多信息请参考Section 4.2.8

当一个聚合函数被用作窗口函数时,它将在当前行的窗口帧内的行上聚合。 一个使用ORDER BY和默认窗口帧定义的聚合产生一种运行时求和类型的行为,这可能是或者不是想要的结果。 为了获取在整个分区上的聚合,忽略ORDER BY或者使用ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING。 其它窗口帧声明可以用来获得其它的效果。

Note

SQL 标准为leadlagfirst_valuelast_valuenth_value定义了一个RESPECT NULLSIGNORE NULLS选项。 这在PostgreSQL中没有实现:行为总是与标准的默认相同,即RESPECT NULLS。 同样,标准中用于nth_valueFROM FIRSTFROM LAST选项没有实现: 只有支持默认的FROM FIRST行为(你可以通过反转ORDER BY的排序达到FROM LAST的结果)。

cume_dist 计算分区中小于或等于当前行及其同等行的行所占的比例;percent_rank 则假设当前行不存在于分区中,计算分区中小于当前行的行所占的比例。