Błąd 8152 sygnalizuje próbę zapisania wartości przekraczającej dopuszczalny rozmiar zdefiniowany dla danej kolumny.
Co oznacza komunikat SQL Server 8152
Błąd 8152 w Microsoft SQL Server oznacza, że podczas zapisu danych wartość przeznaczona dla kolumny nie mieści się w jej zdefiniowanym rozmiarze. Najczęściej dotyczy to kolumn tekstowych typu varchar(n), nvarchar(n), char(n) lub nchar(n), ale podobny problem może wystąpić również przy zapisie danych binarnych do kolumn varbinary(n) albo binary(n). Przykładowo próba zapisania tekstu o długości 31 znaków do kolumny varchar(20) powoduje odrzucenie operacji, ponieważ wartość przekracza ograniczenie określone w definicji kolumny.
Komunikat może pojawić się przy wykonywaniu instrukcji INSERT lub UPDATE, a także wewnątrz procedury składowanej, wyzwalacza albo operacji kopiowania danych pomiędzy tabelami. Źródłem problemu nie musi być kolumna wskazana bezpośrednio w prostym zapytaniu. W przypadku instrukcji zapisującej dane do kilku kolumn wystarczy, że jedna wartość zostanie skierowana do pola o zbyt małym rozmiarze. SQL Server przerywa wtedy całą operację, jeśli nie zastosowano mechanizmu pozwalającego świadomie obsłużyć konwersję lub odrzucenie nadmiarowej części danych.
Rozmiar kolumny a rzeczywista długość wartości
Podczas analizy trzeba rozróżnić liczbę znaków od liczby bajtów zajmowanych przez dane. Funkcja LEN zwraca długość tekstu bez końcowych spacji, natomiast DATALENGTH zwraca liczbę bajtów przechowywanych w wyrażeniu. Ma to znaczenie dla typów Unicode. Wartość typu nvarchar standardowo zajmuje więcej bajtów niż odpowiadający jej tekst typu varchar, dlatego porównywanie wyłącznie liczby znaków może prowadzić do błędnej diagnozy. Końcowe spacje są również istotne, ponieważ LEN ich nie uwzględnia, a DATALENGTH tak.
Definicję kolumn można sprawdzić w katalogu systemowym SQL Server. Przykładowe zapytanie wykorzystuje widoki sys.columns, sys.tables i sys.types:
SELECT t.name AS table_name, c.name AS column_name, ty.name AS data_type, c.max_length FROM sys.tables AS t JOIN sys.columns AS c ON c.object_id = t.object_id JOIN sys.types AS ty ON ty.user_type_id = c.user_type_id WHERE t.name = N'NazwaTabeli'; W polu max_length dla nvarchar i nchar podawany jest limit w bajtach, więc wartość 100 oznacza maksymalnie 50 jednostek 2-bajtowych, a nie 100 bajtów tekstu. Dla typów o zmiennej długości ograniczenie określa maksymalny rozmiar, a dla typu max wartość -1 oznacza użycie maksymalnego wariantu danego typu.
Ustalenie kolumny powodującej przerwanie zapisu
Pierwszym krokiem jest sprawdzenie mapowania kolumn w instrukcji. Należy unikać zapisu pozycyjnego w rodzaju INSERT INTO tabela VALUES (...), ponieważ zmiana kolejności lub dodanie kolumny może skierować wartość do innego pola niż zakładano. Bezpieczniejszy zapis wymienia kolumny jawnie, na przykład INSERT INTO tabela (nazwa, opis) VALUES (@nazwa, @opis). Warto również sprawdzić typy parametrów procedury składowanej. Parametr zadeklarowany jako varchar(20) może ograniczyć dane jeszcze przed próbą zapisania ich do tabeli, a parametr nvarchar może wymusić konwersję związaną z kodowaniem znaków.
Przy porównywaniu źródła i miejsca docelowego trzeba skontrolować także wyrażenia obliczane, konkatenację oraz konwersje niejawne. Połączenie kilku wartości tekstowych może utworzyć wynik o innym typie i rozmiarze niż pojedyncze pola wejściowe. Dodatkowe dane mogą być dopisywane przez wyzwalacz, więc sama treść instrukcji INSERT nie zawsze pokazuje kompletny przepływ zapisu. Pomocne jest tymczasowe wykonanie zapytania dla pojedynczego rekordu oraz sprawdzenie długości każdej wartości za pomocą LEN i DATALENGTH. W przypadku operacji masowych należy ustalić identyfikator konkretnego rekordu, który zawiera wartość przekraczającą limit.
W nowszych wersjach SQL Server dokładniejszy komunikat o ucięciu tekstu można uzyskać po włączeniu opcji VERBOSE_TRUNCATION_WARNINGS, jeżeli jest dostępna dla używanej wersji i poziomu zgodności bazy. Przykładowo opcję na poziomie bazy ustawia się instrukcją ALTER DATABASE SCOPED CONFIGURATION SET VERBOSE_TRUNCATION_WARNINGS = ON;. W starszych środowiskach można spotkać ustawienie śledzenia diagnostycznego 460, jednak jego użycie zależy od wersji SQL Server i kontekstu wykonania. Przed zastosowaniem takiej zmiany trzeba potwierdzić wersję silnika oraz poziom zgodności bazy.
Naprawa przy zachowaniu kompletności danych
Usunięcie błędu powinno wynikać z ustalonej reguły biznesowej i technicznej. Jeżeli kolumna została zaprojektowana zbyt wąsko, można zmienić jej typ na większy, na przykład zwiększyć rozmiar varchar(n) albo nvarchar(n), o ile nie narusza to indeksów, ograniczeń, procedur i aplikacji korzystających z tabeli. Jeżeli dane mają charakter Unicode, właściwym typem może być nvarchar; zamiana na varchar może spowodować utratę znaków, których bieżące kodowanie nie reprezentuje.
Jeżeli limit jest celowy, aplikacja lub procedura powinna walidować dane przed zapisem i zwracać informację, która kolumna oraz który rekord nie spełniają warunku. Automatyczne obcinanie tekstu, na przykład przez LEFT(@wartosc, 20), jest bezpieczne tylko wtedy, gdy utrata nadmiarowych znaków została świadomie zaakceptowana. W przeciwnym razie może zniszczyć identyfikator, nazwę pliku, adres albo inną wartość potrzebną do prawidłowego działania systemu. Przy danych binarnych analogiczna operacja może usunąć część zawartości i uczynić ją nieużyteczną.
Po zmianie schematu lub walidacji należy ponownie wykonać problematyczny zapis, sprawdzić wszystkie ścieżki wykorzystujące daną tabelę i zweryfikować operacje aktualizujące istniejące rekordy. W środowisku laptopa lub komputera PC błąd 8152 może być widoczny jako komunikat aplikacji, mimo że jego przyczyna znajduje się w lokalnej bazie danych albo w programie korzystającym z SQL Server. Rzetelna diagnostyka obejmuje więc treść błędu, zapytanie, parametry, definicję tabeli oraz sposób konwersji danych przed zapisem.
