# HV00R — fdw_table_not_found

> PostgreSQL SQLSTATE HV00R 表示 FDW 边界上的表未找到条件；涉及哪次表查找以及如何诊断取决于实际包装器。
---

# HV00R — fdw_table_not_found

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

`HV00R` 表示 FDW 类别中的表未找到条件。锁定的 PostgreSQL 18.6 核心与 contrib 调用扫描没有解析出 `HV00R` 报告组，因此不能据此指定核心发射点、远端目录或消息模板。

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

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `HV00R` |
| 条件名 | `fdw_table_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_TABLE_NOT_FOUND` |
| 别名 | `—` |

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

## 含义 {#meaning}

该条件名指向 FDW 操作无法满足的一次表查找。表可能是远端对象、包装器侧映射或其他实现管理的名称；SQLSTATE 定义本身无法在它们之间作出选择。

## 消息与诊断 {#messages}

没有解析出 18.6 核心与 contrib 的直接 `HV00R` 消息变体。解释前应保留完整诊断、包装器和驱动版本、外部服务器与表身份、操作阶段，以及远端返回的消息。

## 诊断 {#diagnosis}

定位已安装包装器的表查找函数及其 SQLSTATE 映射。检查确切的外部表或远端关系名、数据库/模式上下文、映射用户，以及错误发生在规划、执行还是元数据发现阶段。不要把每个零行查询都理解为此条件。

## 处理 {#response}

修正包装器诊断所指向的表或映射，或改用操作实际指定的远端对象和服务器。如果无法确定此前写操作是否完成，应先检查远端状态再重做；无关的 FDW 选项变化不能解释此条件。

## 版本 {#versions}

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

## 相关 {#related}

[`HV021`](../hv021/) 涉及描述符信息不一致；[`HV010`](../hv010/) 涉及 FDW 函数顺序；[`HV00Q`](../hv00q/) 是具体的 postgres_fdw 远端模式条件。

## 来源 {#sources}

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