HV004 fdw_invalid_data_type

外部数据包装器数据类型无效

ERROR 仅定义参考未实测

版本覆盖

HV004 表示 FDW 无法使用某个数据类型。18.6 核心及 contrib 调用扫描没有解析出直接报告组，因此不能指定自带包装器报文或自然 SQL 触发器。

包装器可能拒绝本地列类型、远端类型映射或值转换。FDW 文档说明，类型不匹配时可以报告错误，但没有规定统一映射或报文；不能把每个类型转换失败都归为此码。

没有确认的 18.6 核心报文。保留 M/D/H、源码函数、操作阶段、本地列类型、远端类型和包装器版本；远端服务器的类型错误要和包装器本地 SQLSTATE 区分。

确认列和转换方向，查看固定版本包装器的校验器、deparser 与元组转换代码，并比较本地目录类型、必要的 typmod/collation 和远端元数据。不要从通用 cast 或 22xxx 推断 HV004。

选择包装器支持的类型映射，或在确认数据兼容后修改外部表定义。若转换由外部扩展实现，应按兼容契约升级或配置；相同元数据下错误是确定性的，不能靠重试解决。

目录从 9.1.0 观察到该码，延续到 18.6 与 19 Beta 3；pre-9 定义扫描未观察到它，精确引入版本未知。

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

HV004 is fdw_invalid_data_type in Class HV.

核实方式Read the fixed definition row.

来源src/backend/utils/errcodes.txt
The FDW callback contract permits a wrapper to raise an error for a data-type mismatch, but the locked 18.6 core/contrib scan has no direct HV004 report group.

核实方式Read callback contract and compare resolved call groups.

不覆盖Concrete type mappings and messages belong to the installed wrapper. Generic API context and the absent resolved report group do not establish a source path emitting this SQLSTATE.

来源src/include/foreign/fdwapi.h · raw/calls/REL_18_6.jsonl