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

number of columns in foreign key does not match the number of columns in the referenced table

Pe scurt

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ă

Greșit
SQL
CREATE TABLE inscrieri (
  id INTEGER PRIMARY KEY,
  curs_id INTEGER, data TEXT,
  FOREIGN KEY (curs_id)
    REFERENCES sesiuni (curs_id, data)
);
Corect
SQL
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ă

Greșit
SQL
CREATE TABLE inscrieri (
  id INTEGER PRIMARY KEY,
  curs_id INTEGER REFERENCES sesiuni (curs_id, data),
  data TEXT
);
Corect
SQL
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ă tu

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.

Codul care dă eroarea
SQL
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;
După reparație, programul afișează
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.

Alte forme ale mesajului

  • foreign key on curs_id should reference only one column of table sesiuni
  • ERROR: 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

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