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

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

文档 / SQL 状态码 / Class HV 外部数据包装器错误

HV00J fdw_option_name_not_found

ERROR 源码确认 参考 未实测

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

版本覆盖

  1. 18
  2. 17
  3. 16
  4. 15
  5. 14
  1. 13
  2. 12
  3. 11
  4. 10
  1. 19 beta
  2. 20 dev

速览

当 dblink 的连接选项不在接受的 dblink/libpq 选项集合中时，会使用 HV00J。dblink 是独立的 contrib 客户端 API，不是 FDW 回调实现；18.6 核心与 contrib 扫描没有解析出其他 HV00J 报告组。

含义与消息

在 dblink 的选项解析路径中，ERROR 的主消息为 invalid option "%s"。只有找到相近名称时才提示 Perhaps you meant the option "%s".；若存在合法选项但没有相近候选，源码不发送 hint；只有不存在任何合法选项时才提示 There are no valid options in this context.。固定的 REL9_6_24 dblink 快照显示较早的动态 Valid options in this context are: %s 提示；这只是有界比较，不代表精确的切换版本。

诊断

确认该选项属于 dblink 连接字符串或选项列表，并查看安装版本对应的 libpq 选项名称。保留确切选项名、dblink/libpq 版本，以及错误是否发生在解析连接定义时。不要把 postgres_fdw 的选项表用于 dblink。

处理

改用 dblink/libpq 支持的名称，或删除该选项，并保留相近名称提示作为线索。重新校验连接定义即可；无效选项名称是确定性的，不需要重试数据库事务。

诊断边界

确认的实现是 dblink 的选项解析器。本批没有运行自然环境实验，源码证据也不表示远端连接已经成功或失败。

报文模板

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

HINT Perhaps you meant the option "%s".
HINT There are no valid options in this context.
主消息 · observed invalid option "%s"

来源：contrib/dblink/dblink.c @ REL_18_6

适用范围：When valid options exist but no close match is found, the source emits no hint; the no-valid-options hint is only used when no valid option exists.

HINT Valid options in this context are: %s
主消息 · observed invalid option "%s"

来源：contrib/dblink/dblink.c @ REL9_6_24

版本

该条件从 9.1.0 到 18.6 以及 19 Beta 3 均存在。固定的 18.6 与 REL9_6_24 dblink 快照显示了不同的提示措辞；它们界定已观察版本，但不确定切换版本。解读日志时应匹配实际安装版本。

来源

证据

断言

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

  • HV00J is fdw_option_name_not_found in SQL/MED Class HV.

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

    来源src/backend/utils/errcodes.txt

  • dblink uses HV00J in its own connection-option parser; dblink is a separate contrib client API rather than an FDW callback implementation.

    核实方式Read the fixed option-validation branch.

    来源contrib/dblink/dblink.c

  • The fixed REL9_6_24 dblink option parser uses the older dynamic hint 'Valid options in this context are: %s' with the same invalid-option ERROR; this is a bounded snapshot comparison, not an exact transition release.

    核实方式Read the fixed REL9_6_24 dblink.c error branch at lines 2017-2021.

    不覆盖This fixed snapshot establishes dblink's wording there; it does not date the transition or generalize to other clients.

    来源contrib/dblink/dblink.c

同类 SQL 状态码

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