Rezolvă „a foreign key constraint fails” la importul unui dump SQL

Exporți o bază de date, încerci să o încarci într-o instanță nouă, iar MySQL aruncă:

Sau, pe PostgreSQL:

De ce se întâmplă asta

O cheie străină spune „fiecare orders.user_id trebuie să indice către un users.id existent.” Când dump-ul inserează orders înainte de users, rândul părinte referențiat nu există încă, iar baza de date respinge rândul.

Majoritatea instrumentelor de dump scriu tabelele alfabetic sau în ordinea creării — nu în ordinea dependențelor de cheie străină. Astfel, orders (copil) ajunge frecvent înaintea lui users (părinte), iar importul se blochează.

Soluția 1: Reordonează INSERT-urile după dependențe (soluția corectă)

Soluția curată este să inserezi fiecare tabel părinte înaintea copiilor săi. Asta înseamnă rezolvarea cheilor străine într-un graf de dependențe și încărcarea tabelelor în ordine topologică: users → orders → order_items.

A face asta manual într-un fișier de mai mulți gigaocteți este dureros — trebuie să urmărești fiecare FOREIGN KEY prin instrucțiunile CREATE TABLE și ALTER TABLE și să decupezi/lipești blocuri INSERT uriașe în ordinea corectă.

Soluția 2: Dezactivează verificările de cheie străină în timpul importului

Pentru un dump complet și deja consistent, poți sări în siguranță peste validare în timpul încărcării. Pe MySQL, învelește fișierul:

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... toate instrucțiunile tale INSERT ...
SET FOREIGN_KEY_CHECKS = 1;

Pe PostgreSQL, amână constrângerile în interiorul unei tranzacții:

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... toate instrucțiunile tale INSERT ...
COMMIT;

Reactivează verificările după aceea, ca scrierile viitoare să rămână validate. Funcționează, dar doar maschează problema de ordonare — dacă dump-ul este parțial, poți ajunge tot cu rânduri orfane.

Soluția 3: Fă ambele automat cu DumpCleaner

DumpCleaner citește dump-ul, extrage fiecare cheie străină din CREATE TABLE și ALTER TABLE, construiește graful de dependențe și exportă un fișier curat care pur și simplu se importă:

1. Trage dump-ul tău .sql în DumpCleaner (MySQL, MariaDB, PostgreSQL, SQLite sau MS SQL).
2. Alege Ordine INSERT → După dependențe (conștient de FK). Părinții sunt plasați înaintea copiilor automat, prin sortare topologică.
3. Opțional, bifează Dezactivează verificările de cheie străină — învelește rezultatul cu instrucțiunea corectă pentru baza ta de date.
4. Exportă. Importă noul fișier — eroarea de constrângere a dispărut.

Detectează chiar și cheile străine circulare și te avertizează în loc să producă o ordine imposibilă.

Întrebări frecvente