42P20 windowing_error

速览

42P20（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 源码，目录存在范围不等于每条消息或功能都从该版本开始。

相关

• 42P19
• 42803

来源

• 上游源码 src/backend/parser/parse_clause.c 第 2851–2855 行 REL_18_6 724edf9bd fd3fb69d
• 上游源码 src/backend/parser/gram.y 第 16534–16537 行 REL_18_6 724edf9bd 7e548b67
• 上游源码 src/backend/executor/execExpr.c 第 1155–1157 行 REL_18_6 724edf9bd 9bc3aa25
• 上游源码 src/backend/parser/gram.y 第 16541–16544 行 REL_18_6 724edf9bd 7e548b67
• 上游源码 src/backend/parser/parse_clause.c 第 2790–2793 行 REL_18_6 724edf9bd fd3fb69d
• 上游源码 src/backend/parser/parse_clause.c 第 2893–2897 行 REL_18_6 724edf9bd fd3fb69d
• 上游源码 src/backend/parser/gram.y 第 16499–16502 行 REL_18_6 724edf9bd 7e548b67
• 上游源码 src/backend/parser/parse_clause.c 第 2944–2947 行 REL_18_6 724edf9bd fd3fb69d
• 上游源码 src/backend/parser/parse_clause.c 第 2899–2904 行 REL_18_6 724edf9bd fd3fb69d
• 上游源码 src/backend/parser/parse_clause.c 第 2863–2867 行 REL_18_6 724edf9bd fd3fb69d
• 上游源码 src/backend/parser/gram.y 第 16528–16531 行 REL_18_6 724edf9bd 7e548b67
• 上游源码 src/backend/parser/gram.y 第 16504–16507 行 REL_18_6 724edf9bd 7e548b67
• 上游源码 src/backend/parser/parse_clause.c 第 2921–2924 行 REL_18_6 724edf9bd fd3fb69d
• 上游源码 src/backend/parser/parse_agg.c 第 1041–1046 行 REL_18_6 724edf9bd 6e80a805
• 上游源码 src/backend/executor/nodeWindowAgg.c 第 2139 行 REL_18_6 724edf9bd c365e675
• 上游源码 src/backend/utils/errcodes.txt 第 344 行 REL_18_6 724edf9bd 6e8de346
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8