选择 打开 改范围 完整检索页

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

百科 / 错误代码 / Class HV 外部数据包装器错误

HV00B fdw_invalid_handle

ERROR 仅定义 参考 未实测

类别
Class HV 外部数据包装器错误
严重等级
ERROR
条件名
fdw_invalid_handle
宏名称
ERRCODE_FDW_INVALID_HANDLE
启用版本
9.1
状态
活跃

版本覆盖

速览

HV00B 表示 FDW 包装器收到的句柄未知、已关闭,或对当前操作无效。对 PostgreSQL 18.6 核心与 contrib 调用的扫描没有解析出直接的 HV00B 报告组,因此句柄类型和具体消息取决于实现。

含义

SQL/MED 中的“句柄”是实现自己管理的引用,不是 PostgreSQL 关系 OID 或 SQL 事务 ID。包装器可能用句柄表示远端连接、游标、回复或执行对象;这些只是可能的例子,本批没有确认具体的发码包装器。仅凭类别定义无法判断具体是哪一种。

消息与诊断

在已检查的 18.6 核心与 contrib 路径中没有解析出直接的消息变体。应记录包装器名称和版本、句柄种类及生命周期、回调阶段、外部服务器和外部表,以及完整诊断信息。远端连接失败也可能使用其他 SQLSTATE。

诊断

沿包装器源码追踪句柄的创建、传递、复用和关闭。检查扫描或修改回调是否晚于连接销毁,回调是否在清理后运行,以及包装器 ABI 是否与服务器匹配。不要把 NULL SQL 值推断为无效句柄。

处理

按包装器 API 修复句柄生命周期,或重新建立包装器管理的连接或对象。如果无法确定写操作是否已经完成,应先查看远端日志再决定是否重试。重复提交相同请求通常不能修复陈旧或已关闭的句柄。

版本

HV00B 从 9.1.0 到 18.6 以及 19 Beta 3 均存在。可用的 9.1 之前定义扫描没有观察到它;这只是历史边界,不是精确的引入版本结论。

来源

证据

断言

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

  • HV00B is fdw_invalid_handle in SQL/MED Class HV.

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

    来源src/backend/utils/errcodes.txt

  • No direct HV00B report group was resolved in the locked PostgreSQL 18.6 core/contrib call scan.

    核实方式Compare resolved report groups with the macro mapping.

    不覆盖The generic FDW API boundary does not identify an emitter for this SQLSTATE. The scan does not cover external wrappers, drivers, remote systems, or user callbacks.

    来源raw/calls/REL_18_6.jsonl · src/include/foreign/fdwapi.h

同类错误代码

Class HV 外部数据包装器错误 下的其他成员。