# HV021 — fdw_inconsistent_descriptor_information

> PostgreSQL SQLSTATE HV021 表示 FDW 描述符信息不一致；必须从包装器实现确定描述符和生产者。
---

# HV021 — fdw_inconsistent_descriptor_information

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

`HV021` 表示 FDW 描述符中的信息不一致。18.6 核心与 contrib 调用扫描没有解析出 `HV021` 报告组，因此不能指定核心描述符检查或消息。

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

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

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

## 含义 {#meaning}

描述符可能描述列、类型、名称、长度或其他包装器结果契约。`fdwapi.h` 展示回调和 slot 边界，但没有说明哪种描述符差异会映射到此 SQLSTATE。

## 消息与诊断 {#messages}

没有解析出 18.6 核心与 contrib 的直接消息变体。保留完整诊断、描述符类型、消息中出现的期望值和实际值、回调阶段、包装器/驱动版本及关系身份。

## 诊断 {#diagnosis}

比较包装器提供的描述符与回调或消费者期待的描述符。只有包装器或诊断明确支持时，才检查模式变化、类型与列顺序、可空性或长度元数据；不要从一般转换失败推断描述符不一致。

## 处理 {#response}

修正实际诊断所指向的包装器描述符构造或远端/模式契约，然后重新建立受影响的计划或对象。若元数据没有改变，重复同一操作不能修复描述符。

## 版本 {#versions}

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

## 相关 {#related}

[`HV008`](../hv008/) 涉及 FDW 列序列；[`HV091`](../hv091/) 涉及描述符字段标识符；[`HV024`](../hv024/) 涉及属性值。

## 来源 {#sources}

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