...
Eroare SQL · Constrângeri: UNIQUE, NOT NULL, CHECK, chei străine

expressions prohibited in PRIMARY KEY and UNIQUE constraints

Pe scurt

Într-o constrângere UNIQUE sau PRIMARY KEY ai pus o expresie, de exemplu UNIQUE(lower(email)). Constrângerile primesc doar nume de coloane. Pentru unicitate pe o expresie, creează un index unic: CREATE UNIQUE INDEX ix ON clienti(lower(email)).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În CREATE TABLE, constrângerile UNIQUE (...) și PRIMARY KEY (...) acceptă doar o listă de coloane. Dacă pui acolo o funcție sau un calcul, de exemplu UNIQUE (lower(email)) ca să nu poți avea același email scris o dată cu litere mari și o dată cu litere mici, SQLite refuză tabelul cu acest mesaj.

Ideea e bună, doar locul e greșit. Unicitatea pe o expresie se face cu un index unic pe expresie, creat separat: CREATE UNIQUE INDEX ix_email ON clienti (lower(email));. Indexul se comportă ca o constrângere: un INSERT cu un email care diferă doar prin majuscule dă UNIQUE constraint failed: index 'ix_email'.

Alternativa: email TEXT UNIQUE COLLATE NOCASE, care compară fără majuscule.

De ce apare: cauzele frecvente

1UNIQUE pe lower(email)

Greșit
SQL
CREATE TABLE clienti (
  id INTEGER PRIMARY KEY,
  email TEXT,
  UNIQUE (lower(email))
);
Corect
SQL
CREATE TABLE clienti (
  id INTEGER PRIMARY KEY,
  email TEXT
);
CREATE UNIQUE INDEX ix_email
  ON clienti (lower(email));

Indexul unic pe expresie face exact ce voiai: două emailuri care diferă doar prin majuscule nu pot coexista.

2Coloană cu COLLATE NOCASE

Greșit
SQL
CREATE TABLE utilizatori (
  id INTEGER PRIMARY KEY,
  username TEXT,
  UNIQUE (upper(username))
);
Corect
SQL
CREATE TABLE utilizatori (
  id INTEGER PRIMARY KEY,
  username TEXT UNIQUE COLLATE NOCASE
);

Cu COLLATE NOCASE, coloana compară fără majuscule (pentru litere ASCII), deci și unicitatea ignoră majusculele.

3Cheie primară pe o parte din dată

Greșit
SQL
CREATE TABLE rapoarte (
  data TEXT,
  text TEXT,
  PRIMARY KEY (substr(data, 1, 7))
);
Corect
SQL
CREATE TABLE rapoarte (
  luna TEXT PRIMARY KEY,
  data TEXT,
  text TEXT
);

Dacă ai nevoie de unicitate pe lună, păstreaz-o într-o coloană proprie, luna, și pune cheia pe ea.

Repară tu

Repară eroarea, direct în pagină

Creăm tabelul clienti (id, email) în care același email nu poate apărea de două ori, indiferent de majuscule, apoi copiem în el adresele din import_clienti cu INSERT OR IGNORE. La final afișăm email ordonat. Codul dă expressions prohibited in PRIMARY KEY and UNIQUE constraints. Repară-l păstrând regula pe lower(email).

Codul care dă eroarea
SQL
CREATE TABLE clienti (
  id INTEGER PRIMARY KEY,
  email TEXT,
  UNIQUE (lower(email))
);
INSERT OR IGNORE INTO clienti (email) SELECT email FROM import_clienti;
SELECT email FROM clienti ORDER BY email;
După reparație, programul afișează
email
ana@exemplu.ro
ion@exemplu.ro
Indiciu

Unicitatea pe o expresie se face cu un index unic creat separat.

Alte forme ale mesajului

  • ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '(email))' at line 4

Cum o eviți pe viitor

Pune în constrângeri doar coloane. Când regula de unicitate depinde de o transformare (majuscule, spații, o parte din text), folosește CREATE UNIQUE INDEX ... ON tabel (expresie) imediat după CREATE TABLE, sau o coloană generată (email_norm TEXT AS (lower(email))) pe care pui UNIQUE prin index. Pentru majuscule, COLLATE NOCASE e cel mai simplu.

Întrebări frecvente

Ce mesaj primesc când indexul pe expresie blochează un duplicat?

UNIQUE constraint failed: index 'ix_email', cu numele indexului, nu al coloanei.

Merge COLLATE NOCASE și pentru diacritice?

Nu. NOCASE știe doar literele A–Z. Ș și ș rămân diferite, la fel ca la lower(), care în SQLite schimbă tot doar literele ASCII.

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.