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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ALTER TABLE ... ADD COLUMN refuză un nume de coloană existent. Mesajul apare tipic când o migrare a rulat parțial (de exemplu primul pas a reușit, al doilea a eșuat, iar scriptul a fost relansat) sau când cineva a adăugat coloana direct pe server. Varianta column "x" specified more than once apare când același nume e scris de două ori în aceeași comandă.
ADD COLUMN IF NOT EXISTS face pasul idempotent: dă un NOTICE dacă coloana există. Ca la tabele, nu verifică tipul coloanei existente. În PostgreSQL, DDL-ul este tranzacțional, deci o migrare scrisă între BEGIN și COMMIT fie se aplică integral, fie deloc; asta elimină cazul migrărilor aplicate pe jumătate, care sunt sursa obișnuită a acestei erori.
De ce apare: cauzele frecvente
1Migrare relansată
ALTER TABLE clienti ADD COLUMN telefon text;ALTER TABLE clienti ADD COLUMN IF NOT EXISTS telefon text;A doua rulare nu mai dă eroare.
2Migrare care a eșuat la jumătate
ALTER TABLE clienti ADD COLUMN telefon text;
ALTER TABLE clienti ADD COLUMN cnp char(13) UNIQUE; -- eșueazăBEGIN;
ALTER TABLE clienti ADD COLUMN telefon text;
ALTER TABLE clienti ADD COLUMN cnp char(13) UNIQUE;
COMMIT;În tranzacție, eșecul anulează și primul pas.
Repară eroarea, direct în pagină
Migrarea care adaugă coloana telefon în clienti a fost rulată de două ori, iar a doua oară dă column "telefon" of relation "clienti" already exists. Fă pasul idempotent și afișează numele coloanelor tabelului clienti, în ordinea lor.
ALTER TABLE clienti ADD COLUMN telefon text;
SELECT column_name FROM information_schema.columns WHERE table_name = 'clienti' ORDER BY ordinal_position;NOTICE: column "telefon" of relation "clienti" already exists, skipping ALTER TABLE column_name ------------- id nume email oras telefon (5 rânduri)
Indiciu
ADD COLUMN IF NOT EXISTS
Reparația
ALTER TABLE clienti ADD COLUMN IF NOT EXISTS telefon text;
SELECT column_name FROM information_schema.columns WHERE table_name = 'clienti' ORDER BY ordinal_position;De ce merge
Setup-ul a adăugat deja coloana, la fel ca prima rulare a migrării. ADD COLUMN IF NOT EXISTS detectează coloana existentă și dă doar un NOTICE. Lista din information_schema.columns arată cinci coloane, cu telefon o singură dată, la final. Tipul coloanei existente nu este verificat, deci migrările trebuie totuși ținute în evidență.
Cum o eviți pe viitor
- Rulează migrările în tranzacții, ca să nu rămână aplicate parțial.
- Folosește
IF NOT EXISTSîn scripturile care pot fi rulate de mai multe ori. - Nu modifica schema manual pe servere gestionate prin migrări.
- Verifică structura cu
\d tabelsauinformation_schema.columnsînainte de migrări manuale.
Întrebări frecvente
Pot redenumi coloana existentă în loc să adaug alta?
Da: ALTER TABLE clienti RENAME COLUMN tel TO telefon; este instantaneu.
Cum verific existența unei coloane în SQL?
SELECT 1 FROM information_schema.columns WHERE table_name = 'clienti' AND column_name = 'telefon';
Erori înrudite
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. ERROR: column "nume_client" does not exist PostgreSQL nu găsește coloana cu numele din mesaj în tabelele din FROM. Cauze tipice: nume scris greșit, un text pus între ghilimele duble în loc de apostrofuri, un alias din SELECT folosit în WHERE sau o coloană creată cu majuscule între ghilimele. ERROR: multiple assignments to same column "pret" Același UPDATE setează aceeași coloană de două ori în SET (de exemplu pret = ..., pret = ...). Combină cele două expresii într-una singură sau, dacă voiai altă coloană, corectează numele. Î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.
