// Referencia de errores de PostgreSQL

PostgreSQL 42P01: la relación no existe

PostgreSQL no encuentra la tabla, la vista o la secuencia. Suele ser por un esquema incorrecto en el search_path, un nombre con mayúsculas y minúsculas entre comillas o una base de datos incorrecta.

SQLSTATE
42P01
Nombre
undefined_table
Categoría
Error de sintaxis o violación de regla de acceso
Mensaje de error
relation "orders" does not exist
LINE 1: SELECT * FROM orders;
                      ^

Qué significa

En PostgreSQL, una relación es cualquier objeto similar a una tabla: una tabla, vista, vista materializada, secuencia, índice o tabla foránea. 42P01 significa que el nombre que usaste no corresponde a ninguno de ellos, en los esquemas listados en tu search_path (o en el esquema que especificaste explícitamente).

PostgreSQL convierte los nombres sin comillas a minúsculas. Una tabla creada como "Orders" (entre comillas, con la O en mayúscula) solo puede mencionarse como "Orders", así que SELECT * FROM Orders busca orders y falla.

Causas comunes

  • La tabla está en un esquema que no figura en la search_path, por ejemplo sales.orders mientras que la ruta es "$user", public.
  • La tabla se creó con un nombre con mayúsculas y minúsculas entre comillas (algo común con ORMs y herramientas GUI) y la consulta no lo pone entre comillas.
  • Estás conectado a una base de datos distinta de la que contiene la tabla. PostgreSQL no puede consultar entre bases de datos con un nombre sin calificar.
  • La tabla aún no se ha creado, o una migración falló o se ejecutó en otra base de datos.
  • Un error tipográfico en el nombre de la tabla.

Cómo solucionarlo

  1. Verifica dónde estás y cuál es tu ruta de búsqueda.

    SELECT current_database(), current_schema();
    SHOW search_path;
  2. Encuentra la tabla, sin importar su esquema ni el uso de mayúsculas.

    SELECT table_schema, table_name
    FROM information_schema.tables
    WHERE lower(table_name) = 'orders';
  3. Califica el nombre con su esquema, o añade el esquema al search path.

    SELECT * FROM sales.orders;
    SET search_path TO sales, public;
    -- permanently for a role:
    ALTER ROLE app SET search_path TO sales, public;
  4. Si la tabla se creó con mayúsculas, escribe su nombre exacto entre comillas, o renómbrala una vez a minúsculas para no tener que usar comillas nunca más.

    SELECT * FROM "Orders";
    ALTER TABLE "Orders" RENAME TO orders;

Reprodúcelo de forma segura

SELECT * FROM table_that_does_not_exist;  -- ERROR: relation "table_that_does_not_exist" does not exist

Preguntas

La tabla existe: ¿por qué PostgreSQL dice que la relación no existe?

Casi siempre es el esquema o las mayúsculas y minúsculas. O el esquema de la tabla no está en tu search_path, o la tabla se creó con un nombre con mayúsculas y minúsculas mezcladas entre comillas y debe entrecomillarse igual. Consultar information_schema.tables con lower(table_name) muestra su esquema y ortografía reales.

¿Puedo seleccionar datos de una tabla de otra base de datos?

No directamente. Cada conexión de PostgreSQL va a una sola base de datos. Usa las extensiones postgres_fdw o dblink, o conéctate a la otra base de datos.

Errores relacionados

Más errores de sintaxis o de violación de reglas de acceso

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.