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

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

百科 / SQL 状态码 / Class HV 外部数据包装器错误（SQL/MED）

HV091 fdw_invalid_descriptor_field_identifier

ERROR 仅定义 参考 未实测

类别
Class HV 外部数据包装器错误（SQL/MED）
严重等级
ERROR
条件名
fdw_invalid_descriptor_field_identifier
宏名称
ERRCODE_FDW_INVALID_DESCRIPTOR_FIELD_IDENTIFIER
最早已知存在
9.1.0
状态
有效

版本覆盖

  1. 18
  2. 17
  3. 16
  4. 15
  5. 14
  1. 13
  2. 12
  3. 11
  4. 10
  5. 9.6
  6. 9.5
  7. 9.4
  8. 9.3
  9. 9.2
  10. 9.1
  11. 9.0
  1. 19 beta
  2. 20 dev

版本条依据已采样构建显示；灰色版本可能尚未采样，悬停可查看。手册链接随版本选择，源码和运行证据保持原核验构建。

速览

HV091 表示 FDW 边界无法使用某个描述符字段标识符。锁定的 PostgreSQL 18.6 核心与 contrib 调用扫描没有解析出 HV091 报告组，因此不能确认具体描述符命名空间或消息。

含义

字段标识符可能在包装器管理的接口中选择名称、类型、长度或其他描述符属性。通用 FDW 回调签名没有定义此 SQLSTATE 的字段命名空间。

消息与诊断

没有解析出 18.6 核心与 contrib 的直接消息变体。保留完整诊断、描述符类型、字段标识符、消息中出现的期望命名空间、回调阶段和包装器/驱动版本。

诊断

识别描述符生产者和消费者，再按该实现的文档或源码比较字段标识符。除非包装器明确规定映射，否则不要把它替换成列序号。

处理

使用实际描述符接口支持的字段标识符；只有源码证实存在生产者/消费者版本不匹配时，才调整相应版本。重复同一查找不能使未知标识符生效。

版本

HV091 在锁定定义快照 9.1.24 至 18.6 以及 19 Beta 3 中存在，known_present_by 为 9.1.0。现有 9.1 之前定义资料不足以确定精确引入版本。

来源

证据

断言

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

  • HV091 is fdw_invalid_descriptor_field_identifier in SQL/MED Class HV.

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

    来源 来源：src/backend/utils/errcodes.txt @ REL_18_6

  • The condition name identifies an invalid FDW descriptor field identifier. The field namespace and descriptor interface remain implementation-specific.

    核实方式Read the fixed FDW callback signatures and FdwRoutine structure.

    不覆盖Generic API context is background only and does not prove an emitting path for this SQLSTATE.

    来源 来源：src/include/foreign/fdwapi.h @ REL_18_6

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

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

    不覆盖This scan does not cover external wrappers, drivers, remote systems, or user callbacks; absence from the scan is not an absolute absence claim.

    来源 来源：raw/calls/REL_18_6.jsonl · 来源：src/backend/utils/errcodes.txt @ REL_18_6

  • The locked release definition snapshots establish presence from the known 9.1.0 boundary; the available pre-9 material does not establish an exact introduction release.

    核实方式Compare the canonical release-definition facts with the available pre-9 source boundary.

    不覆盖Definition presence does not prove runtime use.

    来源 来源：src/backend/utils/errcodes.txt @ REL_18_6

同类 SQL 状态码

状态码 条件名 宏名称 严重等级 版本
Class HV 外部数据包装器错误（SQL/MED） Foreign Data Wrapper Error (SQL/MED) 27 个 ↗
HV000 fdw_error ERRCODE_FDW_ERROR ERROR 9.1.0 起已知
外部数据包装器的通用错误，需看包装器诊断。 有效
HV001 fdw_out_of_memory ERRCODE_FDW_OUT_OF_MEMORY ERROR 9.1.0 起已知
包装器分配内存失败，如获取 libpq 默认选项时。 有效
HV002 fdw_dynamic_parameter_value_needed ERRCODE_FDW_DYNAMIC_PARAMETER_VALUE_NEEDED ERROR 9.1.0 起已知
包装器缺少必需的参数值，如未给 filename。 有效
HV004 fdw_invalid_data_type ERRCODE_FDW_INVALID_DATA_TYPE ERROR 9.1.0 起已知
包装器无法使用该数据类型，类型映射不匹配。 有效
HV005 fdw_column_name_not_found ERRCODE_FDW_COLUMN_NAME_NOT_FOUND ERROR 9.1.0 起已知
包装器在远端或描述符中找不到该外部列名。 有效
HV006 fdw_invalid_data_type_descriptors ERRCODE_FDW_INVALID_DATA_TYPE_DESCRIPTORS ERROR 9.1.0 起已知
包装器的数据类型描述符不一致或不可用。 有效
HV007 fdw_invalid_column_name ERRCODE_FDW_INVALID_COLUMN_NAME ERROR 9.1.0 起已知
传给包装器的列名无效，不符合命名规则。 有效
HV008 fdw_invalid_column_number ERRCODE_FDW_INVALID_COLUMN_NUMBER ERROR 9.1.0 起已知
包装器描述符收到超出范围的列序号。 有效
HV009 fdw_invalid_use_of_null_pointer ERRCODE_FDW_INVALID_USE_OF_NULL_POINTER ERROR 9.1.0 起已知
包装器边界上非法使用了空指针。 有效
HV00A fdw_invalid_string_format ERRCODE_FDW_INVALID_STRING_FORMAT ERROR 9.1.0 起已知
包装器无法接受该字符串的格式。 有效
HV00B fdw_invalid_handle ERRCODE_FDW_INVALID_HANDLE ERROR 9.1.0 起已知
包装器收到未知、已关闭或无效的句柄。 有效
HV00C fdw_invalid_option_index ERRCODE_FDW_INVALID_OPTION_INDEX ERROR 9.1.0 起已知
包装器处理自身选项数组时收到无效索引。 有效
HV00D fdw_invalid_option_name ERRCODE_FDW_INVALID_OPTION_NAME ERROR 9.1.0 起已知
当前上下文不接受该外部数据包装器选项名。 有效
HV00J fdw_option_name_not_found ERRCODE_FDW_OPTION_NAME_NOT_FOUND ERROR 9.1.0 起已知
dblink 连接选项不在接受的选项集合中。 有效
HV00K fdw_reply_handle ERRCODE_FDW_REPLY_HANDLE ERROR 9.1.0 起已知
包装器读取回复时收到无效的回复句柄。 有效
HV00L fdw_unable_to_create_execution ERRCODE_FDW_UNABLE_TO_CREATE_EXECUTION ERROR 9.1.0 起已知
包装器准备执行时无法创建执行对象。 有效
HV00M fdw_unable_to_create_reply ERRCODE_FDW_UNABLE_TO_CREATE_REPLY ERROR 9.1.0 起已知
包装器无法创建存放结果的回复对象。 有效
HV00N fdw_unable_to_establish_connection ERRCODE_FDW_UNABLE_TO_ESTABLISH_CONNECTION ERROR 9.1.0 起已知
包装器无法与外部数据源建立连接。 有效
HV00P fdw_no_schemas ERRCODE_FDW_NO_SCHEMAS ERROR 9.1.0 起已知
包装器不支持 IMPORT FOREIGN SCHEMA 导入。 有效
HV00Q fdw_schema_not_found ERRCODE_FDW_SCHEMA_NOT_FOUND ERROR 9.1.0 起已知
IMPORT FOREIGN SCHEMA 找不到请求的远端模式。 有效
HV00R fdw_table_not_found ERRCODE_FDW_TABLE_NOT_FOUND ERROR 9.1.0 起已知
包装器在外部数据源中找不到请求的表。 有效
HV010 fdw_function_sequence_error ERRCODE_FDW_FUNCTION_SEQUENCE_ERROR ERROR 9.1.0 起已知
包装器的函数被以无效的顺序调用。 有效
HV014 fdw_too_many_handles ERRCODE_FDW_TOO_MANY_HANDLES ERROR 9.1.0 起已知
包装器的句柄数量达到上限。 有效
HV021 fdw_inconsistent_descriptor_information ERRCODE_FDW_INCONSISTENT_DESCRIPTOR_INFORMATION ERROR 9.1.0 起已知
包装器描述符中的信息互相不一致。 有效
HV024 fdw_invalid_attribute_value ERRCODE_FDW_INVALID_ATTRIBUTE_VALUE ERROR 9.1.0 起已知
包装器拒绝了某个属性值，取值无效。 有效
HV090 fdw_invalid_string_length_or_buffer_length ERRCODE_FDW_INVALID_STRING_LENGTH_OR_BUFFER_LENGTH ERROR 9.1.0 起已知
包装器边界的字符串或缓冲区长度无效。 有效
HV091 fdw_invalid_descriptor_field_identifier ERRCODE_FDW_INVALID_DESCRIPTOR_FIELD_IDENTIFIER ERROR 9.1.0 起已知
包装器无法使用该描述符字段标识符。 有效