
ORA-06512 to komunikat Oracle, który wskazuje numer linii w kodzie PL/SQL, w której wystąpił wyjątek. Nie mówi jednak, co go spowodowało. Właściwa przyczyna to zwykle błąd zgłoszony wcześniej w stosie błędów, na przykład nieobsłużony wyjątek albo niezgodność danych. Dlatego ORA-06512 często bierze się błędnie za źródło problemu.
W odróżnieniu od ORA-12154 czy ORA-00600, które zwykle oznaczają problem z połączeniem albo wewnętrzny błąd bazy, ORA-06512 to tylko odwołanie do numeru linii. Mówi, gdzie wystąpił błąd, a nie dlaczego.
ORA-06512 to błąd Oracle, który wskazuje numer linii w bloku PL/SQL lub procedurze składowanej, w której wystąpił wyjątek. Sam w sobie nie podaje przyczyny błędu, tylko miejsce w stosie wywołań, w którym wystąpił wyjątek. Żeby poznać prawdziwą przyczynę, trzeba spojrzeć na wcześniejsze błędy w stosie, na przykład ORA-06502 przy błędach liczbowych lub błędach wartości.
Ten błąd zwykle pojawia się w stosie błędów w dwóch postaciach:
ORA-06512 może wynikać z wielu problemów w środowisku PL/SQL, ale szczególnie częste są trzy rodzaje.
Gdy kod PL/SQL natrafi na sytuację spoza normalnego przetwarzania, na przykład dzielenie przez zero, przepełnienie liczby albo warunek zdefiniowany przez użytkownika, zgłasza wyjątek. Jeśli żaden blok EXCEPTION go nie przechwyci, Oracle rozwija stos wywołań i wyświetla ORA-06512, żeby pokazać, gdzie to się stało. Tak samo kończą się wyjątki zdefiniowane przez użytkownika (zgłaszane przez RAISE) i wyjątki systemowe, takie jak ORA-06502, jeśli nikt ich nie obsłuży.
Częstą przyczyną jest niezgodność typów danych, na przykład:
Takie problemy wywołują wyjątki w czasie wykonania, a te z kolei komunikaty ORA-06512 wskazujące linię z niezgodnym przypisaniem.
Wyjątki mogą też wynikać z innych pomyłek w kodzie:
W każdej z tych sytuacji Oracle zgłasza wyjątek, wyświetla ORA-06512 i przerywa działanie, chyba że kod ma odpowiedni blok obsługi wyjątków.
Żeby ustalić, skąd bierze się ORA-06512, trzeba zwykle spojrzeć dalej niż na sam numer w komunikacie.
ORA-06512 pokazuje tylko linię w jednostce PL/SQL, w której wystąpił wyjątek, więc właściwa przyczyna zwykle jest w błędach zgłoszonych wcześniej. Stos może wyglądać na przykład tak:
ORA-06502: PL/SQL: numeric or value error
ORA-06512: at "SCHEMA.PROCEDURE_NAME", line 5
ORA-06512: at line 1
Pierwszy błąd (ORA-06502) wskazuje błąd liczbowy lub błąd wartości, a ORA-06512 pokazuje, gdzie wystąpił. Zawsze czytaj cały stos błędów, żeby znaleźć główny problem.
Jeśli główny kod wygląda poprawnie, sprawdź wyzwalacze (triggery) i zagnieżdżone procedury, które mogą pośrednio wywołać wyjątek. Na przykład wyzwalacz BEFORE UPDATE na tej samej tabeli może próbować zaktualizować wiersz, który właśnie otrzymał. Prowadzi to do wywołania rekurencyjnego albo błędu niezgodności danych. Przejrzyj zależności i wyzwalacze, które obsługują te same tabele i kolumny co Twoja procedura.
Gdy już wiesz, co jest przyczyną, czy to niezgodność typów, błąd logiki, czy nieobsłużony wyjątek, możesz zastosować konkretne rozwiązanie.
Pierwsze i najprostsze rozwiązanie to usunięcie przyczyny wyjątku:
Jeśli samo usunięcie przyczyny nie wystarcza albo potrzebujesz większej kontroli, dodaj bloki EXCEPTION, które obsłużą błędy w przewidywalny sposób. Blok EXCEPTION pozwala przechwycić konkretne błędy (np. NO_DATA_FOUND lub TOO_MANY_ROWS) albo użyć klauzuli WHEN OTHERS THEN dla nieprzewidzianych sytuacji. Obsługa wyjątków w kodzie PL/SQL pozwala posprzątać po błędzie, zapisać jego szczegóły w logu albo przypisać wartości zastępcze, zamiast pozwolić Oracle przerwać proces i wyświetlić ORA-06512.
Prosty przykład:
BEGIN
-- Operacja, która może się nie udać
SELECT total INTO v_total FROM sales WHERE ...
EXCEPTION
WHEN NO_DATA_FOUND THEN
-- Obsługa sytuacji, gdy zapytanie nie zwraca wierszy
v_total := 0;
WHEN OTHERS THEN
-- Przechwycenie pozostałych wyjątków
RAISE_APPLICATION_ERROR(-20001, 'Wystąpił nieoczekiwany błąd');
END;
W tym przykładzie nieprzechwycone wyjątki nie przechodzą wyżej i nie kończą się ogólnym komunikatem ORA-06512. To Ty decydujesz, jak proces reaguje na błąd i jaki komunikat lub zachowanie zastępcze widzi użytkownik.
Własne komunikaty błędów ułatwiają znalezienie przyczyny każdemu, kto analizuje problem w aplikacji. Zamiast polegać na domyślnych komunikatach Oracle, możesz wywołać RAISE_APPLICATION_ERROR z własnym kodem i opisem:
DECLARE
v_number NUMBER(2);
BEGIN
v_number := 100; -- Wartość za duża dla NUMBER(2)
EXCEPTION
WHEN VALUE_ERROR THEN
RAISE_APPLICATION_ERROR(
-20002,
'Próba zapisania liczby trzycyfrowej w polu dwucyfrowym.'
);
END;
Dzięki temu od razu widać, co poszło nie tak i dlaczego, zamiast stosu błędów, który pokazuje tylko ORA-06512 i ogólny błąd liczbowy.