ERROR: relation "clienti" already exists
Încerci să creezi un tabel, view, index sau secvență cu un nume care există deja în schema respectivă. Fie scriptul rulează a doua oară, fie numele e ocupat de alt obiect (un index și un tabel nu pot avea același nume). Folosește CREATE ... IF NOT EXISTS sau alege alt nume.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Tabelele, view-urile, view-urile materializate, indecșii, secvențele și tipurile compuse împart același spațiu de nume în fiecare schemă (sunt toate „relații” în pg_class). Mesajul apare când creezi un obiect cu un nume deja folosit, chiar de un obiect de alt fel: un index numit comenzi intră în conflict cu tabelul comenzi.
Cel mai des, un script de inițializare rulează a doua oară. Pentru scripturi idempotente există CREATE TABLE IF NOT EXISTS, CREATE INDEX IF NOT EXISTS, CREATE OR REPLACE VIEW, care dau doar un NOTICE dacă obiectul există. Atenție: IF NOT EXISTS nu verifică dacă structura e aceeași; un tabel vechi cu alte coloane rămâne neschimbat. Pentru evoluția schemei, folosește un instrument de migrări (Flyway, Liquibase, Alembic), care ține evidența scripturilor aplicate.
De ce apare: cauzele frecvente
1Script rulat de două ori
CREATE TABLE clienti (...);CREATE TABLE IF NOT EXISTS clienti (...);A doua rulare dă doar un NOTICE.
2Index cu numele unui tabel
CREATE INDEX comenzi ON comenzi (client_id);CREATE INDEX comenzi_client_id_idx ON comenzi (client_id);Indecșii și tabelele împart același spațiu de nume.
Repară eroarea, direct în pagină
Scriptul de inițializare a bazei de date rulează la fiecare pornire a aplicației, iar a doua rulare dă relation "jurnal" already exists. Fă crearea tabelului idempotentă, apoi inserează un rând și afișează numărul de rânduri din jurnal.
CREATE TABLE jurnal (id int GENERATED ALWAYS AS IDENTITY PRIMARY KEY, mesaj text);
INSERT INTO jurnal (mesaj) VALUES ('a doua pornire');
SELECT count(*) FROM jurnal;NOTICE: relation "jurnal" already exists, skipping
CREATE TABLE
INSERT 0 1
count
-------
2
(1 rând)Indiciu
CREATE TABLE IF NOT EXISTS
Reparația
CREATE TABLE IF NOT EXISTS jurnal (id int GENERATED ALWAYS AS IDENTITY PRIMARY KEY, mesaj text);
INSERT INTO jurnal (mesaj) VALUES ('a doua pornire');
SELECT count(*) FROM jurnal;De ce merge
IF NOT EXISTS transformă eroarea într-un NOTICE când tabelul există deja, deci scriptul poate fi rulat de oricâte ori. Rândul inserat de setup rămâne, iar al doilea se adaugă, deci jurnalul are 2 rânduri. Structura tabelului existent nu este verificată, de aceea migrările rămân necesare pentru schimbări.
Alte forme ale mesajului
ERROR: relation "comenzi_client_id_idx" already exists
Cum o eviți pe viitor
- Fă scripturile de inițializare idempotente cu
IF NOT EXISTSsauCREATE OR REPLACE. - Folosește un instrument de migrări pentru schimbările de schemă.
- Adoptă o convenție de nume pentru indecși (
tabel_coloana_idx) și constrângeri. - Verifică existența cu
to_regclass('nume')în scripturi condiționale.
Întrebări frecvente
IF NOT EXISTS verifică și coloanele?
Nu. Verifică doar numele. Un tabel existent cu altă structură rămâne așa.
Pot avea două tabele cu același nume?
Da, în scheme diferite (vanzari.clienti și public.clienti). search_path decide pe care îl găsești fără schemă.
Erori înrudite
ERROR: column "telefon" of relation "clienti" already exists Migrarea adaugă o coloană care există deja în tabel, de obicei pentru că scriptul a rulat de două ori sau coloana a fost adăugată manual. Folosește ADD COLUMN IF NOT EXISTS sau verifică starea schemei înainte de migrare. ERROR: relation "produse" does not exist PostgreSQL nu găsește tabelul (sau view-ul, secvența) cu acest nume în schemele din search_path. Verifică dacă tabelul există, dacă ești conectat la baza de date corectă, dacă e într-o altă schemă și dacă a fost creat cu majuscule între ghilimele. ERROR: schema "vanzari" does not exist Folosești un nume calificat (vanzari.comenzi) sau creezi un obiect într-o schemă care nu există. Schemele se creează explicit, cu CREATE SCHEMA. Verifică numele (scris corect, cu majusculele potrivite) sau creează schema înainte. Învață PostgreSQL de la zero, cu exerciții la fiecare lecție
Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
