// Référence des erreurs PostgreSQL

PostgreSQL 42710 : objet dupliqué

Une instruction CREATE a utilisé un nom déjà pris par un rôle, une contrainte, une extension, un trigger, un type ou un autre objet non-table.

SQLSTATE
42710
Nom
duplicate_object
Catégorie
Erreur de syntaxe ou violation de règle d'accès
Message d'erreur
role "app" already exists

Ce que cela signifie

42710 (duplicate_object) est l'erreur « déjà existant » pour les objets autres que les tables et autres relations (42P07), les bases de données (42P04), les schémas (42P06) et les fonctions (42723). Les messages typiques sont role "app" already exists, constraint "orders_pkey" for relation "orders" already exists, extension "pgcrypto" already exists et trigger "set_updated_at" for relation "orders" already exists.

Cela signifie presque toujours qu'un script d'installation ou de migration s'exécute une deuxième fois.

Causes courantes

  • Réexécution d'un script d'installation qui crée des rôles, des extensions ou des types.
  • Une migration ajoutant une contrainte ou un déclencheur qu'une migration précédente ou un changement manuel a déjà ajouté.
  • Restauration d'un dump dans une base de données ou un cluster où les objets existent déjà.

Comment le corriger

  1. Utilisez IF NOT EXISTS là où la commande le permet.

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    CREATE TABLE IF NOT EXISTS t (id int);
  2. Les rôles, les contraintes et les types n'ont pas de IF NOT EXISTS; vérifiez d'abord dans un DO bloc.

    DO $$
    BEGIN
        IF NOT EXISTS (SELECT FROM pg_roles WHERE rolname = 'app') THEN
            CREATE ROLE app LOGIN;
        END IF;
    END;
    $$;
  3. Pour les déclencheurs, remplacez-les directement (PostgreSQL 14 et versions ultérieures).

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

Reproduisez-le en toute sécurité

CREATE EXTENSION plpgsql;  -- ERROR: extension "plpgsql" already exists

Erreurs liées

Plus d'erreurs de syntaxe ou de violation de règle d'accès

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.