# HV091 — fdw_invalid_descriptor_field_identifier

> PostgreSQL SQLSTATE HV091 表示 FDW 描述符字段标识符无效；描述符 API 和字段命名空间必须来自具体实现。
---

# HV091 — fdw_invalid_descriptor_field_identifier

## 速览 {#at-a-glance}

`HV091` 表示 FDW 边界无法使用某个描述符字段标识符。锁定的 PostgreSQL 18.6 核心与 contrib 调用扫描没有解析出 `HV091` 报告组，因此不能确认具体描述符命名空间或消息。

<!-- BEGIN SQLSTATE FACTS: generated by scripts/generate.py; do not edit -->

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `HV091` |
| 条件名 | `fdw_invalid_descriptor_field_identifier` |
| 状态 | `有效` |
| 已知存在于 | `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_INVALID_DESCRIPTOR_FIELD_IDENTIFIER` |
| 别名 | `—` |

<!-- source facts: data/errcodes/HV091.json -->
<!-- END SQLSTATE FACTS -->

## 含义 {#meaning}

字段标识符可能在包装器管理的接口中选择名称、类型、长度或其他描述符属性。通用 FDW 回调签名没有定义此 SQLSTATE 的字段命名空间。

## 消息与诊断 {#messages}

没有解析出 18.6 核心与 contrib 的直接消息变体。保留完整诊断、描述符类型、字段标识符、消息中出现的期望命名空间、回调阶段和包装器/驱动版本。

## 诊断 {#diagnosis}

识别描述符生产者和消费者，再按该实现的文档或源码比较字段标识符。除非包装器明确规定映射，否则不要把它替换成列序号。

## 处理 {#response}

使用实际描述符接口支持的字段标识符；只有源码证实存在生产者/消费者版本不匹配时，才调整相应版本。重复同一查找不能使未知标识符生效。

## 版本 {#versions}

`HV091` 在锁定定义快照 9.1.24 至 18.6 以及 19 Beta 3 中存在，`known_present_by` 为 9.1.0。现有 9.1 之前定义资料不足以确定精确引入版本。

## 相关 {#related}

[`HV021`](../hv021/) 涉及描述符信息不一致；[`HV008`](../hv008/) 涉及 FDW 列序列；[`HV090`](../hv090/) 涉及字符串或缓冲区长度。

## 来源 {#sources}

- [`errcodes.txt`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/errcodes.txt#L469) — 定义，SHA-256 `6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba`。
- [`fdwapi.h`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/include/foreign/fdwapi.h#L24-L55) — 通用 FDW 回调接口边界。
- [结构化证据](../../data/evidence/hv091.json) — 18.6 固定来源与有界扫描。