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

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

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

HV00Q fdw_schema_not_found

ERROR 源码确认 参考 未实测

类别
Class HV 外部数据包装器错误（SQL/MED）
严重等级
ERROR
条件名
fdw_schema_not_found
宏名称
ERRCODE_FDW_SCHEMA_NOT_FOUND
最早已知存在
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

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

速览

HV00Q 是具体的 postgres_fdw 导入错误。远端连接会按请求的 nspname 精确查询 pg_catalog.pg_namespace；结果行数不是恰好一行时，包装器按名称报告远端模式不存在。

含义与消息

postgres_fdw.c:5515-5526 的导入路径在映射的远端连接上发送 SELECT 1 FROM pg_catalog.pg_namespace WHERE nspname = ...，检查 PQntuples(res) != 1，再报告 ERROR: schema "%s" is not present on foreign server "%s"。请求的远端模式和服务器名称都是动态字段。这个固定查询不使用本地 search_path；连接或查询错误会在更早路径报告，后续远端权限则是导入成功后的另一项检查。

诊断

检查 IMPORT FOREIGN SCHEMA 的源名称、远端数据库、映射用户和 postgres_fdw 服务器选项。确认映射的远端连接能按精确名称执行固定的 pg_catalog.pg_namespace 查询；不要用本地 search_path 推断这一分支。将零行或异常行数与更早发生的连接/查询错误区分开，并在导入继续后另行检查远端模式和表权限。

处理

使用远端模式的确切名称，在适当时创建远端模式，或改用正确的外部服务器和数据库。自动提交时，只有远端目录状态或用户映射修正后才重新导入。显式事务中的 ERROR 会使本地事务失败；重试修正后的导入前，先执行 ROLLBACK，或回滚到此前已经建立且仍可用的保存点，不要在 INERROR 事务中重放命令。

消息与诊断

确认的调用组严重级别为 ERROR，主消息是 schema "%s" is not present on foreign server "%s"，没有 detail 或 hint。保留远端模式和服务器值，以及包装器版本。

报文模板

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

主消息 · observed schema "%s" is not present on foreign server "%s"

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

版本

HV00Q 从 9.1.0 到 18.6 以及 19 Beta 3 均存在。旧版本的措辞或目录查询细节可能不同；18.6 路径固定于指定提交。

来源

证据

断言

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

  • HV00Q is fdw_schema_not_found in SQL/MED Class HV.

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

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

  • postgres_fdw runs SELECT 1 FROM pg_catalog.pg_namespace WHERE nspname = <remote_schema> on the remote connection and emits HV00Q when that query does not return exactly one row.

    核实方式Read the fixed remote pg_namespace query and PQntuples result check.

    不覆盖The check uses the mapped remote connection and an exact nspname comparison; local search_path does not choose the schema. Connection or remote query errors are reported by an earlier path, and later schema/table privileges are separate from this existence check.

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

  • This source path reports ERROR; in an explicit local transaction, the caller must roll back the failed transaction or roll back to a deliberately established savepoint before sending another command.

    核实方式Combine the fixed ERROR severity with the PostgreSQL transaction and savepoint recovery documentation.

    不覆盖No natural postgres_fdw runtime was run in this batch; the transaction guidance is the general ERROR boundary, not a claim about a selected remote topology.

    来源 来源：contrib/postgres_fdw/postgres_fdw.c @ REL_18_6 · 来源：doc/src/sgml/xact.sgml @ PG18-docs

同类 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 起已知
包装器无法使用该描述符字段标识符。 有效