42P20 windowing_error

窗口函数错误

ERROR 源码确认参考未实测

类别: Class 42 语法错误或访问规则冲突
严重等级: ERROR
条件名: windowing_error
宏名称: ERRCODE_WINDOWING_ERROR
启用版本: 8.4
状态: 活跃

版本覆盖

速览

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

占位符由实际对象、列或参数填充。