百科 / 错误代码 / Class HV 外部数据包装器错误
HV00B fdw_invalid_handle
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.
-
No direct HV00B report group was resolved in the locked PostgreSQL 18.6 core/contrib call scan.
同类错误代码
Class HV 外部数据包装器错误 下的其他成员。
HV000fdw_errorHV001fdw_out_of_memoryHV002fdw_dynamic_parameter_value_neededHV004fdw_invalid_data_typeHV005fdw_column_name_not_foundHV006fdw_invalid_data_type_descriptorsHV007fdw_invalid_column_nameHV008fdw_invalid_column_numberHV009fdw_invalid_use_of_null_pointerHV00Afdw_invalid_string_formatHV00Cfdw_invalid_option_indexHV00Dfdw_invalid_option_nameHV00Jfdw_option_name_not_foundHV00Kfdw_reply_handleHV00Lfdw_unable_to_create_executionHV00Mfdw_unable_to_create_replyHV00Nfdw_unable_to_establish_connectionHV00Pfdw_no_schemasHV00Qfdw_schema_not_foundHV00Rfdw_table_not_foundHV010fdw_function_sequence_errorHV014fdw_too_many_handlesHV021fdw_inconsistent_descriptor_informationHV024fdw_invalid_attribute_valueHV090fdw_invalid_string_length_or_buffer_lengthHV091fdw_invalid_descriptor_field_identifier