...
Eroare SQL · CREATE TABLE, ALTER TABLE și tranzacții

near "UNIQUE": syntax error (ALTER TABLE ADD CONSTRAINT)

Pe scurt

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

Greșit
SQL
ALTER TABLE clienti
ADD CONSTRAINT uq_email UNIQUE (email);
Corect
SQL
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

Greșit
SQL
ALTER TABLE comenzi
ADD FOREIGN KEY (client_id) REFERENCES clienti(id);
Corect
SQL
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ă tu

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

Codul care dă eroarea
SQL
ALTER TABLE clienti ADD CONSTRAINT uq_email UNIQUE (email);
SELECT name FROM sqlite_schema WHERE type = 'index' AND tbl_name = 'clienti';
După reparație, programul afișează
name
uq_email
Indiciu

Unicitatea se poate adăuga oricând printr-un index.

Alte forme ale mesajului

  • near "FOREIGN": syntax error
  • near "PRIMARY": syntax error
  • no 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

← Toate erorile SQL

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ță 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.