brak mapowania klucza głównego

Brak mapowania klucza głównego to usterka integracji uniemożliwiająca jednoznaczne powiązanie rekordów między systemami.

Na czym polega brak mapowania klucza głównego

Brak mapowania klucza głównego oznacza, że proces wymiany danych nie potrafi wskazać, który atrybut rekordu w jednym systemie odpowiada identyfikatorowi rekordu w drugim systemie. Klucz główny, nazywany także primary key, identyfikuje w sposób jednoznaczny wiersz tabeli. Może nim być pojedyncza kolumna, na przykład id, albo zestaw kilku kolumn tworzących klucz złożony. Mapowanie określa regułę przejścia między identyfikatorem źródłowym i docelowym.

Problem pojawia się wtedy, gdy integracja oczekuje określonego pola, lecz dane go nie zawierają, pole ma inną nazwę albo wartość nie jest zgodna z rejestrem używanym przez system docelowy. Przykładowo rekord klienta może mieć w systemie źródłowym identyfikator customer_id, a aplikacja docelowa może oczekiwać pola client_key. Samo podobieństwo znaczenia nie wystarcza. Konieczna jest jawna reguła wskazująca, skąd pobrać wartość, jakiego jest typu i w jaki sposób powiązać ją z istniejącym rekordem.

Dlaczego identyfikator nie wystarcza bez zgodności danych

Klucz główny powinien być unikalny i niepusty w obrębie tabeli. Jeżeli podczas importu identyfikator zostanie pominięty, zamieniony na pustą wartość albo zduplikowany, system może odrzucić rekord, utworzyć nieprawidłowe powiązanie lub potraktować dane jako nowy obiekt. Również zmiana typu danych może przerwać mapowanie. Wartość liczbowa 125, tekst "125" i identyfikator zapisany z dodatkowymi zerami mogą być porównywane odmiennie, zależnie od reguł aplikacji i warstwy integracyjnej.

Nieprawidłowe mapowanie często dotyczy także kluczy obcych, które wskazują rekord z innej tabeli. Jeżeli zamówienie odwołuje się do identyfikatora klienta, a identyfikator klienta nie został poprawnie przekształcony, rekord zamówienia traci relację z właściwym klientem. W praktyce skutkiem może być brak danych na liście, niezgodna liczba rekordów, błędne aktualizacje albo komunikat o naruszeniu ograniczenia integralności referencyjnej. Błąd może występować tylko dla części danych, na przykład po zmianie formatu identyfikatorów lub po dodaniu nowego typu rekordu.

Ślady błędu w przebiegu importu i synchronizacji

Podczas diagnozowania należy ustalić, na którym etapie znika klucz główny: przy odczycie danych źródłowych, w transformacji, podczas zapisu do systemu docelowego czy dopiero przy tworzeniu powiązania. Pomocne jest porównanie schematu obu stron integracji. Trzeba sprawdzić nazwy pól, typy danych, możliwość występowania wartości pustych, unikalność identyfikatorów oraz reguły dla rekordów nowych i już istniejących. Istotne jest również rozróżnienie między identyfikatorem technicznym a numerem widocznym dla użytkownika, ponieważ numer dokumentu lub nazwa urządzenia nie muszą być kluczem głównym.

W logach warto szukać informacji o nieznalezionym polu, odrzuconym rekordzie, konflikcie unikalności, nieudanym dopasowaniu albo próbie zapisania relacji do nieistniejącego identyfikatora. Sam komunikat „brak mapowania klucza głównego” nie zawsze wskazuje pierwotną przyczynę. Źródłem może być wcześniejsza zmiana struktury pliku, niepełny eksport, filtr usuwający kolumnę, błędna konwersja wartości lub pominięcie tabeli referencyjnej. Bez porównania rekordu przed i po transformacji nie powinno się zakładać, że problem leży wyłącznie w konfiguracji mapowania.

Postępowanie przy problemie na komputerze użytkownika

Jeżeli błąd występuje w aplikacji uruchomionej na laptopie albo komputerze PC, można rozpocząć od odtworzenia problemu, sprawdzenia wersji aplikacji, konfiguracji połączenia oraz dostępności plików używanych przez proces synchronizacji. Należy zachować kopię konfiguracji i przykładowych danych przed zmianami, aby możliwe było porównanie wyników. W przypadku aktualizacji programu trzeba zweryfikować, czy zmienił się format importu, nazwa pola albo sposób identyfikowania rekordów. Nie należy usuwać tabel ani modyfikować danych produkcyjnych bez potwierdzenia zależności między rekordami.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i ich podzespołów, dlatego przy problemach występujących na urządzeniu można zlecić sprawdzenie jego działania, systemu oraz lokalnej konfiguracji potrzebnej do uruchomienia aplikacji. Sama korekta reguły mapowania wymaga jednak dostępu do konfiguracji i dokumentacji konkretnej integracji. Po usunięciu przyczyny należy wykonać kontrolną synchronizację, sprawdzić liczbę przetworzonych rekordów, potwierdzić zachowanie kluczy głównych i obcych oraz upewnić się, że ponowne uruchomienie procesu nie tworzy duplikatów.