↑↓ select ↵ open ⌫ change scope Open full search

PG.CENTER connects PostgreSQL documentation, reference, and ecosystem knowledge. Maintained by Pigsty.

SQLSTATE / CLASS HV · FOREIGN DATA WRAPPER ERROR (SQL/MED)

HV091

Read PG 18 manual ↗

fdw_invalid_descriptor_field_identifier

SQLSTATE
HV091
Condition name
fdw_invalid_descriptor_field_identifier
Class
Foreign Data Wrapper Error (SQL/MED)
Source macro
ERRCODE_FDW_INVALID_DESCRIPTOR_FIELD_IDENTIFIER
Evidence
Definition only
Analysis & operational context

English SQLSTATE atlas: authored explanations and source/runtime evidence are separate from the manual definitions. View source ↗

<h1>HV091 — fdw_invalid_descriptor_field_identifier</h1>

At a glance

HV091 identifies a descriptor field identifier that an FDW boundary cannot use. No resolved HV091 report group was found in the locked PostgreSQL 18.6 core/contrib call scan, so no particular descriptor namespace or message is confirmed.

Meaning

A field identifier may select a name, type, length, or other descriptor property in a wrapper-owned interface. Generic FDW callback signatures do not define this SQLSTATE's field namespace.

Messages and diagnostics

No resolved 18.6 core/contrib message variant was found. Preserve the full diagnostic, descriptor kind, field identifier, expected namespace if reported, callback phase, and wrapper/driver version.

Diagnosis

Identify the descriptor producer and consumer, then compare the requested field identifier with that implementation's documented or source-defined fields. Do not replace it with a column ordinal unless the wrapper explicitly defines that mapping.

Response

Use the field identifier supported by the actual descriptor interface, or correct the producer/consumer version mismatch when source evidence shows one. Repeating the same lookup cannot make an unknown identifier valid.

Versions

HV091 is present in the locked definition snapshots from 9.1.24 through 18.6 and 19 Beta 3, with known_present_by 9.1.0. The available pre-9 definition material does not establish an exact introduction release.

Sources

  • errcodes.txt — definition, SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba.
  • fdwapi.h — generic FDW callback boundary.
  • Structured evidence — fixed 18.6 sources and bounded scan.

Source evidence

Evidence belongs to the frozen source and runtime versions listed here. It is not a runtime verification of the selected manual version.

HV091 is fdw_invalid_descriptor_field_identifier in SQL/MED Class HV.

Method: Read the fixed errcodes definition row and macro.

src.errcodes.18.6

The condition name identifies an invalid FDW descriptor field identifier. The field namespace and descriptor interface remain implementation-specific.

Method: Read the fixed FDW callback signatures and FdwRoutine structure.

Limits: Generic API context is background only and does not prove an emitting path for this SQLSTATE.

src.fdwapi.18.6

No resolved HV091 report group was found in the locked PostgreSQL 18.6 core/contrib call scan.

Method: Compare resolved report groups with the fixed macro mapping.

Limits: This scan does not cover external wrappers, drivers, remote systems, or user callbacks; absence from the scan is not an absolute absence claim.

src.calls.REL_18_6 src.errcodes.18.6

The locked release definition snapshots establish presence from the known 9.1.0 boundary; the available pre-9 material does not establish an exact introduction release.

Method: Compare the canonical release-definition facts with the available pre-9 source boundary.

Limits: Definition presence does not prove runtime use.

src.errcodes.18.6

Message templates

No extracted message template is attached to this condition.

Reproduction & repair cases

No reproduction case is attached to this condition.

Recorded runtime evidence

No runtime observation is attached to this entry.

Version history 1
  1. PG 9.0 → 9.1added

Definition snapshot: english-manuals:d7e89eb9505962301e33c92baaa… · English manual source