number of columns in foreign key does not match the number of columns in the referenced table
Cheia străină are alt număr de coloane decât lista din REFERENCES, de exemplu FOREIGN KEY (curs_id) REFERENCES sesiuni(curs_id, data). Listele trebuie să aibă aceleași coloane, în aceeași ordine: FOREIGN KEY (curs_id, data) REFERENCES sesiuni(curs_id, data).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O cheie străină leagă coloane din tabelul curent de coloane din tabelul referit, pereche cu pereche: prima coloană din FOREIGN KEY (...) cu prima din REFERENCES t(...), a doua cu a doua și așa mai departe. De aceea cele două liste trebuie să aibă același număr de coloane.
Mesajul apare la CREATE TABLE, de obicei când tabelul referit are o cheie primară compusă (de exemplu PRIMARY KEY (curs_id, data)) și ai scris în FOREIGN KEY doar una dintre coloane, sau invers.
O variantă înrudită apare când pui REFERENCES t(a, b) direct lângă o singură coloană: foreign key on curs_id should reference only one column of table sesiuni. Cheia compusă se scrie mereu ca o constrângere separată, la finalul tabelului.
De ce apare: cauzele frecvente
1Cheie primară compusă, cheie străină cu o coloană
CREATE TABLE inscrieri (
id INTEGER PRIMARY KEY,
curs_id INTEGER, data TEXT,
FOREIGN KEY (curs_id)
REFERENCES sesiuni (curs_id, data)
);CREATE TABLE inscrieri (
id INTEGER PRIMARY KEY,
curs_id INTEGER, data TEXT,
FOREIGN KEY (curs_id, data)
REFERENCES sesiuni (curs_id, data)
);O sesiune e identificată de curs și dată împreună, deci înscrierea trebuie să le aibă pe amândouă.
2REFERENCES cu două coloane lângă o coloană
CREATE TABLE inscrieri (
id INTEGER PRIMARY KEY,
curs_id INTEGER REFERENCES sesiuni (curs_id, data),
data TEXT
);CREATE TABLE inscrieri (
id INTEGER PRIMARY KEY,
curs_id INTEGER, data TEXT,
FOREIGN KEY (curs_id, data)
REFERENCES sesiuni (curs_id, data)
);Lângă o coloană, REFERENCES poate numi o singură coloană. Cheile compuse se scriu ca FOREIGN KEY (...) separat.
Repară eroarea, direct în pagină
O sesiune de curs e identificată de curs_id și data împreună. Codul creează tabelul inscrieri, legat de sesiuni, adaugă o înscriere și o afișează (cursant, curs_id, data), dar dă eroarea despre numărul de coloane din cheia străină. Repară definiția cheii străine.
PRAGMA foreign_keys = ON;
CREATE TABLE inscrieri (
id INTEGER PRIMARY KEY,
cursant TEXT,
curs_id INTEGER,
data TEXT,
FOREIGN KEY (curs_id) REFERENCES sesiuni (curs_id, data)
);
INSERT INTO inscrieri (cursant, curs_id, data) VALUES ('Ana Vasile', 1, '2026-11-17');
SELECT cursant, curs_id, data FROM inscrieri;cursant | curs_id | data Ana Vasile | 1 | 2026-11-17
Indiciu
Cheia străină trebuie să aibă aceleași coloane ca cheia primară a sesiunilor.
Reparația
PRAGMA foreign_keys = ON;
CREATE TABLE inscrieri (
id INTEGER PRIMARY KEY,
cursant TEXT,
curs_id INTEGER,
data TEXT,
FOREIGN KEY (curs_id, data) REFERENCES sesiuni (curs_id, data)
);
INSERT INTO inscrieri (cursant, curs_id, data) VALUES ('Ana Vasile', 1, '2026-11-17');
SELECT cursant, curs_id, data FROM inscrieri;De ce merge
Coloanele cheii străine se potrivesc pereche cu pereche cu cele din REFERENCES. Cheia primară a sesiunilor are două coloane, deci și cheia străină trebuie să aibă două: (curs_id, data).
Acum înscrierea Anei e acceptată pentru că sesiunea (1, '2026-11-17') există. Cu o dată inexistentă, INSERT-ul ar da FOREIGN KEY constraint failed.
Alte forme ale mesajului
foreign key on curs_id should reference only one column of table sesiuniERROR: number of referencing and referenced columns for foreign key disagree
Cum o eviți pe viitor
Când tabelul referit are cheie primară compusă, copiază lista ei exact în ambele părți ale cheii străine, în aceeași ordine. Dacă te încurcă des cheile compuse, dă tabelului referit o cheie simplă (id INTEGER PRIMARY KEY) plus un UNIQUE (curs_id, data) și leagă celelalte tabele de id. Activează verificarea cu PRAGMA foreign_keys = ON;.
Întrebări frecvente
Contează ordinea coloanelor?
Da. Perechile se fac după poziție, deci FOREIGN KEY (data, curs_id) REFERENCES sesiuni (curs_id, data) ar compara data cu cursul.
Pot omite lista din REFERENCES?
Da: REFERENCES sesiuni folosește cheia primară a tabelului. Numărul de coloane trebuie să se potrivească și atunci.
Erori înrudite
FOREIGN KEY constraint failed Rândul inserat sau modificat trimite la un rând părinte care nu există (de exemplu o carte cu autor_id = 9, dar nu există autorul 9), sau încerci să ștergi un părinte care mai are copii. Folosește un id existent, creează întâi părintele sau șterge întâi rândurile copil (ori declară ON DELETE CASCADE). unknown column "autor" in foreign key definition În clauza FOREIGN KEY (autor) ai scris un nume de coloană care nu există în tabelul pe care îl creezi, de obicei pentru că coloana se numește altfel (autor_id). Pune în paranteză exact numele coloanei din tabel: FOREIGN KEY (autor_id) REFERENCES autori(id). table "produse" has more than one primary key Ai pus PRIMARY KEY pe două coloane separat sau ai combinat PRIMARY KEY pe coloană cu PRIMARY KEY (...) la final. Un tabel are o singură cheie primară. Pentru o cheie compusă, scrie o singură clauză: PRIMARY KEY (elev_id, materie); pentru o coloană unică în plus, folosește UNIQUE. Î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.
