HV002 — fdw_dynamic_parameter_value_needed

速览 {#at-a-glance}

HV002 表示 FDW 操作所需的参数值不可用。PostgreSQL 18.6 自带的 file_fdw 在外部表选项校验期间发现 filename 和 program 都没有提供时报告此码。

含义与触发路径 {#meaning}

contrib/file_fdw/file_fdw.c 的校验器检查 ForeignTableRelationId 的选项；两者都缺失时以 ERROR 报告 either filename or program is required for file_fdw foreign tables。条件名比这一实现更宽，其他包装器可能在规划、扫描或修改阶段需要不同参数并产生不同报文。

报文与诊断 {#messages}

18.6 固定变体来自 file_fdw_validator 第 345–350 行：ERROR: either filename or program is required for file_fdw foreign tables。固定的 9.1.24 源码使用 ERROR: filename is required for file_fdw foreign tables；两个源码模板都没有 detail 或 hint。这些都是本地选项校验错误，不表示远端程序启动失败。

诊断 {#diagnosis}

检查具体的 CREATE FOREIGN TABLE 或 ALTER FOREIGN TABLE ... OPTIONS 定义及包装器接受的选项名。对 file_fdw，确认有一个可用的源选项且服务器进程能访问其值；其他包装器应查其校验器或回调的参数契约。

处理 {#response}

按包装器要求补上正确拼写和权限的选项，或使用其支持的动态参数机制；随后重新校验。未改变 SQL 就重试不能生成缺失参数。

版本 {#versions}

目录从 9.1.0 观察到 HV002，延续到 18.6 和 19 Beta 3。固定的 9.1.24 file_fdw 源码使用 “filename is required”，固定的 18.6 源码使用 “either filename or program is required”，匹配报文时要看服务器版本；这里不声称具体的变更发布版本。

相关 {#related}

HV00D 是包装器不认识选项名；HV000 是通用包装器失败；HV005 是外部列缺失而非 FDW 选项缺失。

来源 {#sources}

• errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba。
• file_fdw.c — 校验条件与报文。
• 9.1.24 历史 file_fdw.c — 固定的 filename-only 校验报文，SHA-256 6f948ed8f9ffa6d1077b289f23c53eff02c5182492f0827b908c2be86026dad8。
• 结构化证据 — 源码路径与历史报文边界。

来源

• 上游源码 src/backend/utils/errcodes.txt REL_18_6 724edf9bd 6e8de346
• 上游源码 contrib/file_fdw/file_fdw.c REL_18_6 724edf9bd d79ec21c
• 上游源码 contrib/file_fdw/file_fdw.c REL9_1_24 e85493559 6f948ed8
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8