// PostgreSQL-Fehlerreferenz

PostgreSQL 42P07: Relation existiert bereits

CREATE TABLE, INDEX, VIEW oder SEQUENCE hat einen Namen verwendet, den ein tabellenähnliches Objekt in diesem Schema bereits hat.

SQLSTATE
42P07
Name
duplicate_table
Kategorie
Syntaxfehler oder Zugriffsregelverletzung
Fehlermeldung
relation "orders" already exists

Was es bedeutet

Tabellen, Ansichten, materialisierte Ansichten, Sequenzen, Indizes und Fremdtabellen teilen sich pro Schema einen Namensraum. Der Versuch, eines davon mit einem im Schema bereits belegten Namen zu erstellen, schlägt mit 42P07 fehl, selbst wenn das vorhandene Objekt von einer anderen Art ist (z. B. ein Index, der wie eine Tabelle heißt).

Das erneute Ausführen eines Migrations- oder Setup-Skripts ist der übliche Auslöser.

Häufige Ursachen

  • Ein Setup- oder Migrationsskript, das zuvor teilweise oder vollständig ausgeführt wurde.
  • Ein Index mit demselben Namen wie eine vorhandene Tabelle, Sicht oder ein vorhandener Index im Schema.
  • Zwei Migrationen, die dasselbe Objekt erstellen.
  • Eine temporäre Tabelle, die in derselben Sitzung übrig geblieben ist.

Wie du es behebst

  1. Mach das Skript idempotent mit IF NOT EXISTS.

    CREATE TABLE IF NOT EXISTS orders (id bigint PRIMARY KEY);
    CREATE INDEX IF NOT EXISTS orders_created_at_idx ON orders (created_at);
  2. Sieh, was den Namen aktuell trägt.

    SELECT n.nspname, c.relname, c.relkind
    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
    WHERE c.relname = 'orders';
  3. Soll das alte Objekt ersetzt werden, lösche es zuerst und prüfe vorher, dass nichts davon abhängt.

    DROP TABLE IF EXISTS orders_old;
    CREATE OR REPLACE VIEW order_summary AS SELECT 1 AS n;  -- views can be replaced in place

Sicher reproduzieren

CREATE TEMP TABLE t (id int);
CREATE TEMP TABLE t (id int);  -- ERROR: relation "t" already exists

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.