42P20 — 窗口函数错误
42P20 — 窗口函数错误
速览
42P20（windowing_error）窗口定义同时约束函数调用和框架边界。
| 字段 | 值 |
|---|---|
| SQLSTATE | 42P20 |
| 条件名 | windowing_error |
| 状态 | 有效 |
| 已知存在于 | 8.4.0 |
| 锁定快照 | 9.0.23, 9.1.24, 9.2.24, 9.3.25, 9.4.26, 9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3 |
| 宏 | ERRCODE_WINDOWING_ERROR |
| 别名 | — |
含义
固定核心在窗口函数放置或嵌套错误，以及窗口定义结构无效时使用 42P20。解析器语法拒绝不可能的框架起止组合；解析分析拒绝在不能包含窗口函数的子句中使用窗口函数，或把一个窗口函数放入另一个窗口函数；命名窗口转换则拒绝冲突的继承方式。合法框架对某一行仍可能为空，所以结果为空本身不是 42P20 信号。
诊断
先按 primary 消息分类，再改 SQL。框架消息指向 UNBOUNDED 方向或起止顺序；带 offset 的 RANGE 必须有且只有一个 ORDER BY 列，GROUPS 必须有 ORDER BY。放置消息会指出 WHERE、GROUP BY、JOIN、RETURNING 或窗口定义等子句；嵌套调用消息表示一个窗口表达式出现在另一个窗口表达式内部。命名窗口消息分别表示重复定义、覆盖所复制窗口的 PARTITION BY 或 ORDER BY，以及复制已经带框架的窗口；因此 OVER foo 与 OVER (foo) 的继承行为不同。执行器会把负的 ROWS 或 GROUPS 框架 offset 报为 SQLSTATE 22013（invalid_preceding_or_following_size），把 NULL offset 报为 22004；这些不是 42P20。
处理
把嵌套计算移到外层查询，或把窗口表达式移出消息指出的命名子句。只修复对应的框架语法，为 RANGE/GROUPS 补上所需排序，并定义一个没有冲突覆盖的命名窗口。不要因为某一当前行的框架没有行就改动本来合法的框架。如果该 ERROR 发生在显式事务中，重试前先执行 ROLLBACK，或回滚到语句前建立的保存点；自动提交模式下，失败语句返回空闲后即可提交修正查询。
消息
固定源码中的代表性消息包括：
- ERROR message:
window function calls cannot be nested - ERROR message:
frame start cannot be UNBOUNDED FOLLOWING - ERROR message:
frame starting from following row cannot end with current row - ERROR message:
frame end cannot be UNBOUNDED PRECEDING - ERROR message:
frame starting from current row cannot have preceding rows - ERROR message:
frame starting from following row cannot have preceding rows - ERROR message:
window functions are not allowed in %s - ERROR message:
window "%s" is already defined - ERROR message:
cannot override PARTITION BY clause of window "%s" - ERROR message:
cannot override ORDER BY clause of window "%s" - ERROR message:
cannot copy window "%s" because it has a frame clause - ERROR message:
cannot copy window "%s" because it has a frame clause; HINT:Omit the parentheses in this OVER clause. - ERROR message:
RANGE with offset PRECEDING/FOLLOWING requires exactly one ORDER BY column - ERROR message:
GROUPS mode requires an ORDER BY clause
占位符由实际对象、列或参数填充。
版本
锁定目录显示该条件最早见于 PostgreSQL 8.4.0；行为说明固定在 PostgreSQL 18.6 源码，目录存在范围不等于每条消息或功能都从该版本开始。
相关
来源
源码消息、行号和证据边界见 作者证据。
src/backend/executor/execExpr.c:1155-1157(fixed source)src/backend/parser/gram.y:16499-16544(fixed source)src/backend/parser/parse_agg.c:1041-1046(fixed source)src/backend/parser/parse_clause.c:2790-2947(fixed source)src/backend/executor/nodeWindowAgg.c:2139-2210(fixed source)