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

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

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

2201W invalid_row_count_in_limit_clause

ERROR 源码确认 参考 未实测

类别
Class 22 数据异常
严重等级
ERROR
条件名
invalid_row_count_in_limit_clause
宏名称
ERRCODE_INVALID_ROW_COUNT_IN_LIMIT_CLAUSE
启用版本
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

速览

LIMIT 或 FETCH 行数触发了特定形式的守卫。固定路径报告 LIMIT must not be negative；解析器另行拒绝 FETCH FIRST ... WITH TIES 中字面 NULL 行数。

代表性报文

代表性守卫使用以下首要文本：

路径 首要文本
普通 LIMIT 的负 count LIMIT must not be negative
FETCH FIRST ... WITH TIES 中的字面 NULL row count cannot be null in FETCH FIRST ... WITH TIES clause

报文模板

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

主消息 LIMIT must not be negative

来源：src/backend/executor/nodeLimit.c @ REL_18_6

主消息 row count cannot be null in FETCH FIRST ... WITH TIES clause

来源：src/backend/parser/parse_clause.c @ REL_18_6

含义

执行器计算普通 LIMIT count 时，NULL 被解释为没有 count（LIMIT ALL），零值合法并返回零行，负值才报告 2201W。解析器另有 FETCH FIRST ... WITH TIES 裸 NULL 常量守卫；这不是所有可为空 LIMIT 表达式都采用的统一规则。OFFSET 由 2201X 处理。

诊断

先确认报文来自普通 LIMIT 求值还是 WITH TIES 解析规则，再检查表达式实际值和类型。区分无 ties 时的 NULL、with ties 的字面 NULL、零值和负值。源码的 A_Const 检查范围很窄，隐藏在表达式中的 NULL 可能通过解析器，因此应依据实际语句和报文分类。

处理

普通 LIMIT 若要不限行可使用 NULL，否则提供非负 count；WITH TIES 应提供该语法接受的非 NULL 行数。如果负 count 或解析器 ERROR 发生在显式事务中，应先 ROLLBACK 或回滚到既有保存点再重试；自动提交可重试修正后的语句。

版本

锁定目录从 8.4.0 起记录该条件；本页固定源码路径为 PostgreSQL 18.6。未声称本页有自然运行观察。

来源

证据

断言

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

  • 2201W is invalid_row_count_in_limit_clause in SQLSTATE Class 22

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

    来源src/backend/utils/errcodes.txt

  • Fixed PostgreSQL 18.6 executor and parser paths distinguish ordinary LIMIT NULL/zero/negative values from the narrow literal NULL WITH TIES guard.

    核实方式Read complete source contexts for the representative guards.

    不覆盖Source confirmation is not a natural runtime observation.

    来源src/backend/executor/nodeLimit.c · src/backend/parser/parse_clause.c

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

    核实方式Use catalogue presence and history boundaries.

    来源src/backend/utils/errcodes.txt

同类错误代码

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