// Referencia de errores de PostgreSQL

PostgreSQL 3D000: la base de datos no existe

La conexión nombra una base de datos que no existe en este servidor. Suele ser un error tipográfico, una diferencia de mayúsculas y minúsculas, o un cliente que usa el nombre de usuario como nombre de base de datos por defecto.

SQLSTATE
3D000
Nombre
invalid_catalog_name
Categoría
Nombre de catálogo no válido
Mensaje de error
database "shop" does not exist

Qué significa

Cada conexión de PostgreSQL es a una única base de datos, la que se indica en la cadena de conexión. Si no existe una base de datos con ese nombre en el servidor al que llegaste, el inicio de sesión se detiene con 3D000.

Los nombres de bases de datos distinguen mayúsculas de minúsculas si se crean con comillas, y muchos clientes rellenan uno por defecto: psql y libpq usan el nombre de usuario como nombre de la base de datos cuando no se indica ninguno, así que psql -U app intenta abrir una base de datos llamada app.

Causas comunes

  • Un error tipográfico, o una base de datos creada con un nombre entre comillas y con mayúsculas y minúsculas mezcladas, como "Shop".
  • No se proporcionó ninguna base de datos, por lo que el cliente usó el nombre de usuario como nombre de la base de datos.
  • Conexión al servidor o puerto incorrecto (otra instancia, un contenedor diferente) donde la base de datos nunca se creó.
  • La base de datos fue eliminada o aún no ha sido creada por los scripts de configuración.

Cómo solucionarlo

  1. Conéctate a una base de datos que siempre exista, como postgres, y lista las bases de datos.

    -- psql -h db -U app -d postgres
    SELECT datname FROM pg_database ORDER BY datname;
  2. Crea la base de datos si debería existir.

    CREATE DATABASE shop OWNER app;
  3. Pasa el nombre de la base de datos explícitamente en la cadena de conexión, por ejemplo postgresql://app@db:5432/shop o psql -d shop.

  4. Si se creó con mayúsculas, usa el nombre exacto. En una URL o -d opción no hacen falta comillas: psql -d Shop.

Preguntas

¿Por qué psql dice que la base de datos no existe cuando solo di un nombre de usuario?

Cuando no se especifica una base de datos, psql se conecta a una base de datos con el mismo nombre que el usuario. Añade -d postgres o la base de datos que quieras.

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.