TRY_CONVERT

TRY_CONVERT działa podobnie do TRY_CAST, ale przyjmuje dodatkowy parametr stylu konwersji.

TRY_CONVERT – czym jest i do czego służy

TRY_CONVERT to funkcja języka Transact-SQL dostępna w systemie Microsoft SQL Server. Służy do bezpiecznej próby przekształcenia wartości z jednego typu danych na inny, na przykład tekstu na liczbę, tekstu na datę albo wartości liczbowej na tekst. Jeżeli przekazany argument może zostać poprawnie zinterpretowany w docelowym typie, zwracany jest wynik konwersji. Jeżeli konwersja się nie powiedzie, funkcja zwraca wartość NULL zamiast przerywać wykonywanie całego zapytania błędem.

Takie zachowanie ma znaczenie przede wszystkim podczas pracy z danymi pochodzącymi z formularzy, plików tekstowych, importów, raportów lub starszych baz danych. W praktycznych zbiorach często występują rekordy niepełne, zawierające spacje, niejednolity zapis daty, niewłaściwe separatory dziesiętne albo tekst w kolumnie, która docelowo powinna zawierać wartości liczbowe. Zastosowanie TRY_CONVERT pozwala oddzielić poprawne dane od problematycznych bez zatrzymywania całej operacji.

Ogólna postać funkcji wygląda następująco:

TRY_CONVERT(typ_danych, wyrażenie [, styl])

Pierwszy argument określa oczekiwany typ wyniku. Drugi zawiera wartość przeznaczoną do przekształcenia. Opcjonalny trzeci argument jest numerem stylu, który może zmieniać sposób interpretacji określonych danych, szczególnie dat, czasu oraz wartości zapisanych w formacie binarnym lub znakowym. Wynik funkcji powinien być dalej traktowany jako wartość potencjalnie pusta, ponieważ nieudana próba konwersji jest sygnalizowana przez NULL.

TRY_CONVERT – kontekst techniczny i porównanie z innymi konwersjami

W SQL Server można spotkać kilka sposobów zmiany typu danych. CAST ma prostą, standardową składnię i dobrze sprawdza się wtedy, gdy poprawność danych jest zagwarantowana. CONVERT oferuje dodatkowo parametr stylu, dzięki czemu pozwala precyzyjniej określić sposób interpretacji niektórych wartości. TRY_CAST zachowuje się podobnie do bezpiecznej konwersji, lecz nie udostępnia parametru stylu. TRY_CONVERT łączy natomiast bezpieczne zakończenie nieudanej próby z możliwością podania stylu.

Różnica między zwykłą konwersją a funkcją TRY_CONVERT staje się widoczna przy filtrowaniu rekordów. Przy użyciu CAST lub CONVERT pojedyncza niepoprawna wartość może spowodować błąd całego polecenia. TRY_CONVERT przekształca rekordy możliwe do obsłużenia, a przy pozostałych zwraca NULL. Dzięki temu można później zastosować warunek, agregację albo osobny raport kontrolny.

Przykładowa konwersja tekstu do liczby może wyglądać tak:

SELECT TRY_CONVERT(int, KolumnaTekstowa) AS WartoscLiczbowa
FROM Dane;

Jeśli w kolumnie znajdzie się zapis liczbowy, zostanie zwrócona wartość typu int. Dla tekstu zawierającego litery, niepasujące znaki lub pusty zapis wynikiem będzie NULL. Samo użycie funkcji nie naprawia danych źródłowych. Jedynie ujawnia, które wartości mogą zostać bezpiecznie odczytane w wybranym typie.

Parametr stylu jest szczególnie przydatny przy datach. Ten sam ciąg znaków może zostać odczytany różnie w zależności od kolejności dnia, miesiąca i roku oraz przyjętego separatora. Jawne wskazanie stylu ogranicza zależność od ustawień sesji i regionalnych formatów. Należy jednak pamiętać, że styl musi odpowiadać rzeczywistemu zapisowi wartości. Nieprawidłowo dobrany parametr nie gwarantuje poprawnego wyniku i może prowadzić do NULL albo do innej interpretacji daty, niż zakładano.

TRY_CONVERT – typowe problemy przy stosowaniu

Jednym z częstych problemów jest mylenie wartości NULL z zerem, pustym tekstem albo prawidłową wartością domyślną. TRY_CONVERT zwraca NULL, gdy nie może wykonać konwersji, dlatego dalsza logika zapytania powinna świadomie uwzględniać taki przypadek. Automatyczne zastępowanie NULL zerem może zacierać informację o błędnych danych i prowadzić do nieprawidłowych podsumowań.

Inną trudnością jest obecność dodatkowych znaków. Spacje na początku lub końcu tekstu, symbole walut, jednostki miary, separatory tysięcy oraz niewłaściwy znak części dziesiętnej mogą spowodować nieudaną próbę. Przed użyciem TRY_CONVERT można rozważyć oczyszczenie danych za pomocą funkcji tekstowych, ale takie działanie powinno być dopasowane do rzeczywistego formatu. Usuwanie wszystkich znaków innych niż cyfry może z kolei zniszczyć znak minus albo separator dziesiętny.

Warto zwrócić uwagę na zakres docelowego typu. Tekst może mieć poprawną postać liczbową, ale jego wartość może nie mieścić się w wybranym typie całkowitym. W takiej sytuacji również pojawi się NULL. Przy danych finansowych, pomiarowych lub obliczeniowych należy dobrać typ z odpowiednią precyzją i skalą, a nie zakładać, że każdy zapis liczbowy powinien być przechowywany jako liczba całkowita.

Problemy mogą dotyczyć także niejawnych konwersji wykonywanych przez SQL Server. Porównanie kolumn o różnych typach może wymusić zmianę typu po jednej ze stron wyrażenia. Wpływa to na czytelność zapytania, działanie indeksów i sposób obsługi błędnych danych. Jawne zastosowanie TRY_CONVERT w dobrze wybranym miejscu ułatwia kontrolę nad wynikiem, lecz nie powinno zastępować uporządkowania schematu tabeli.

Nie każda konwersja jest dozwolona. W przypadku niektórych całkowicie niezgodnych par typów SQL Server może zgłosić błąd dotyczący niedozwolonej konwersji, zamiast zwrócić NULL. Funkcja zabezpiecza przed niepoprawną zawartością danych, ale nie omija ograniczeń samego mechanizmu typów.

TRY_CONVERT – praktyczne wskazówki dla zapytań i importu danych

Podczas czyszczenia tabeli warto najpierw wyświetlić zarówno wartość źródłową, jak i rezultat próby konwersji. Pozwala to szybko sprawdzić, które rekordy zostały odczytane prawidłowo:

SELECT KolumnaTekstowa,
TRY_CONVERT(decimal(12, 2), KolumnaTekstowa) AS WartoscPoKonwersji
FROM Dane;

Wartość NULL może następnie posłużyć do znalezienia rekordów wymagających weryfikacji:

SELECT *
FROM Dane
WHERE KolumnaTekstowa IS NOT NULL
AND TRY_CONVERT(decimal(12, 2), KolumnaTekstowa) IS NULL;

Taki warunek należy dopasować do danych, ponieważ pusty tekst, same spacje i rzeczywista wartość NULL mogą wymagać odrębnego traktowania. Przy imporcie rozsądne jest zachowanie oryginalnej kolumny tekstowej do czasu zakończenia kontroli. Dopiero po sprawdzeniu wyników można zapisać poprawione dane w kolumnie o docelowym typie.

Przy datach zaleca się stosowanie jednoznacznego formatu albo jawnie określonego stylu. Nie powinno się polegać wyłącznie na tym, że zapytanie działa w jednym środowisku. Ustawienia języka, formatu daty i konfiguracji sesji mogą wpływać na interpretację tekstu. Testowanie powinno obejmować daty graniczne, brakujące wartości, niepełny zapis oraz dane pochodzące z różnych źródeł.

TRY_CONVERT może być także użyty w wyrażeniu CASE, podczas sortowania oraz w zapytaniu agregującym. Trzeba jednak pamiętać, że wartości NULL nie są uwzględniane przez większość funkcji agregujących w taki sam sposób jak zwykłe liczby. Jeżeli raport ma pokazywać liczbę odrzuconych rekordów, należy policzyć je osobno, zamiast zakładać, że suma lub średnia ujawni wszystkie problemy.

W większych zapytaniach korzystne jest ograniczenie powtarzania tej samej konwersji. Wynik można przygotować w podzapytaniu, wyrażeniu CTE albo odpowiednio zaprojektowanym widoku. Poprawia to czytelność i ułatwia późniejszą zmianę typu, stylu lub reguł walidacji. Sama funkcja nie zastępuje testów jakości danych, dokumentacji formatu wejściowego ani kontroli procesu importu.

TRY_CONVERT – kiedy zgłosić się do serwisu komputerowego

Problemy z TRY_CONVERT często pojawiają się jako część szerszych kłopotów z działaniem komputera, bazą danych, importem plików lub konfiguracją środowiska programistycznego. Jeżeli zapytanie wcześniej działało, a po zmianie systemu, sterownika, aplikacji albo źródła danych zaczęło zwracać błędy, warto zabezpieczyć kopię danych, zapisać pełny komunikat i sprawdzić, czy problem dotyczy konkretnej wartości, całej tabeli czy samego środowiska.

Pomoc serwisowa może być przydatna, gdy komputer zawiesza się podczas pracy z bazą, aplikacje nie uruchamiają się prawidłowo, pliki importowane są uszkodzone albo występują powtarzające się problemy z odczytem danych. W takich sytuacjach pomoc świadczy Warszawskie Pogotowie Komputerowe 24/7. Przed przekazaniem sprzętu dobrze przygotować opis objawów, przykład zapytania, informację o źródle danych oraz kopię zapasową, o ile można ją bezpiecznie wykonać.

Przy analizie problemu należy rozdzielić błąd składni, niedozwoloną konwersję typów, nieprawidłowy format danych i awarię samego komputera. TRY_CONVERT może ujawnić niepoprawne rekordy, lecz nie naprawi uszkodzonego pliku, błędnej konfiguracji połączenia ani problemów sprzętowych. Właściwe rozpoznanie przyczyny pozwala dobrać dalsze działania i uniknąć przypadkowego usuwania danych.