"A foreign key constraint fails" oplossen bij het importeren van een SQL-dump

Je exporteert een database, probeert die in een verse instantie te laden, en MySQL geeft de fout:

Of, op PostgreSQL:

Waarom dit gebeurt

Een foreign key zegt: “elke orders.user_id moet verwijzen naar een bestaande users.id.” Wanneer de dump orders vóór users invoegt, bestaat de bovenliggende rij waarnaar wordt verwezen nog niet, en weigert de database de rij.

De meeste dump-tools schrijven tabellen alfabetisch of in aanmaakvolgorde — niet in volgorde van foreign key-afhankelijkheden. Zo belandt orders (child) vaak vóór users (parent), en breekt de import.

Oplossing 1: INSERTs herordenen op afhankelijkheid (de juiste oplossing)

De nette oplossing is om elke bovenliggende tabel vóór zijn onderliggende tabellen in te voegen. Dat betekent de foreign keys omzetten in een afhankelijkheidsgraaf en tabellen laden in topologische volgorde: users → orders → order_items.

Dit met de hand doen in een bestand van meerdere gigabytes is pijnlijk — je moet elke FOREIGN KEY volgen door CREATE TABLE- en ALTER TABLE-statements en enorme INSERT-blokken in de juiste volgorde knippen en plakken.

Oplossing 2: Foreign key-checks uitschakelen tijdens de import

Voor een volledige, al consistente dump kun je de validatie tijdens het laden veilig overslaan. Op MySQL omhul je het bestand zo:

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... al je INSERT-statements ...
SET FOREIGN_KEY_CHECKS = 1;

Op PostgreSQL stel je de constraints uit binnen een transactie:

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... al je INSERT-statements ...
COMMIT;

Schakel de checks daarna weer in zodat toekomstige writes gevalideerd blijven. Dit werkt, maar het maskeert alleen het volgordeprobleem — als de dump gedeeltelijk is, kun je nog steeds met verweesde rijen eindigen.

Oplossing 3: Beide automatisch met DumpCleaner

DumpCleaner leest de dump, haalt elke foreign key uit CREATE TABLE en ALTER TABLE, bouwt de afhankelijkheidsgraaf en exporteert een schoon bestand dat gewoon importeert:

1. Sleep je .sql-dump in DumpCleaner (MySQL, MariaDB, PostgreSQL, SQLite of MS SQL).
2. Kies INSERT-volgorde → Op afhankelijkheden (FK-bewust). Parents worden automatisch vóór children geplaatst via topologische sortering.
3. Vink desgewenst Foreign key-checks uitschakelen aan — het omhult de uitvoer met het juiste statement voor jouw database.
4. Exporteer. Importeer het nieuwe bestand — de constraint-fout is weg.

Het detecteert zelfs circulaire foreign keys en waarschuwt je in plaats van een onmogelijke volgorde te produceren.

Veelgestelde vragen