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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O cheie străină (REFERENCES autori(id)) cere ca valoarea din coloana copil să existe în tabelul părinte. Mesajul FOREIGN KEY constraint failed apare când o instrucțiune ar strica această legătură. Spre deosebire de alte constrângeri, SQLite nu spune ce coloană sau ce valoare e problema, așa că trebuie s-o găsești tu.
Trei situații: un INSERT sau UPDATE în tabelul copil cu un id de părinte inexistent; un DELETE al unui părinte care mai are rânduri copil; un UPDATE al id-ului părintelui. În SQLite cheile străine sunt verificate doar dacă rulezi PRAGMA foreign_keys = ON; pe conexiune (în multe aplicații este oprit implicit).
Ca să găsești rândul problemă, verifică valoarea: SELECT * FROM autori WHERE id = 9; sau listează încălcările existente cu PRAGMA foreign_key_check;.
De ce apare: cauzele frecvente
1Copil cu un părinte inexistent
INSERT INTO carti (titlu, autor_id)
VALUES ('Luceafărul', 9);INSERT INTO carti (titlu, autor_id)
VALUES ('Luceafărul', 2);Nu există autorul cu id 9. Cartea trebuie legată de un autor care există, aici Mihai Eminescu (id 2).
2Părintele e șters înaintea copiilor
DELETE FROM autori WHERE id = 3;DELETE FROM carti WHERE autor_id = 3;
DELETE FROM autori WHERE id = 3;Autorul 3 are încă o carte. Ștergi întâi cărțile lui, apoi autorul. Alternativa este ON DELETE CASCADE în definiția cheii străine.
3Ordinea greșită la popularea tabelelor
INSERT INTO carti (titlu, autor_id) VALUES ('Ion', 4);
INSERT INTO autori (id, nume) VALUES (4, 'Liviu Rebreanu');INSERT INTO autori (id, nume) VALUES (4, 'Liviu Rebreanu');
INSERT INTO carti (titlu, autor_id) VALUES ('Ion', 4);Părintele trebuie să existe înainte ca un copil să trimită la el.
Repară eroarea, direct în pagină
Cheile străine sunt active (PRAGMA foreign_keys = ON în setup). Scriptul trebuie să adauge autorul Liviu Rebreanu (id 4) și cartea „Ion” a lui, apoi să afișeze titlu și autor pentru toate cărțile, ordonate după id-ul cărții. Acum dă FOREIGN KEY constraint failed. Repară ordinea instrucțiunilor.
INSERT INTO carti (titlu, autor_id) VALUES ('Ion', 4);
INSERT INTO autori (id, nume) VALUES (4, 'Liviu Rebreanu');
SELECT c.titlu, a.nume AS autor
FROM carti c
JOIN autori a ON a.id = c.autor_id
ORDER BY c.id;titlu | autor Amintiri din copilărie | Ion Creangă Poezii | Mihai Eminescu Moara cu noroc | Ioan Slavici Ion | Liviu Rebreanu
Indiciu
Autorul trebuie să existe înainte ca o carte să trimită la el.
Reparația
INSERT INTO autori (id, nume) VALUES (4, 'Liviu Rebreanu');
INSERT INTO carti (titlu, autor_id) VALUES ('Ion', 4);
SELECT c.titlu, a.nume AS autor
FROM carti c
JOIN autori a ON a.id = c.autor_id
ORDER BY c.id;De ce merge
Când se inserează cartea, cheia străină autor_id REFERENCES autori(id) verifică dacă autorul 4 există. În varianta inițială nu exista încă, deci inserarea era refuzată.
Inversând ordinea, autorul e creat primul, iar cartea trimite la un rând existent. Aceeași regulă, în sens invers, se aplică la ștergere: întâi cărțile, apoi autorul.
Alte forme ale mesajului
foreign key mismatch - "carti" referencing "autori"ERROR 1452 (23000): Cannot add or update a child row: a foreign key constraint failsERROR 1451 (23000): Cannot delete or update a parent row: a foreign key constraint failsERROR: insert or update on table "carti" violates foreign key constraint "carti_autor_id_fkey"sqlite3.IntegrityError: FOREIGN KEY constraint failed
Cum o eviți pe viitor
- Populează tabelele în ordinea părinte, apoi copil; șterge în ordine inversă.
- Decide la crearea tabelului ce se întâmplă cu copiii la ștergerea părintelui:
ON DELETE CASCADE(se șterg),ON DELETE SET NULL(rămân fără părinte) sau implicitul, care refuză ștergerea. - În SQLite, activează cheile străine pe fiecare conexiune cu
PRAGMA foreign_keys = ON;, altfel nu se verifică deloc. - În aplicații, folosește id-urile întoarse de baza de date, nu valori scrise de mână.
Întrebări frecvente
De ce pe calculatorul meu nu primesc eroarea, iar pe server da?
În SQLite verificarea cheilor străine e oprită implicit și trebuie pornită cu PRAGMA foreign_keys = ON; pe fiecare conexiune. Dacă o aplicație o pornește și alta nu, aceleași date trec într-un loc și pică în altul.
Ce înseamnă foreign key mismatch?
E o eroare de schemă, nu de date: coloana referită din părinte nu este cheie primară sau UNIQUE. De exemplu REFERENCES autori(nume), unde nume nu e unic. Repari definiția tabelului.
Erori înrudite
NOT NULL constraint failed: produse.nume Coloana produse.nume este declarată NOT NULL, dar INSERT-ul sau UPDATE-ul îi lasă valoarea NULL: ai uitat coloana din listă sau ai trimis explicit NULL. Dă o valoare pentru coloană sau, dacă are sens, pune-i o valoare implicită cu DEFAULT. 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. CHECK constraint failed: pret >= 0 Valoarea pe care o inserezi sau o actualizezi încalcă o regulă CHECK din definiția tabelului (aici pret >= 0). Mesajul arată regula sau numele constrângerii. Corectează valoarea; schimbă regula doar dacă ea e cea greșită. Î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.
