// PostgreSQL-Fehlerreferenz

PostgreSQL 42710: doppeltes Objekt

Eine CREATE-Anweisung verwendete einen Namen, den bereits eine Rolle, ein Constraint, eine Erweiterung, ein Trigger, ein Typ oder ein anderes Nicht-Tabellen-Objekt verwendet.

SQLSTATE
42710
Name
duplicate_object
Kategorie
Syntaxfehler oder Zugriffsregelverletzung
Fehlermeldung
role "app" already exists

Was es bedeutet

42710 (duplicate_object) ist der Fehler „existiert bereits“ für Objekte außer Tabellen und anderen Relationen (42P07), Datenbanken (42P04), Schemas (42P06) und Funktionen (42723). Typische Meldungen sind role "app" already exists, constraint "orders_pkey" for relation "orders" already exists, extension "pgcrypto" already exists und trigger "set_updated_at" for relation "orders" already exists.

Es bedeutet fast immer, dass ein Setup- oder Migrationsskript ein zweites Mal ausgeführt wird.

Häufige Ursachen

  • Erneutes Ausführen eines Setup-Skripts, das Rollen, Erweiterungen oder Typen erstellt.
  • Eine Migration, die eine Einschränkung oder einen Trigger hinzufügt, die eine frühere Migration oder eine manuelle Änderung bereits hinzugefügt hat.
  • Wiederherstellen eines Dumps in eine Datenbank oder einen Cluster, in dem die Objekte bereits existieren.

Wie du es behebst

  1. Verwende IF NOT EXISTS wo der Befehl es unterstützt.

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    CREATE TABLE IF NOT EXISTS t (id int);
  2. Rollen, Constraints und Typen haben keine IF NOT EXISTS; prüfe zuerst in einer DO Block meldet.

    DO $$
    BEGIN
        IF NOT EXISTS (SELECT FROM pg_roles WHERE rolname = 'app') THEN
            CREATE ROLE app LOGIN;
        END IF;
    END;
    $$;
  3. Bei Triggern ersetzt du sie direkt (ab PostgreSQL 14).

    CREATE OR REPLACE TRIGGER set_updated_at
        BEFORE UPDATE ON orders
        FOR EACH ROW EXECUTE FUNCTION touch_updated_at();

Sicher reproduzieren

CREATE EXTENSION plpgsql;  -- ERROR: extension "plpgsql" 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.