Fdw Column Name Not Found — SQLSTATE HV005

SQLSTATE HV005 condition fdw_column_name_not_found class HV — Foreign Data Wrapper Error (SQL/MED) severity ERROR
Reproduced & verified on PostgreSQL 14.23, 15.18, 16.14, 17.10 and 18.4 — identical message on every version.
Last reviewed 29 May 2025 · Reproduced live with the SQL on this page.

! Symptoms Free

The server reports SQLSTATE HV005 (fdw_column_name_not_found), a condition in the Foreign Data Wrapper Error (SQL/MED) class.

  • The error is written to the server log and returned to the client carrying SQLSTATE HV005.
  • Any driver (libpq, JDBC, psycopg, npgsql, pgx) surfaces this code in its error object so you can branch on it programmatically.
  • PL/pgSQL can trap it by name: EXCEPTION WHEN fdw_column_name_not_found THEN.

1 Environment & reproduce Free

Severity: ERROR  |  PostgreSQL versions: 12, 13, 14, 15, 16, 17

Reproduce with the exact statement and read the full message in the server log (raise log_min_messages / set log_min_error_statement for more context).

? Root cause Free

HV005 belongs to Class HV — Foreign Data Wrapper Error (SQL/MED). In this class, a foreign data wrapper (SQL/MED) operation failed.

The first two characters (HV) identify the error class, so application code can match the whole class via HV000 when the specific code is not needed.

3 Recovery & verify Free

Check the foreign server connection and options, credentials in the user mapping, and that the remote object exists and is reachable.

Reference: PostgreSQL error codes — Class HV (Foreign Data Wrapper Error (SQL/MED)).