Riješite „a foreign key constraint fails” pri uvozu SQL dumpa

Izvezete bazu podataka, pokušate je učitati u novu instancu, a MySQL izbaci:

Ili, na PostgreSQL-u:

Zašto se to događa

Vanjski ključ kaže „svaki orders.user_id mora upućivati na postojeći users.id.” Kada dump unosi orders prije users, referencirani nadređeni redak još ne postoji i baza podataka odbacuje redak.

Većina alata za dump zapisuje tablice abecedno ili redoslijedom stvaranja — ne prema ovisnostima vanjskih ključeva. Tako orders (podređeni) često dođe prije users (nadređeni), i uvoz se prekida.

Rješenje 1: Presložite INSERT-ove prema ovisnostima (ispravno rješenje)

Čisto rješenje je unijeti svaku nadređenu tablicu prije njezinih podređenih. To znači razriješiti vanjske ključeve u graf ovisnosti i učitavati tablice topološkim redoslijedom: users → orders → order_items.

Raditi to ručno u datoteci od više gigabajta je mučno — morate pratiti svaki FOREIGN KEY kroz CREATE TABLE i ALTER TABLE naredbe te izrezivati/lijepiti goleme INSERT blokove u pravom slijedu.

Rješenje 2: Onemogućite provjeru vanjskih ključeva tijekom uvoza

Za potpun, već konzistentan dump možete sigurno preskočiti provjeru tijekom učitavanja. Na MySQL-u, omotajte datoteku:

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... sve vaše INSERT naredbe ...
SET FOREIGN_KEY_CHECKS = 1;

Na PostgreSQL-u, odgodite ograničenja unutar transakcije:

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... sve vaše INSERT naredbe ...
COMMIT;

Nakon toga ponovno uključite provjere kako bi budući upisi ostali validirani. Ovo radi, ali samo prikriva problem redoslijeda — ako je dump djelomičan, još uvijek možete završiti s osirotjelim recima.

Rješenje 3: Učinite oboje automatski s DumpCleanerom

DumpCleaner čita dump, izvlači svaki vanjski ključ iz CREATE TABLE i ALTER TABLE, gradi graf ovisnosti i izvozi čistu datoteku koja se jednostavno uvozi:

1. Povucite svoj .sql dump u DumpCleaner (MySQL, MariaDB, PostgreSQL, SQLite ili MS SQL).
2. Odaberite Redoslijed INSERT-a → Prema ovisnostima (svjesno vanjskih ključeva). Nadređene tablice automatski se postavljaju prije podređenih putem topološkog sortiranja.
3. Po želji označite Onemogući provjeru vanjskih ključeva — to omota izlaz ispravnom naredbom za vašu bazu podataka.
4. Izvezite. Uvezite novu datoteku — greška ograničenja je nestala.

Čak otkriva i kružne vanjske ključeve te vas upozorava umjesto da proizvede nemoguć redoslijed.

Često postavljana pitanja