HV005 — fdw_column_name_not_found（找不到外部列名）
PostgreSQL SQLSTATE HV005 表示包装器在远端或导入描述符中找不到外部列名。应检查元数据和名称映射。
HV005 — fdw_column_name_not_found
速览
HV005 表示包装器无法在相关远端或导入描述符中找到外部列名。18.6 核心/contrib 扫描没有解析出直接报告组，具体系统和报文必须从实际部署的包装器确认。
| 字段 | 值 |
|---|---|
| SQLSTATE | HV005 |
| 条件名 | fdw_column_name_not_found |
| 状态 | 有效 |
| 已知存在于 | 9.1.0 |
| 锁定快照 | 9.1.24, 9.2.24, 9.3.25, 9.4.26, 9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3 |
| 宏 | ERRCODE_FDW_COLUMN_NAME_NOT_FOUND |
| 别名 | — |
含义
这是 FDW 边界的名称查找问题：导入或规划得到的列名不在包装器正在使用的描述符中。它不同于外部表缺失，也不同于本地 SQL 的 42703。
报文与诊断
没有固定核心报文。保留准确列名、大小写/引号上下文、外部表或远端关系、包装器版本以及导入、规划、扫描还是修改阶段。
诊断
比较 pg_attribute 和包装器的远端元数据及名称转换规则；适用时重新做模式发现或检查导入映射。不能只凭本地目标列表推断远端列存在。
处理
修正外部表列定义或包装器名称映射，并按文档刷新远端模式元数据。描述符一致后再重试；事务重试不能创建缺失列。
版本
目录从 9.1.0 观察到该码，延续到 18.6 与 19 Beta 3；pre-9 定义文件未观察到它，精确引入未知。
相关
HV007 是名称无效；HV008 是序号无效；42703 是本地未定义列。
来源
errcodes.txt— 定义，SHA-2566e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba。fdwapi.h— 描述符回调边界。- 结构化证据 — 有界扫描与来源边界。