Błąd naruszenia klucza obcego

Błąd naruszenia klucza obcego sygnalizuje próbę operacji łamiącej relację pomiędzy powiązanymi tabelami.

Jak działa relacja oparta na kluczu obcym

Klucz obcy jest ograniczeniem integralności definiowanym w tabeli zależnej. Jego wartość wskazuje rekord w tabeli nadrzędnej, zwykle przez odwołanie do klucza głównego albo do kolumn objętych ograniczeniem unikalności. Przykładowo tabela zamówienia może zawierać kolumnę klient_id, której wartości muszą odpowiadać istniejącym identyfikatorom w tabeli klienci. Dzięki temu baza nie przechowuje zamówienia przypisanego do nieistniejącego klienta. Konkretna składnia deklaracji klucza obcego zależy od używanego silnika bazy danych, ale sens ograniczenia pozostaje taki sam: wartość w tabeli podrzędnej musi mieć prawidłowy odpowiednik w tabeli nadrzędnej.

Błąd naruszenia klucza obcego pojawia się wtedy, gdy wykonywana operacja złamałaby tę regułę. Najczęstszy przypadek to próba dodania lub zmodyfikowania rekordu podrzędnego z identyfikatorem, dla którego nie istnieje rekord nadrzędny. Naruszenie może także nastąpić podczas usuwania albo zmiany rekordu nadrzędnego, jeśli nadal istnieją powiązane rekordy zależne, a definicja relacji nie określa, co należy z nimi zrobić. Jest to błąd spójności danych, a nie awaria sprzętu, uszkodzenie pamięci masowej ani samoistny dowód problemu z systemem operacyjnym.

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

Podczas wstawiania danych aplikacja może najpierw utworzyć rekord zależny, a dopiero później rekord nadrzędny. Taka kolejność jest nieprawidłowa, ponieważ w chwili zapisu nie istnieje jeszcze wymagany wiersz referencyjny. Podobny skutek ma przesłanie pustego, obciętego lub błędnie zmapowanego identyfikatora. Problem występuje również wtedy, gdy aplikacja korzysta z innej bazy, schematu albo środowiska niż to, w którym utworzono rekord nadrzędny. Wtedy identyfikator może być poprawny w jednym miejscu, lecz nieznany w miejscu wykonania zapytania.

Przy aktualizacji trzeba sprawdzić, czy nowa wartość kolumny klucza obcego nadal wskazuje istniejący rekord. Przy usuwaniu kolejność jest odwrotna: nie można usunąć rekordu nadrzędnego, jeśli rekordy zależne nadal się do niego odwołują, chyba że relacja dopuszcza automatyczne usuwanie zależności lub inne określone zachowanie. W zależności od konfiguracji stosuje się między innymi blokowanie operacji, ustawienie wartości zależnej na NULL albo kaskadowe usunięcie powiązanych rekordów. Takie działania muszą wynikać z modelu danych, ponieważ przypadkowa kaskada może usunąć większy zakres informacji, niż zakładał użytkownik.

Sprawdzanie przyczyny bez naruszania spójności danych

Diagnostykę należy rozpocząć od pełnego komunikatu błędu, nazwy tabeli zależnej, nazwy kolumny oraz operacji, która się nie powiodła. Następnie porównuje się wartość przesłaną przez aplikację z rekordami tabeli nadrzędnej. Trzeba uwzględnić typ danych, dokładną wartość, wartość pustą oraz sposób konwersji identyfikatora. Warto także ustalić, czy rekord nadrzędny został zatwierdzony w tej samej transakcji i połączeniu z bazą. Niezatwierdzona transakcja lub wycofanie wcześniejszego zapisu może sprawić, że aplikacja otrzyma identyfikator, którego późniejsze zapytanie nie znajdzie.

Nie należy usuwać ograniczenia tylko po to, aby komunikat zniknął. Klucz obcy wykrywa sytuację, która mogłaby pozostawić w bazie osierocone rekordy albo błędne powiązania. Bezpieczniejsze jest prześledzenie danych od formularza lub importu, przez warstwę aplikacji, aż do zapytania wykonującego zapis. Pomocne bywa rejestrowanie parametrów zapytania, identyfikatora transakcji oraz kolejności operacji, przy czym log powinien zawierać wyłącznie informacje potrzebne do diagnozy. Jeżeli błąd występuje po imporcie, należy sprawdzić kolejność ładowania tabel, kompletność identyfikatorów nadrzędnych i ewentualne duplikaty w źródle. Test naprawy powinien obejmować zarówno poprawny zapis, jak i próbę celowo niepoprawnego powiązania, która powinna zostać odrzucona.

Gdy błąd pojawia się w aplikacji na komputerze

Na laptopie lub komputerze PC komunikat o naruszeniu klucza obcego zwykle pochodzi z programu korzystającego z bazy danych, a nie z podzespołu komputera. Może pojawić się w programie magazynowym, księgowym, serwisowym, sklepie internetowym działającym lokalnie albo podczas synchronizacji danych. W pierwszej kolejności warto zapisać godzinę wystąpienia problemu, wykonywaną czynność i dokładną treść komunikatu. Następnie można sprawdzić, czy błąd dotyczy wszystkich rekordów, czy tylko konkretnego formularza, importu lub użytkownika. Jeżeli inne funkcje programu działają poprawnie, sama obecność tego błędu nie uzasadnia wymiany dysku, pamięci RAM ani płyty głównej.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i podzespołów, a przy problemach z aplikacją może pomóc rozdzielić usterkę sprzętową od błędu konfiguracji lub danych programu. W przypadku naruszenia klucza obcego istotne jest zachowanie kopii zapasowej oraz niedokonywanie ręcznych zmian w plikach bazy bez znajomości jej struktury. Serwisant może sprawdzić działanie systemu, połączenie z lokalną bazą, uprawnienia programu, stan nośnika i logi aplikacji, natomiast poprawa samej relacji wymaga zgodności z dokumentacją programu albo konsultacji z jego producentem. Po usunięciu przyczyny należy ponowić operację na kontrolnym rekordzie i potwierdzić, że dane nadrzędne oraz zależne pozostają spójne.