SQL dump içe aktarırken çıkan “a foreign key constraint fails” hatasını düzeltme

Bir veritabanını dışa aktarıyorsunuz, onu yeni bir örneğe yüklemeye çalışıyorsunuz ve MySQL şu hatayı veriyor:

Ya da PostgreSQL'de:

Bu neden oluyor

Bir foreign key şunu söyler: “her orders.user_id mevcut bir users.id değerine işaret etmelidir.” Dump, orders kaydını users kayıtlarından önce eklediğinde, referans verilen üst satır henüz mevcut olmaz ve veritabanı satırı reddeder.

Çoğu dump aracı tabloları foreign key bağımlılık sırasına göre değil, alfabetik ya da oluşturulma sırasına göre yazar. Bu yüzden orders (alt tablo) sıklıkla users'tan (üst tablo) önce gelir ve içe aktarma bozulur.

Çözüm 1: INSERT'leri bağımlılığa göre yeniden sıralayın (doğru çözüm)

Temiz çözüm, her üst tabloyu alt tablolarından önce eklemektir. Bu, foreign key'leri bir bağımlılık grafiğine dönüştürmek ve tabloları topolojik sırayla yüklemek demektir: users → orders → order_items.

Bunu çok gigabaytlık bir dosyada elle yapmak eziyettir — her FOREIGN KEY'i CREATE TABLE ve ALTER TABLE ifadeleri arasında izlemeniz ve devasa INSERT bloklarını doğru sırayla kesip yapıştırmanız gerekir.

Çözüm 2: İçe aktarma sırasında foreign key kontrollerini devre dışı bırakın

Tam ve zaten tutarlı bir dump için, yükleme sırasında doğrulamayı güvenle atlayabilirsiniz. MySQL'de dosyayı şu şekilde sarmalayın:

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... tüm INSERT ifadeleriniz ...
SET FOREIGN_KEY_CHECKS = 1;

PostgreSQL'de kısıtlamaları bir işlem içinde erteleyin:

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... tüm INSERT ifadeleriniz ...
COMMIT;

Gelecekteki yazma işlemlerinin doğrulanmaya devam etmesi için kontrolleri sonradan tekrar etkinleştirin. Bu işe yarar ama yalnızca sıralama sorununu maskeler — dump kısmiyse, yine de yetim satırlarla karşılaşabilirsiniz.

Çözüm 3: DumpCleaner ile ikisini de otomatik yapın

DumpCleaner dump'ı okur, her foreign key'i CREATE TABLE ve ALTER TABLE ifadelerinden çıkarır, bağımlılık grafiğini oluşturur ve içe aktarımı sorunsuz yapan temiz bir dosya dışa aktarır:

1. .sql dump'ınızı DumpCleaner'a sürükleyin (MySQL, MariaDB, PostgreSQL, SQLite veya MS SQL).
2. INSERT sırası → Bağımlılıklara göre (FK duyarlı) seçeneğini seçin. Üst tablolar topolojik sıralama sayesinde alt tablolardan önce otomatik olarak yerleştirilir.
3. İsterseniz Foreign key kontrollerini devre dışı bırak seçeneğini işaretleyin — çıktıyı veritabanınıza uygun ifadeyle sarmalar.
4. Dışa aktarın. Yeni dosyayı içe aktarın — kısıtlama hatası ortadan kalktı.

Hatta döngüsel foreign key'leri bile tespit eder ve imkânsız bir sıralama üretmek yerine sizi uyarır.

Sıkça sorulan sorular