// PostgreSQL-Fehlerreferenz

PostgreSQL 42P01: Relation existiert nicht

PostgreSQL kann die Tabelle, Ansicht oder Sequenz nicht finden. Normalerweise liegt es am falschen Schema im search_path, an einem in Anführungszeichen gesetzten Namen mit gemischter Groß-/Kleinschreibung oder an der falschen Datenbank.

SQLSTATE
42P01
Name
undefined_table
Kategorie
Syntaxfehler oder Zugriffsregelverletzung
Fehlermeldung
relation "orders" does not exist
LINE 1: SELECT * FROM orders;
                      ^

Was es bedeutet

In PostgreSQL ist eine Relation jedes tabellenähnliche Objekt: eine Tabelle, eine Ansicht, eine materialisierte Ansicht, eine Sequenz, ein Index oder eine Fremdtabelle. 42P01 heißt, dass der von dir benutzte Name auf keines davon auflöst, in den Schemas, die in deinem search_path aufgelisteten Schemata aufgelöst werden kann (oder in dem Schema, das du explizit angegeben hast).

PostgreSQL wandelt nicht in Anführungszeichen gesetzte Namen in Kleinbuchstaben um. Eine Tabelle, die erstellt wurde als "Orders" (in Anführungszeichen, großes O) kann nur referenziert werden als "Orders", sodass SELECT * FROM Orders sucht nach orders und schlägt fehl.

Häufige Ursachen

  • Die Tabelle liegt in einem Schema, das nicht auf dem search_path, zum Beispiel sales.orders während der Pfad "$user", public.
  • Die Tabelle wurde mit einem in Anführungszeichen gesetzten Namen in gemischter Groß-/Kleinschreibung erstellt (üblich bei ORMs und GUI-Tools), und die Abfrage setzt ihn nicht in Anführungszeichen.
  • Du bist mit einer anderen Datenbank verbunden als der, die die Tabelle enthält. PostgreSQL kann mit einem simplen Namen nicht über Datenbankgrenzen hinweg abfragen.
  • Die Tabelle wurde noch nicht angelegt, eine Migration ist fehlgeschlagen oder ist in einer anderen Datenbank gelaufen.
  • Ein Tippfehler im Tabellennamen.

Wie du es behebst

  1. Prüfe, wo du dich befindest und wie dein Suchpfad aussieht.

    SELECT current_database(), current_schema();
    SHOW search_path;
  2. Finde die Tabelle, egal mit welchem Schema oder welcher Schreibweise.

    SELECT table_schema, table_name
    FROM information_schema.tables
    WHERE lower(table_name) = 'orders';
  3. Qualifiziere den Namen mit seinem Schema oder füge das Schema zum Suchpfad hinzu.

    SELECT * FROM sales.orders;
    SET search_path TO sales, public;
    -- permanently for a role:
    ALTER ROLE app SET search_path TO sales, public;
  4. Wurde die Tabelle mit Großbuchstaben angelegt, setz sie genau so in Anführungszeichen - oder benenn sie einmal in Kleinschreibung um, damit sie nie wieder Anführungszeichen braucht.

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

Sicher reproduzieren

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

Fragen

Die Tabelle existiert, warum meint PostgreSQL dann, die Relation existiere nicht?

Fast immer liegt es am Schema oder an der Groß-/Kleinschreibung. Entweder ist das Schema der Tabelle nicht auf deinem search_path, oder sie wurde mit einem gemischten Namen in Anführungszeichen erstellt und muss genauso zitiert werden. Eine Abfrage von information_schema.tables mit lower(table_name) zeigt das echte Schema und die richtige Schreibweise.

Kann ich Daten aus einer Tabelle in einer anderen Datenbank abfragen?

Nicht direkt. Jede PostgreSQL-Verbindung gehört zu genau einer Datenbank. Nimm die Erweiterungen postgres_fdw oder dblink, oder verbinde dich mit der anderen Datenbank.

Zugehörige Fehler

Weitere Syntaxfehler oder Verletzungen von Zugriffsregeln

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.