HV00Q — fdw_schema_not_found

速览 {#at-a-glance}

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

含义与消息 {#meaning}

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；连接或查询错误会在更早路径报告，后续远端权限则是导入成功后的另一项检查。

诊断 {#diagnosis}

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

处理 {#response}

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

消息与诊断 {#messages}

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

版本 {#versions}

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

相关 {#related}

HV00P 表示包装器不支持模式导入；3D000 是本地数据库不存在；HV00D 涉及无效包装器选项。

来源 {#sources}

• errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba。
• postgres_fdw.c — 远端 pg_namespace 查询、结果检查与消息。
• 事务与保存点恢复 — 显式事务恢复边界；固定 xact.sgml SHA-256 b48fbe8bd02ce3d1181a350c88c8baa6e11c73edc90a936e77b180daef328c5c。
• 结构化证据 — 来源路径和消息分组。

来源

• 上游源码 doc/src/sgml/xact.sgml PG18-docs 724edf9bd b48fbe8b
• 上游源码 src/backend/utils/errcodes.txt REL_18_6 724edf9bd 6e8de346
• 上游源码 contrib/postgres_fdw/postgres_fdw.c REL_18_6 724edf9bd 5f61f89f
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8