Dokumentacja Microsoft – SQL Server Error Reference

Dokumentacja Microsoft dotycząca SQL Server Error Reference to zestawienie kodów błędów tego systemu wraz z ich znaczeniem.

Zakres dokumentacji SQL Server Error Reference

SQL Server Error Reference to dokumentacja firmy Microsoft poświęcona komunikatom i kodom błędów generowanym przez aparat Microsoft SQL Server. Poszczególne wpisy opisują numer błędu, tekst komunikatu, poziom ważności oraz dodatkowy stan wskazujący wariant sytuacji, w której wystąpił problem. Sam numer nie zawsze wystarcza do ustalenia przyczyny, ponieważ ten sam błąd może pojawić się w kilku kontekstach zależnie od instrukcji, obiektu bazy danych, uprawnień albo stanu połączenia.

Informacje o komunikatach są przechowywane w katalogu systemowym SQL Server i mogą być odczytywane między innymi z widoku sys.messages. Widok zawiera komunikaty dostępne dla zainstalowanych języków oraz informacje o ich numerach, poziomach ważności i tekście. W praktyce dokumentacja Error Reference jest punktem odniesienia do interpretacji wpisu z dziennika, komunikatu zwróconego przez sterownik lub błędu widocznego w narzędziu SQL Server Management Studio.

Numer, poziom ważności i stan komunikatu

Komunikat SQL Server może zawierać numer błędu, poziom ważności, wartość stanu, nazwę procedury lub modułu oraz numer wiersza, w którym aparat wykrył problem. Poziom ważności, określany jako severity, opisuje wagę sytuacji. Niskie poziomy mogą oznaczać informacje lub problemy możliwe do obsłużenia przez aplikację, natomiast wyższe poziomy wskazują na błędy wykonania, problemy z zasobami albo uszkodzenie stanu wewnętrznego. Nie należy jednak traktować samej wartości severity jako kompletnej diagnozy, ponieważ znaczenie ma również treść komunikatu i kontekst operacji.

Wartość state pomaga odróżnić warianty tego samego błędu. Dwa komunikaty o identycznym numerze, ale innym stanie, mogą prowadzić do różnych hipotez diagnostycznych. Znaczenie ma także źródło błędu: błąd składni instrukcji Transact-SQL, odmowa dostępu, konflikt blokad, przekroczenie limitu zasobów i problem z plikiem bazy danych wymagają odmiennych czynności. Podczas analizy należy zachować pełny komunikat, a nie tylko jego skróconą nazwę wyświetloną przez aplikację.

Odczytywanie błędów w zapytaniach i logach

Dokumentacja pozwala powiązać komunikat z konkretną operacją, ale nie zastępuje analizy środowiska SQL Server. Przy błędzie zwróconym przez aplikację trzeba sprawdzić tekst całego wyjątku, numer błędu, stan, nazwę bazy danych, użytkownika lub konta wykonującego operację oraz czas wystąpienia. Pomocne jest porównanie tego wpisu z dziennikiem SQL Server, dziennikiem aplikacji i historią wykonywanych poleceń. Skrócenie komunikatu przez warstwę ORM albo sterownik może ukryć parametry potrzebne do rozpoznania problemu.

W przypadku błędów związanych z transakcją trzeba ustalić, czy po wystąpieniu wyjątku transakcja nadal może zostać zatwierdzona, czy wymaga wycofania. Przydatne są informacje o stanie transakcji oraz sposób obsługi błędów w bloku TRY...CATCH. W samym bloku można odczytać między innymi numer błędu, poziom ważności, stan, procedurę i numer wiersza za pomocą funkcji ERROR_NUMBER(), ERROR_SEVERITY(), ERROR_STATE(), ERROR_PROCEDURE() i ERROR_LINE(). Daje to dokładniejszy obraz niż analiza samego tekstu wyświetlonego użytkownikowi.

Diagnostyka na podstawie Error Reference

Rozsądna diagnostyka zaczyna się od odtworzenia warunków wystąpienia błędu na kontrolowanym przykładzie. Należy ustalić, czy problem pojawia się przy jednym zapytaniu, konkretnej tabeli, procedurze składowanej, bazie danych albo koncie logowania. Następnie można zweryfikować składnię i typy danych, istnienie obiektów, uprawnienia, dostępność plików bazy, blokady oraz stan wolnego miejsca. Wnioski powinny wynikać z połączenia komunikatu z obserwowanym zachowaniem, a nie z samego podobieństwa numeru błędu do opisu znalezionego w dokumentacji.

Jeżeli komunikat wskazuje na integralność danych lub strukturę bazy, nie powinno się od razu wykonywać poleceń naprawczych bez wcześniejszego zabezpieczenia kopii i zebrania dowodów. Polecenia diagnostyczne, takie jak kontrola integralności bazy, mogą dostarczyć informacji o zakresie problemu, lecz interpretacja wyników wymaga uwzględnienia wersji SQL Server, konfiguracji bazy i historii awarii. Wpis z SQL Server Error Reference pomaga nazwać klasę problemu i dobrać właściwy kierunek sprawdzania, ale decyzja o zmianie konfiguracji, odtworzeniu danych lub naprawie plików powinna wynikać z pełnej analizy.