↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / SQLSTATE

HV00N — fdw_unable_to_establish_connection

包装器无法与外部数据源建立连接。

英文手册覆盖始于 PostgreSQL 8.1. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

aliases
未知
class name
Foreign Data Wrapper Error (SQL/MED)
condition name
fdw_unable_to_establish_connection
lang
en
sqlstate
HV00N

版本定义 PG 18

HV00N — fdw_unable_to_establish_connection

速览 {#at-a-glance}

HV00N 表示 FDW 在需要连接时未能建立连接。已检查的 PostgreSQL 18.6 核心与 contrib 调用没有解析出直接的 HV00N 报告组;检查到的 postgres_fdw 和 dblink 路径使用了其他 SQLSTATE,不能作为本条件的实现证据。

含义 {#meaning}

条件名描述连接建立阶段,但类别定义没有说明连接由哪个 FDW、驱动或外部服务管理,也没有指定 DNS、认证、网络或资源原因。

消息与诊断 {#messages}

没有解析出直接的 18.6 核心或 contrib 消息。保留包装器和驱动版本、连接选项(隐藏凭据)、连接建立阶段、外部服务器,以及完整的 detail 和 hint。实际 SQLSTATE 应以运行中的包装器为准。

诊断 {#diagnosis}

定位实际包装器的连接函数,按其日志区分解析选项、建立套接字、认证和会话初始化。检查外部服务器地址、映射用户和驱动日志;不要把所有连接错误归入 HV00N。

处理 {#response}

按实际诊断修复地址、认证、网络或包装器配置,并在连接状态明确后重新执行安全的操作。若请求可能已经到达远端,先确认远端状态再重试;不要只因条件名就重装扩展或反复重连。

版本 {#versions}

HV00N 从 9.1.0 到 18.6 以及 19 Beta 3 均存在。可用的 9.1 之前定义扫描没有观察到它;这是历史资料边界。

相关 {#related}

HV00J 是 dblink 的选项名未找到;HV00B 是无效句柄;08001 是客户端连接异常类别中的常见条件。

来源 {#sources}

  • errcodes.txt — 定义,SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba。
  • fdwapi.h — 通用回调接口边界。
  • 结构化证据 — 有界源码扫描。

比较版本

SQLSTATE 证据与已记录的运行版本

claims · identity
{
  "claim_id": "identity",
  "limits": "",
  "method": "Read the fixed definition row and macro.",
  "position": 0,
  "runtime": [],
  "sources": [
    "src.errcodes.18.6"
  ],
  "statement": "HV00N is fdw_unable_to_establish_connection in SQL/MED Class HV."
}
claims · scan-boundary
{
  "claim_id": "scan-boundary",
  "limits": "The generic FDW API boundary does not identify an emitter for this SQLSTATE. The scan does not cover external wrappers, drivers, remote systems, or user callbacks.",
  "method": "Compare resolved report groups with the macro mapping.",
  "position": 1,
  "runtime": [],
  "sources": [
    "src.calls.REL_18_6",
    "src.fdwapi.18.6"
  ],
  "statement": "No direct HV00N report group was resolved in the locked PostgreSQL 18.6 core/contrib call scan."
}
sources · src.errcodes.18.6
{
  "commit": "724edf9bde9d356724ad384a2e196edc3c9f80f7",
  "docs_url": "",
  "kind": "upstream_source",
  "location": "",
  "path": "src/backend/utils/errcodes.txt",
  "position": 0,
  "sha256": "6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba",
  "source_id": "src.errcodes.18.6",
  "tag": "REL_18_6",
  "url": "https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/errcodes.txt"
}
sources · src.fdwapi.18.6
{
  "commit": "724edf9bde9d356724ad384a2e196edc3c9f80f7",
  "docs_url": "",
  "kind": "upstream_source",
  "location": "",
  "path": "src/include/foreign/fdwapi.h",
  "position": 1,
  "sha256": "572ba892e6435ca92d3b3bc84dde5bbd3160cc3a082693daab8daa835c4d2cd7",
  "source_id": "src.fdwapi.18.6",
  "tag": "REL_18_6",
  "url": "https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/include/foreign/fdwapi.h"
}
sources · src.calls.REL_18_6
{
  "commit": "",
  "docs_url": "",
  "kind": "local_artifact",
  "location": "",
  "path": "raw/calls/REL_18_6.jsonl",
  "position": 2,
  "sha256": "9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf",
  "source_id": "src.calls.REL_18_6",
  "tag": "",
  "url": ""
}

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · english-manuals:ee2c8f843641301749955fb02d3a9238d3f473d9a22811718937d5c055bed997

正文语言: zh-Hans · english-manuals:ee2c8f843641301749955fb02d3a9238d3f473d9a22811718937d5c055bed997