...
Eroare PostgreSQL · Tabele, view-uri, indecși și partiții

ERROR: column "telefon" of relation "clienti" already exists

Pe scurt

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ă

Greșit
SQL
ALTER TABLE clienti ADD COLUMN telefon text;
Corect
SQL
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

Greșit
SQL
ALTER TABLE clienti ADD COLUMN telefon text;
ALTER TABLE clienti ADD COLUMN cnp char(13) UNIQUE;  -- eșuează
Corect
SQL
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ă tu

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.

Codul care dă eroarea
SQL
ALTER TABLE clienti ADD COLUMN telefon text;
SELECT column_name FROM information_schema.columns WHERE table_name = 'clienti' ORDER BY ordinal_position;
După reparație, programul afișează
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

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 tabel sau information_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

← Toate erorile PostgreSQL

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.