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
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 ejemplosales.ordersmientras 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
-
Verifica dónde estás y cuál es tu ruta de búsqueda.
SELECT current_database(), current_schema(); SHOW search_path;
-
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';
-
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;
-
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
42703la columna no existe3F000el esquema no existe3D000la base de datos no existe42501permiso denegado208SQL Server: Nombre de objeto no válido1146MySQL: la tabla no existeORA-00942Oracle: la tabla o vista no existe
Más errores de sintaxis o de violación de reglas de acceso
42601error de sintaxis en o cerca de42846no se puede forzar42803la columna debe aparecer en la cláusula GROUP BY42830clave foránea no válida42804incompatibilidad de tipos de datos42P18no se pudo determinar el tipo de datos del parámetro42883la función no existe42P02no hay parámetro
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.
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.