支持的版本: 当前 (17) / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4

9.22. 窗口函数 #

窗口函数提供了在与当前查询行相关的行集上执行计算的能力。请参阅第 3.5 节了解此功能的介绍,以及第 4.2.8 节了解语法详情。

内置的窗口函数在表 9.65中列出。请注意,这些函数必须使用窗口函数语法调用,即需要 OVER 子句。

除了这些函数之外,任何内置或用户定义的普通聚合函数(即,非有序集或假设集聚合函数)都可以用作窗口函数;有关内置聚合函数的列表,请参阅第 9.21 节。仅当 OVER 子句紧跟在调用之后时,聚合函数才会充当窗口函数;否则,它们会充当普通聚合函数并为整个集合返回单行。

表 9.65. 通用窗口函数

函数

描述

row_number () → bigint

返回当前行在其分区中的编号,从 1 开始计数。

rank () → bigint

返回当前行的排名,带有间隙;即,其对等组中第一行的 row_number

dense_rank () → bigint

返回当前行的排名,没有间隙;此函数有效地计算对等组。

percent_rank () → double precision

返回当前行的相对排名,即 (rank - 1) / (分区总行数 - 1)。因此,该值的范围从 0 到 1(含)。

cume_dist () → double precision

返回累积分布,即(当前行之前或与当前行对等的行数)/(分区总行数)。因此,该值的范围从 1/N 到 1。

ntile ( num_buckets integer ) → integer

返回一个从 1 到参数值的整数,尽可能均匀地划分分区。

lag ( value anycompatible [, offset integer [, default anycompatible ]] ) → anycompatible

返回在分区中当前行之前的 offset 行处计算的 value;如果没有这样的行,则返回 default(其类型必须与 value 兼容)。offsetdefault 都相对于当前行进行计算。如果省略,则 offset 默认为 1,而 default 默认为 NULL

lead ( value anycompatible [, offset integer [, default anycompatible ]] ) → anycompatible

返回在分区中当前行之后的 offset 行处计算的 value;如果没有这样的行,则返回 default(其类型必须与 value 兼容)。offsetdefault 都相对于当前行进行计算。如果省略,则 offset 默认为 1,而 default 默认为 NULL

first_value ( value anyelement ) → anyelement

返回在窗口帧的第一行处计算的 value

last_value ( value anyelement ) → anyelement

返回在窗口帧的最后一行处计算的 value

nth_value ( value anyelement, n integer ) → anyelement

返回在窗口帧的第 n 行(从 1 开始计数)处计算的 value;如果没有这样的行,则返回 NULL


表 9.65中列出的所有函数都依赖于关联的窗口定义的 ORDER BY 子句指定的排序顺序。仅考虑 ORDER BY 列时,不不同的行被称为对等行。四个排名函数(包括 cume_dist)的定义使得它们为对等组的所有行给出相同的答案。

请注意,first_valuelast_valuenth_value 仅考虑 窗口帧内的行,默认情况下,该窗口帧包含从分区的开始到当前行的最后对等行的行。对于 last_value 以及有时对于 nth_value,这可能会产生无用的结果。可以通过向 OVER 子句添加合适的帧规范(RANGEROWSGROUPS)来重新定义帧。有关帧规范的更多信息,请参阅第 4.2.8 节

当聚合函数用作窗口函数时,它会在当前行的窗口帧内的行上进行聚合。与 ORDER BY 和默认窗口帧定义一起使用的聚合会产生运行总和类型的行为,这可能不是想要的。要获取对整个分区的聚合,请省略 ORDER BY 或使用 ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING。可以使用其他帧规范来获得其他效果。

注意

SQL 标准为 leadlagfirst_valuelast_valuenth_value 定义了一个 RESPECT NULLSIGNORE NULLS 选项。这在 PostgreSQL 中未实现:行为始终与标准的默认值相同,即 RESPECT NULLS。同样,标准的 FROM FIRSTFROM LAST 选项对于 nth_value 也未实现:仅支持默认的 FROM FIRST 行为。(您可以通过反转 ORDER BY 排序来实现 FROM LAST 的结果。)

提交更正

如果您在文档中发现任何不正确、与您使用特定功能时的体验不符或需要进一步澄清的地方,请使用此表格报告文档问题。