// PostgreSQL-Fehlerreferenz

PostgreSQL 3D000: Datenbank existiert nicht

Die Verbindung nennt eine Datenbank, die es auf diesem Server nicht gibt. Oft ein Tippfehler, eine abweichende Groß-/Kleinschreibung oder ein Client, der als Datenbanknamen voreingestellt den Benutzernamen nimmt.

SQLSTATE
3D000
Name
invalid_catalog_name
Kategorie
Ungültiger Katalogname
Fehlermeldung
database "shop" does not exist

Was es bedeutet

Jede PostgreSQL-Verbindung ist mit einer Datenbank verbunden, die im Verbindungsstring angegeben ist. Wenn auf dem erreichten Server keine Datenbank mit diesem Namen existiert, wird die Anmeldung mit 3D000 beendet.

Datenbanknamen unterscheiden Groß- und Kleinschreibung, wenn sie mit Anführungszeichen erstellt wurden, und viele Clients tragen automatisch einen Standardwert ein: psql und libpq verwenden den Benutzernamen als Datenbanknamen, wenn keiner angegeben ist, also psql -U app versucht, eine Datenbank namens app.

Häufige Ursachen

  • Ein Tippfehler oder eine Datenbank, die mit einem gemischten Groß-/Kleinschreibungsnamen in Anführungszeichen erstellt wurde, wie z. B. "Shop".
  • Keine Datenbank angegeben, daher hat der Client den Benutzernamen als Datenbanknamen verwendet.
  • Verbindung zu einem falschen Server oder Port (eine andere Instanz, ein anderer Container), wo die Datenbank nie erstellt wurde.
  • Die Datenbank wurde gelöscht oder von den Setup-Skripten noch nicht erstellt.

Wie du es behebst

  1. Mit einer Datenbank verbinden, die immer existiert, wie postgres, und liste die Datenbanken auf.

    -- psql -h db -U app -d postgres
    SELECT datname FROM pg_database ORDER BY datname;
  2. Lege die Datenbank an, falls sie existieren soll.

    CREATE DATABASE shop OWNER app;
  3. Gib den Datenbanknamen explizit in der Verbindungszeichenfolge an, zum Beispiel postgresql://app@db:5432/shop oder psql -d shop.

  4. Wenn sie mit Großbuchstaben angelegt wurde, nimm den exakten Namen. In einer URL oder -d Option sind keine Anführungszeichen erforderlich: psql -d Shop.

Fragen

Warum sagt psql, dass die Datenbank nicht existiert, wenn ich nur einen Benutzernamen angegeben habe?

Wenn keine Datenbank angegeben ist, verbindet sich psql mit einer Datenbank, die genauso heißt wie der Benutzer. Gib -d postgres oder die gewünschte Datenbank an.

Zugehörige Fehler

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.