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

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

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

22011 substring_error

ERROR 源码确认 参考 未实测

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

速览

文本子字符串路径收到无效的显式长度。固定的 PostgreSQL 18.6 代码中，text_substring 以 SQLSTATE 22011 报告 negative substring length not allowed。

含义

三参数文本子字符串包装器把显式长度传给 text_substring；负长度会进入 ERRCODE_SUBSTRING_ERROR guard。无长度包装器则传入带有 length_not_specified 的哨兵值，返回剩余文本，不会进入负长度 guard。OVERLAY 的起点不为正时也复用这个报错。本证据针对文本路径；bytea、位串和基于模式的 substring 有各自的消费者，应以完整诊断识别。

诊断

修改前先确认解析出的操作和数据类型。对文本路径，要区分显式负长度与零或负起点：源码把有效起点调整为 1，并按 SQL 规则调整长度。起点超过末尾会返回空串。起点加长度的 32 位计算溢出时，子串延伸到末尾，并不报本码。OVERLAY 的非正起点使用同一 primary，而起点加长度溢出则使用 22003。

处理

传入非负的显式文本长度；若意图是取到末尾，则省略长度。保留预期的一基起点语义，并在修复前确认实际数据类型。该路径抛出 ERROR；显式事务需先 ROLLBACK 或回到已有保存点后再重试，自动提交只重试修正后的语句。

报文

  • Primary，ERROR：显式文本子字符串 guard 和非正 OVERLAY 起点 guard 都是 negative substring length not allowed；这些路径没有固定 DETAIL 或 HINT。

报文模板

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

主消息 negative substring length not allowed

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

适用范围：Explicit negative text length.

主消息 negative substring length not allowed

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

适用范围：Non-positive OVERLAY start; this is not the OVERLAY overflow branch.

版本

锁定目录从 7.4 起记录该条件；固定源码覆盖 PostgreSQL 18.6。引用的 guard 是当前版本的文本和 OVERLAY 路径，不推广到所有 substring 实现。

来源

证据

断言

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

  • 22011 is substring_error in SQLSTATE Class 22.

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

    来源src/backend/utils/errcodes.txt

  • The fixed text_substring path raises 22011 only for an explicit negative length; the omitted-length sentinel returns the remainder and the start/end calculations cover empty and overflow cases.

    核实方式Read the complete text_substring wrapper and guard.

    不覆盖This is the fixed text path; other substring data types have separate consumers.

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

  • The fixed OVERLAY path reuses the 22011 primary for a non-positive start, while an overflowing start-plus-length uses 22003.

    核实方式Read the complete OVERLAY guard and overflow branch.

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

  • The locked catalogue records 22011 from 7.4 without proving an exact implementation introduction date.

    核实方式Use catalogue presence and history boundaries.

    来源src/backend/utils/errcodes.txt

同类错误代码

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