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

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

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

2200H sequence_generator_limit_exceeded

ERROR 源码确认 参考 未实测

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

版本覆盖

  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 的 sequence.c 路径同时有最大值和最小值的源码模板；端点值本身可以是合法返回值。数值使用 C 的 PRId64 格式宏，因此源码写法是 nextval: reached maximum value of sequence "%s" (%" PRId64 ")（最小值形式相应替换为 minimum），不能把它误写成字面量 (%s) 占位符。这里的限制属于序列属性，不是一般整数溢出。

含义

本条件表示 nextval 的 fetch loop 无法在配置的最小值或最大值之外再分配下一个值。在递增路径中，源码检查最大值边界；在递减路径中，源码检查最小值边界。触及边界时，若 rescnt > 0，循环会先停止并返回已经取得的合法值；只有没有可返回结果时，未启用 CYCLE 的分支才报告 2200H。启用 CYCLE 时，固定源码会绕回另一个配置端点。这是序列边界策略，不是一般整数溢出。

报文

未启用循环的递增 guard 以 ERROR 报告 primary 源码模板 nextval: reached maximum value of sequence "%s" (%" PRId64 ")；递减 guard 使用 nextval: reached minimum value of sequence "%s" (%" PRId64 ")。端点本身不是错误：如果 fetch loop 已取得合法结果，会先停止抓取而不进入错误分支。PRId64 是拼接进已编译数值占位符的 C 格式宏，最终显示的数字是运行时限制值。引用分支没有独立 DETAIL 或 HINT。

报文模板

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

主消息 nextval: reached maximum value of sequence "%s" (%" PRId64 ")

来源：src/backend/commands/sequence.c @ REL_18_6

主消息 nextval: reached minimum value of sequence "%s" (%" PRId64 ")

来源：src/backend/commands/sequence.c @ REL_18_6

诊断

检查报文点名的序列、步长、MINVALUE/MAXVALUE、CYCLE 设置以及调用是否为 nextval，先判断触及的是最大值还是最小值、是否仍有合法端点或缓存值可返回，以及循环是否是有意策略。CYCLE 只是序列策略，不是所有生成 ID 的通用修复：开启它可能与依赖键冲突，或违反应用的分配约束。若不应循环，应在核对依赖键后选择安全的新范围、调整序列或轮换到新序列。

处理

有意修复序列策略：核对键语义后调整安全限制、决定是否启用 CYCLE，或迁移到新序列。重复同一个 nextval、转换其结果或把本码当成整数溢出，都不能越过固定端点。

该分支抛出 ERROR 时，显式事务应先用 ROLLBACK 恢复，或对语句前已建立的保存点执行 ROLLBACK TO SAVEPOINT，再重试；自动提交下只在失败语句结束后重试修正后的动作。事务边界规则见事务与重试指南。

版本

锁定目录从 10.0 起记录该条件；固定源码覆盖 PostgreSQL 18.6。

来源

证据

断言

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

  • 2200H is sequence_generator_limit_exceeded in SQLSTATE Class 22.

    核实方式Read fixed definition.

    来源src/backend/utils/errcodes.txt

  • The nextval fetch loop checks the configured maximum for ascending sequences and minimum for descending sequences; at a boundary, rescnt > 0 stops fetching so already fetched legal values can be returned, while a non-cycling branch with no result left emits 2200H and cycle=true wraps to the opposite bound.

    核实方式Read the full fetch loop and both boundary branches.

    不覆盖The endpoint value can be a legal returned value, and CYCLE is a sequence policy choice rather than a universal repair for exhausted identifiers.

    来源src/backend/commands/sequence.c

  • The locked catalogue records 2200H from 10.0 without proving an exact implementation introduction date.

    核实方式Use catalogue boundary.

    来源src/backend/utils/errcodes.txt

同类错误代码

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