A „foreign key constraint fails” hiba javítása SQL dump importálásakor

Exportálsz egy adatbázist, megpróbálod betölteni egy új példányba, és a MySQL ezt dobja:

Vagy PostgreSQL esetén:

Miért történik ez

Az idegenkulcs azt mondja: „minden orders.user_id értéknek egy létező users.id értékre kell mutatnia.” Ha a dump az orders táblát előbb szúrja be, mint a users táblát, a hivatkozott szülősor még nem létezik, és az adatbázis elutasítja a sort.

A legtöbb dump-eszköz a táblákat ábécésorrendben vagy létrehozási sorrendben írja ki – nem az idegenkulcs-függőségek sorrendjében. Így az orders (gyerek) gyakran a users (szülő) elé kerül, és az importálás elhasal.

1. megoldás: az INSERT-ek átrendezése függőség szerint (a helyes megoldás)

A tiszta megoldás az, hogy minden szülőtáblát a gyerekei elé szúrunk be. Ehhez az idegenkulcsokat egy függőségi gráffá kell feloldani, és a táblákat topologikus sorrendben betölteni: users → orders → order_items.

Ezt kézzel elvégezni egy több gigabájtos fájlban kínszenvedés – végig kell követned minden FOREIGN KEY hivatkozást a CREATE TABLE és ALTER TABLE utasításokon át, majd hatalmas INSERT blokkokat kivágni és beilleszteni a megfelelő sorrendben.

2. megoldás: az idegenkulcs-ellenőrzések kikapcsolása importáláskor

Egy teljes, már konzisztens dump esetén nyugodtan kihagyhatod a validálást a betöltés idejére. MySQL esetén foglald keretbe a fájlt:

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... az összes INSERT utasításod ...
SET FOREIGN_KEY_CHECKS = 1;

PostgreSQL esetén halaszd el a megszorításokat egy tranzakción belül:

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... az összes INSERT utasításod ...
COMMIT;

Utána kapcsold vissza az ellenőrzéseket, hogy a jövőbeni írások validáltak maradjanak. Ez működik, de csak elfedi a sorrendi problémát – ha a dump részleges, még mindig árva sorokkal maradhatsz.

3. megoldás: mindkettő automatikusan a DumpCleanerrel

A DumpCleaner beolvassa a dumpot, kinyer minden idegenkulcsot a CREATE TABLE és ALTER TABLE utasításokból, felépíti a függőségi gráfot, és exportál egy tiszta fájlt, amely simán importálódik:

1. Húzd a .sql dumpodat a DumpCleanerbe (MySQL, MariaDB, PostgreSQL, SQLite vagy MS SQL).
2. Válaszd az INSERT sorrend → Függőségek szerint (idegenkulcs-tudatos) lehetőséget. A szülők automatikusan a gyerekek elé kerülnek topologikus rendezéssel.
3. Opcionálisan pipáld be az Idegenkulcs-ellenőrzések kikapcsolása opciót – ez az adatbázisodnak megfelelő utasítással foglalja keretbe a kimenetet.
4. Exportálj. Importáld az új fájlt – a megszorítási hiba eltűnt.

Még a körkörös idegenkulcsokat is felismeri, és figyelmeztet ahelyett, hogy lehetetlen sorrendet állítana elő.

Gyakran ismételt kérdések