// Referencia de errores de PostgreSQL

PostgreSQL 3F000: el esquema no existe

Una instrucción menciona un esquema que no está en la base de datos actual, o crea un objeto cuando no existe ningún esquema en el search_path.

SQLSTATE
3F000
Nombre
invalid_schema_name
Categoría
Nombre de esquema no válido
Mensaje de error
schema "sales" does not exist

Qué significa

Los esquemas son espacios de nombres dentro de una base de datos. 3F000 significa que el esquema indicado en un nombre calificado (sales.orders) o en SET search_path no existe en la base de datos a la que te has conectado. Los nombres de esquema siguen las mismas reglas de mayúsculas y minúsculas que el resto de identificadores: los nombres sin entrecomillar se pasan a minúsculas.

Un caso relacionado es no schema has been selected to create in, cuando CREATE TABLE se ejecuta con un search_path que no contiene ningún esquema existente.

Causas comunes

  • El esquema no se ha creado en esta base de datos (cada base de datos tiene sus propios esquemas).
  • Un nombre de esquema con mayúsculas y minúsculas entre comillas como "Sales" referenciado sin comillas.
  • Conectado a la base de datos equivocada.
  • A search_path que nombra solo esquemas que no existen.

Cómo solucionarlo

  1. Enumera los esquemas de esta base de datos.

    SELECT nspname FROM pg_namespace ORDER BY nspname;
  2. Crea el esquema, opcionalmente con el rol de la aplicación como propietario.

    CREATE SCHEMA IF NOT EXISTS sales AUTHORIZATION app;
  3. Apunta la ruta de búsqueda a los esquemas que existen.

    SET search_path TO sales, public;

Reprodúcelo de forma segura

SELECT * FROM no_such_schema.t;  -- ERROR: schema "no_such_schema" does not exist

Errores relacionados

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.