文档 / SQL 状态码 / Class 0F 定位器异常
0F001 invalid_locator_specification
ERROR 仅定义 参考 未实测
- 条件名
invalid_locator_specification- 宏名称
ERRCODE_L_E_INVALID_SPECIFICATION- 启用版本
- 7.4
- 状态
- 活跃
版本覆盖
速览
SQLSTATE 0F001 是 0F 类别中的 Invalid Locator Specification 成员。锁定的 PostgreSQL 定义记录了 SQL 标准身份，但已解析的 PostgreSQL 18.6 core/contrib 扫描没有找到报告调用。不能把条件名扩展成 PostgreSQL 大对象、游标、FDW 句柄或某个驱动 API 的断言。
含义
当实际产生者采用该 SQLSTATE 时，这个成员表示 locator 规格无效。固定目录没有指出当前 PostgreSQL 后端中的 locator 表示形式或哪一种操作会无效。成员码比 0F000 更具体，但仍需要结合产生者和消息解释。
消息
由于有界扫描没有解析出原生报告调用，本页不采用未经确认的 PostgreSQL 固定消息变体。
诊断
记录完整诊断和阶段：解析/准备、执行、描述符查找，还是客户端调用。确认负责 locator 的实现，并查看其固定文档或源码中允许的 locator 语法和生命周期。如果 PostgreSQL 返回其他代码，就保留那个代码；不能把 0F001 当作兜底分类。
处理
按实际产生者的规则修正 locator 规格或其所属句柄；只有确认没有完成外部可见工作且操作可安全重复时，才重做失败语句。若错误来自转发或客户端边界，应修复该边界，不要仅凭条件名改变 PostgreSQL 事务策略。
版本
锁定目录将该条件的已知下界记为 PostgreSQL 7.4。事实块列出已发布快照；源码路径状态仅限于下方固定的 PostgreSQL 18.6 资料。
来源
- 上游源码 src/backend/utils/errcodes.txt 第 128 行
- 核验材料 raw/calls/REL_18_6.jsonl
证据
断言
每条断言都写明了是怎么核实的，以及它不覆盖什么。这一层是核验时留下的原始英文记录，照原样呈现，未经翻译。
-
0F001 is invalid_locator_specification in SQLSTATE Class 0F.
-
No resolved 0F001 report group was found in the locked PostgreSQL 18.6 core/contrib call scan.
-
The locked release definitions establish catalogue presence from the known 7.4 boundary; they do not establish a precise introducing release or runtime use.
同类 SQL 状态码
| 状态码 | 条件名 | 宏名称 | 严重等级 | 版本 |
|---|---|---|---|---|
| 0F000 | locator_exception | ERRCODE_LOCATOR_EXCEPTION |
ERROR | 7.4 |
| 定位器（locator）异常的类别条件。 | 活跃 | |||
| 0F001 | invalid_locator_specification | ERRCODE_L_E_INVALID_SPECIFICATION |
ERROR | 7.4 |
| 定位器规格无效的标准条件。 | 活跃 | |||