Błąd klucza obcego

Błąd klucza obcego sygnalizuje naruszenie relacji pomiędzy powiązanymi tabelami podczas modyfikacji lub usuwania danych.

Jak działa relacja oparta na kluczu obcym

Błąd klucza obcego pojawia się wtedy, gdy operacja na danych narusza zdefiniowaną relację między dwiema tabelami. Klucz obcy jest kolumną albo zestawem kolumn, których wartości mają wskazywać istniejący rekord w innej tabeli. Tabela zawierająca klucz obcy jest nazywana tabelą podrzędną, a tabela wskazywana przez ten klucz — tabelą nadrzędną. Przykładowo tabela zamówień może zawierać kolumnę klient_id, która odwołuje się do identyfikatora w tabeli klientów.

Mechanizm ten wymusza integralność referencyjną, czyli zasadę, według której powiązanie między rekordami musi pozostać logicznie poprawne. Wartość wpisywana do kolumny klucza obcego powinna odpowiadać istniejącej wartości klucza głównego albo innego klucza unikatowego w tabeli nadrzędnej. Dzięki temu w bazie nie powstaje zamówienie przypisane do nieistniejącego klienta, pozycja dokumentu bez dokumentu nadrzędnego ani rekord zawierający odwołanie do usuniętego obiektu.

Operacje, które najczęściej wywołują naruszenie

Jednym z typowych przypadków jest dodawanie rekordu podrzędnego przed utworzeniem rekordu nadrzędnego. Jeżeli aplikacja próbuje zapisać zamówienie z wartością klient_id, której nie ma jeszcze w tabeli klientów, baza odrzuci instrukcję. Podobny problem powstaje po pomyleniu identyfikatorów, użyciu wartości pochodzącej z innego środowiska albo przekazaniu pustej wartości tam, gdzie kolumna nie dopuszcza wartości NULL. Samo wyłączenie kontroli w formularzu nie naprawia relacji, ponieważ sprawdzenie wykonuje również silnik bazy danych.

Błąd może wystąpić także podczas aktualizacji lub usuwania danych. Zmiana identyfikatora rekordu nadrzędnego może unieważnić odwołania zapisane w tabeli podrzędnej. Usunięcie klienta, do którego przypisano zamówienia, również zostanie zablokowane, jeśli relacja nie określa innego zachowania. W zależności od konfiguracji ograniczenia operacja może zostać wykonana kaskadowo, może ustawić wartości zależne na NULL albo może pozostać zabroniona. Konkretne działanie zależy od definicji danego ograniczenia oraz możliwości używanego silnika bazy danych.

Rozpoznawanie przyczyny w przepływie danych

Skuteczna analiza wymaga ustalenia, która instrukcja została odrzucona, której tabeli dotyczy klucz obcy oraz jaka wartość nie spełniła warunku relacji. Sam komunikat o błędzie bywa niewystarczający, dlatego należy prześledzić dane od formularza lub importu, przez warstwę aplikacji, aż do zapytania wykonywanego w bazie. Istotna jest kolejność operacji: najpierw powinien powstać rekord nadrzędny, a dopiero potem rekordy, które się do niego odwołują. Przy usuwaniu kolejność jest zwykle odwrotna, chyba że zastosowano jawnie określoną akcję kaskadową.

Warto sprawdzić również typy i formaty kolumn uczestniczących w relacji. Klucz główny i klucz obcy powinny być zgodne pod względem typu danych oraz znaczenia biznesowego. Problemy mogą powodować między innymi obcięcie wartości podczas konwersji, przesłanie identyfikatora jako tekstu zamiast liczby, błędne mapowanie pól w imporcie lub odwołanie do rekordu usuniętego wcześniej w tej samej operacji. Jeżeli kilka zapisów jest wykonywanych w ramach transakcji, trzeba zweryfikować, czy rekord nadrzędny został rzeczywiście zapisany i czy transakcja nie została wycofana przed próbą utworzenia danych zależnych.

Postępowanie po wystąpieniu błędu

Nie należy usuwać ograniczenia klucza obcego wyłącznie po to, aby wymusić zapis. Takie działanie może doprowadzić do powstania osieroconych rekordów, których nie da się później jednoznacznie przypisać do właściwego obiektu. Bezpieczniejsze jest ustalenie poprawnej kolejności zapisu, uzupełnienie brakującego rekordu nadrzędnego albo skorygowanie identyfikatora przekazywanego przez aplikację. Przy usuwaniu danych trzeba świadomie określić, czy rekordy podrzędne mają zostać usunięte, odłączone, czy też mają zablokować operację.

Jeżeli błąd klucza obcego występuje w programie uruchamianym na laptopie lub komputerze PC, przyczyną może być zarówno logika samej aplikacji, jak i uszkodzona konfiguracja środowiska, niepełna aktualizacja, problem z lokalnym plikiem danych albo nieprawidłowe działanie systemu. Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów i komputerów stacjonarnych PC, a diagnostyka może objąć stan systemu, instalację programu, działanie nośnika danych oraz podstawowe warunki, w których występuje komunikat. W przypadku aplikacji korzystającej z zewnętrznej bazy danych konieczne jest dodatkowo zachowanie informacji o dokładnym komunikacie, czasie wystąpienia i wykonywanej operacji, aby oddzielić problem komputera od błędu danych lub kodu programu.