near "UNIQUE": syntax error (ALTER TABLE ADD CONSTRAINT)
SQLite nu poate adăuga constrângeri unui tabel existent: ALTER TABLE ... ADD CONSTRAINT nu există. Pentru UNIQUE creează un index unic (CREATE UNIQUE INDEX). Pentru FOREIGN KEY, PRIMARY KEY sau CHECK trebuie să recreezi tabelul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În PostgreSQL, MySQL și SQL Server scrii ALTER TABLE clienti ADD CONSTRAINT uq_email UNIQUE (email);. SQLite are un ALTER TABLE limitat: poate redenumi tabelul, redenumi o coloană, adăuga o coloană (ADD COLUMN) și șterge o coloană (DROP COLUMN). Nimic altceva.
Cuvântul CONSTRAINT e acceptat ca început al unei coloane noi, așa că parserul ajunge până la UNIQUE, FOREIGN sau PRIMARY și abia acolo se oprește: near "UNIQUE": syntax error. La DROP CONSTRAINT primești no such constraint.
Soluții: pentru unicitate, CREATE UNIQUE INDEX, care are exact același efect. Pentru celelalte constrângeri, procedura oficială: creezi un tabel nou cu constrângerea, copiezi datele, ștergi tabelul vechi și îl redenumești pe cel nou.
De ce apare: cauzele frecvente
1UNIQUE adăugat ulterior
ALTER TABLE clienti
ADD CONSTRAINT uq_email UNIQUE (email);CREATE UNIQUE INDEX uq_email
ON clienti (email);Un index unic blochează duplicatele exact ca o constrângere UNIQUE, și se poate crea oricând.
2Cheie străină adăugată ulterior
ALTER TABLE comenzi
ADD FOREIGN KEY (client_id) REFERENCES clienti(id);CREATE TABLE comenzi_noi (
id INTEGER PRIMARY KEY,
client_id INTEGER REFERENCES clienti(id)
);
INSERT INTO comenzi_noi SELECT id, client_id FROM comenzi;
DROP TABLE comenzi;
ALTER TABLE comenzi_noi RENAME TO comenzi;SQLite nu poate schimba constrângerile unui tabel, așa că îl recreezi cu cheia străină și muți datele.
Repară eroarea, direct în pagină
Vrem ca în tabelul existent clienti să nu mai poată fi adăugat un email care există deja. Codul de mai jos dă near "UNIQUE": syntax error. Repară-l ca regula să fie activă, apoi afișează numele indexurilor tabelului (name).
ALTER TABLE clienti ADD CONSTRAINT uq_email UNIQUE (email);
SELECT name FROM sqlite_schema WHERE type = 'index' AND tbl_name = 'clienti';name uq_email
Indiciu
Unicitatea se poate adăuga oricând printr-un index.
Reparația
CREATE UNIQUE INDEX uq_email ON clienti (email);
SELECT name FROM sqlite_schema WHERE type = 'index' AND tbl_name = 'clienti';De ce merge
ALTER TABLE din SQLite nu poate adăuga constrângeri, de aceea parserul se oprește la UNIQUE. CREATE UNIQUE INDEX uq_email ON clienti (email) are același efect: orice INSERT sau UPDATE care ar crea un email duplicat dă UNIQUE constraint failed: clienti.email.
Interogarea pe sqlite_schema arată că indexul uq_email există acum pe tabel.
Alte forme ale mesajului
near "FOREIGN": syntax errornear "PRIMARY": syntax errorno such constraint: uq_email
Cum o eviți pe viitor
Gândește constrângerile când creezi tabelul: PRIMARY KEY, UNIQUE, NOT NULL, CHECK, REFERENCES se scriu toate în CREATE TABLE. În migrații pe SQLite, pentru unicitate folosește CREATE UNIQUE INDEX, iar pentru restul folosește tiparul „tabel nou, copiere, ștergere, redenumire”, într-o tranzacție. Unelte ca Alembic sau Prisma fac automat acest lucru pentru SQLite.
Întrebări frecvente
Ce face SQLite cu ALTER TABLE ADD COLUMN ... UNIQUE?
Refuză: Cannot add a UNIQUE column. Adaugă coloana fără UNIQUE, apoi creează un index unic pe ea.
Ce se întâmplă dacă există deja duplicate când creez indexul unic?
Primești UNIQUE constraint failed. Curăță întâi duplicatele, apoi creează indexul.
Erori înrudite
near "MODIFY": syntax error SQLite nu are ALTER TABLE ... MODIFY (MySQL) sau ALTER COLUMN (PostgreSQL, SQL Server). Poate doar să redenumească tabelul sau coloane și să adauge sau șteargă coloane. Pentru a schimba tipul sau constrângerile unei coloane, creezi un tabel nou, copiezi datele și îl înlocuiești pe cel vechi. Cannot add a NOT NULL column with default value NULL ALTER TABLE ... ADD COLUMN cu NOT NULL, dar fără DEFAULT: rândurile existente ar primi NULL, ceea ce încalcă regula. Adaugă o valoare implicită (ADD COLUMN activ INTEGER NOT NULL DEFAULT 1) sau adaugă coloana fără NOT NULL și completeaz-o după. UNIQUE constraint failed: clienti.email Încerci să inserezi sau să actualizezi un rând cu o valoare care există deja într-o coloană declarată UNIQUE (aici clienti.email). Baza de date refuză duplicatul. Folosește altă valoare, actualizează rândul existent sau tratează conflictul cu INSERT OR IGNORE ori ON CONFLICT. Învață SQL de la zero, cu exerciții la fiecare lecție
Curs SQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
