↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。

百科 / 错误代码 / Class 22 数据异常

22016 invalid_argument_for_nth_value_function

ERROR 源码确认 参考 未实测

类别
Class 22 数据异常
严重等级
ERROR
条件名
invalid_argument_for_nth_value_function
宏名称
ERRCODE_INVALID_ARGUMENT_FOR_NTH_VALUE
启用版本
8.4
状态
活跃

版本覆盖

  1. 18
  2. 17
  3. 16
  4. 15
  5. 14
  1. 13
  2. 12
  3. 11
  4. 10
  1. 19 beta
  2. 20 dev

速览

nth_value 收到非正的序号。固定窗口函数路径以 SQLSTATE 22016 报告 argument of nth_value must be greater than zero。

含义

window_nth_value 先读取序号参数：NULL 返回 NULL，小于等于零才抛出 22016。正序号随后转换为从帧头开始的零基偏移。如果目标行不在当前帧内，或选中的值本身为 NULL，执行器返回 NULL；这两种情况都不是 22016。

诊断

检查序号实际值、窗口排序和帧边界。区分无效的非正参数与合法正参数但目标行不在帧内的情况。NULL 序号也是 NULL 结果路径，因此不能仅因结果为 NULL 就归为本码。

处理

如果函数确实要选取某行，传入正序号；只有必须包含目标行时才调整排序或帧。若 NULL 表示帧中没有目标行或目标值本来为 NULL，应保留这个结果。非正 guard 抛出 ERROR；显式事务需先回滚或回到已有保存点再重试，自动提交只重试修正后的语句。

报文

  • Primary，ERROR：argument of nth_value must be greater than zero。
  • 非正序号 guard 没有附加 DETAIL 或 HINT；超出帧和 NULL 值路径改为返回 NULL。

报文模板

源码里的格式串，不是某一次运行的输出。%s 之类是占位符，实际报文会填入对象名与取值。适用范围一栏是核验时留下的原始英文记录，未经翻译。

主消息 argument of nth_value must be greater than zero

来源：src/backend/utils/adt/windowfuncs.c @ REL_18_6

版本

锁定目录从 8.4.0 起记录该条件；固定源码覆盖 PostgreSQL 18.6。引用的是窗口函数实现，不是一般序号校验器。

来源

证据

断言

每条断言都写明了是怎么核实的，以及它不覆盖什么。这一层是核验时留下的原始英文记录，照原样呈现，未经翻译。

  • 22016 is invalid_argument_for_nth_value_function in SQLSTATE Class 22.

    核实方式Read the fixed errcodes row and macro.

    来源src/backend/utils/errcodes.txt

  • window_nth_value returns NULL for a NULL ordinal, raises 22016 for a non-positive ordinal, and returns NULL when a valid positive ordinal selects no row in the current frame or a NULL value.

    核实方式Read the complete ordinal check, frame lookup, and NULL result path.

    来源src/backend/utils/adt/windowfuncs.c

  • The locked catalogue records 22016 from 8.4.0 without proving an exact implementation introduction date.

    核实方式Use catalogue presence and history boundaries.

    来源src/backend/utils/errcodes.txt

同类错误代码

Class 22 数据异常 下的其他成员。