Error 8152 – przekroczenie długości kolumny

Error 8152 sygnalizuje próbę zapisania wartości przekraczającej dopuszczalną długość zdefiniowaną dla danej kolumny.

Co oznacza komunikat SQL Server 8152

Błąd SQL Server 8152 oznacza, że podczas zapisu silnik otrzymał wartość, której nie można zmieścić w docelowej kolumnie. Najczęściej komunikat ma treść „String or binary data would be truncated”, czyli „dane tekstowe lub binarne zostałyby obcięte”. SQL Server przerywa wtedy operację, ponieważ automatyczne skrócenie wartości mogłoby spowodować utratę informacji. Problem dotyczy konkretnego miejsca zapisu, a nie całej tabeli ani wszystkich kolumn tego samego typu.

Przyczyną może być zbyt długi tekst dla kolumny typu varchar(n), nvarchar(n) albo char(n), ale także zbyt duża wartość binarna dla binary(n) lub varbinary(n). W przypadku nvarchar(n) parametr n oznacza liczbę jednostek UTF-16, natomiast dla typów varchar i varbinary ograniczenie odnosi się zasadniczo do liczby bajtów. Znak spoza podstawowego zakresu Unicode może zajmować w nvarchar dwie jednostki kodowe, dlatego sama liczba widocznych znaków nie zawsze wystarcza do oceny długości.

Gdzie powstaje przekroczenie długości

Błąd może wystąpić przy instrukcjach INSERT i UPDATE, ale również podczas ładowania danych przez INSERT ... SELECT, procedurę składowaną, wyzwalacz, widok albo proces importu. Wartość może pochodzić z parametru aplikacji, pliku, innej tabeli lub wyrażenia złożonego z kilku pól. Ograniczenie jest sprawdzane względem kolumny docelowej, więc poprawna długość w tabeli źródłowej nie gwarantuje poprawnego zapisu w tabeli, do której dane są kopiowane.

Do błędu prowadzi także konwersja niejawna. Przykładowo konkatenacja kilku wartości może utworzyć tekst dłuższy niż przewidziano w kolumnie wynikowej, a zapis do typu char(n) lub varchar(n) może nie pomieścić rezultatu. Trzeba sprawdzić również wyzwalacze uruchamiane po operacji, ponieważ podstawowy INSERT może wyglądać poprawnie, podczas gdy wyzwalacz kopiuje dane do innej tabeli z krótszą kolumną. Analogicznie problem może znajdować się w tabeli historii, audytu albo kolejce używanej przez aplikację.

Ustalenie kolumny i wartości powodującej błąd

Pierwszym krokiem jest porównanie definicji kolumn docelowych z rzeczywistymi wartościami przekazywanymi do zapisu. Definicję tabeli można odczytać między innymi z widoków katalogowych sys.columns i sys.types, a długość danych tekstowych zmierzyć funkcjami LEN oraz DATALENGTH. LEN pomija końcowe spacje, dlatego przy analizie kolumn typu char lub danych, w których spacje mają znaczenie, przydatne jest także DATALENGTH. Dla wartości Unicode pozwala ona ocenić faktyczną liczbę zajmowanych bajtów.

W starszych konfiguracjach SQL Server komunikat 8152 nie zawsze wskazuje nazwę tabeli i kolumny. Pomocne może być odtworzenie pojedynczej operacji na kontrolowanym zestawie danych, rozbicie wielokolumnowego zapisu na mniejsze fragmenty oraz osobne sprawdzenie wyzwalaczy i procedur. Nowsze wersje SQL Server mogą zwracać bardziej szczegółowy komunikat 2628, zależnie od wersji silnika, poziomu zgodności bazy i ustawień dotyczących szczegółowych ostrzeżeń o obcinaniu danych. Nie należy jednak zakładać, że sama zmiana komunikatu naprawia przyczynę problemu.

Naprawa zgodna z modelem danych

Właściwe rozwiązanie zależy od tego, czy długość wartości jest prawidłowa biznesowo. Jeśli kolumna została zdefiniowana zbyt wąsko, należy zmienić jej typ lub rozmiar, uwzględniając zależne indeksy, ograniczenia, klucze, procedury i aplikacje korzystające z tabeli. Jeżeli długi tekst jest oczekiwany, można rozważyć typ varchar(max) albo nvarchar(max), ale nie powinno się stosować go automatycznie. Typy max mają inne właściwości wydajnościowe i indeksowania niż typy o określonej długości.

Jeżeli nadmiarowe znaki są błędem danych wejściowych, aplikacja lub procedura powinna walidować długość przed wykonaniem zapisu i zwracać jednoznaczną informację o polu wymagającym korekty. Jawne użycie CAST lub CONVERT może uporządkować typy, lecz samo skracanie przez LEFT albo konwersję do krótszego typu jest bezpieczne tylko wtedy, gdy obcięcie zostało świadomie zaakceptowane. Podczas diagnostyki laptopa lub komputera PC problem tego rodzaju wymaga sprawdzenia programu, konfiguracji połączenia i struktury używanej bazy, a nie wymiany podzespołu. Naprawa powinna zakończyć się testem zapisu danych o długości granicznej oraz potwierdzeniem, że nie występuje ukryte obcinanie w wyzwalaczach lub procesach importu.