Odpravite napako »a foreign key constraint fails« pri uvozu SQL izvoza

Izvozite bazo podatkov, jo poskusite naložiti v svežo instanco, MySQL pa vrže:

Ali pa na PostgreSQL:

Zakaj se to zgodi

Tuji ključ pravi »vsak orders.user_id mora kazati na obstoječi users.id.« Kadar izvoz vstavi orders pred users, referencirana nadrejena vrstica še ne obstaja in baza podatkov vrstico zavrne.

Večina orodij za izvoz zapiše tabele po abecedi ali v vrstnem redu ustvarjanja — ne v vrstnem redu odvisnosti tujih ključev. Zato orders (podrejena) pogosto pristane pred users (nadrejena) in uvoz se pokvari.

Rešitev 1: Prerazporedite INSERT stavke po odvisnostih (pravilna rešitev)

Čista rešitev je, da vsako nadrejeno tabelo vstavite pred njenimi podrejenimi. To pomeni, da tuje ključe razrešite v graf odvisnosti in tabele naložite v topološkem vrstnem redu: users → orders → order_items.

Ročno početje tega v datoteki velikosti več gigabajtov je mučno — izslediti morate vsak FOREIGN KEY po vseh CREATE TABLE in ALTER TABLE stavkih ter v pravilnem zaporedju izrezovati in lepiti ogromne INSERT bloke.

Rešitev 2: Onemogočite preverjanje tujih ključev med uvozom

Pri popolnem in že usklajenem izvozu lahko med nalaganjem varno preskočite preverjanje. Na MySQL datoteko ovijete:

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... vsi vaši INSERT stavki ...
SET FOREIGN_KEY_CHECKS = 1;

Na PostgreSQL omejitve odložite znotraj transakcije:

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... vsi vaši INSERT stavki ...
COMMIT;

Preverjanje nato znova omogočite, da ostanejo prihodnji zapisi preverjeni. To deluje, a le prikrije težavo z vrstnim redom — če je izvoz delen, lahko še vedno pristanete z osirotelimi vrsticami.

Rešitev 3: Naredite oboje samodejno z DumpCleaner

DumpCleaner prebere izvoz, iz CREATE TABLE in ALTER TABLE izlušči vsak tuji ključ, zgradi graf odvisnosti in izvozi čisto datoteko, ki se preprosto uvozi:

1. Povlecite svoj .sql izvoz v DumpCleaner (MySQL, MariaDB, PostgreSQL, SQLite ali MS SQL).
2. Izberite Vrstni red INSERT → Po odvisnostih (upošteva tuje ključe). Nadrejene tabele so samodejno postavljene pred podrejene s topološkim urejanjem.
3. Po želji obkljukajte Onemogoči preverjanje tujih ključev — izhod se ovije s pravilnim stavkom za vašo bazo podatkov.
4. Izvozite. Uvozite novo datoteko — napake omejitve ni več.

Zazna celo krožne tuje ključe in vas opozori, namesto da bi ustvaril nemogoč vrstni red.

Pogosta vprašanja