Funkcja try_cast

Dotyczy: Databricks SQL Databricks Runtime 10.4 LTS i nowsze

Zwraca wartość sourceExpr rzutowaną na targetType, jeśli rzutowanie jest obsługiwane; w przeciwnym razie zwraca NULL, pod warunkiem, że rzutowanie z typu sourceExpr do targetType jest obsługiwane. Jeśli typy źródłowe i docelowe nie są prawidłowym połączeniem rzutowania, DATATYPE_MISMATCH zwracany jest błąd. Zobacz Zwroty dotyczące obsługiwanych kombinacji rzutów.

Składnia

try_cast(sourceExpr AS targetType)

Argumenty

• sourceExpr: dowolne wyrażenie rzutowalne.
• targetType: typ wyniku.

Zwraca

Wynik jest typu targetType.

Ta funkcja jest bardziej zrelaksowanym wariantem cast funkcji , który zawiera szczegółowy opis.

try_cast różni się od funkcji cast, poprzez tolerowanie następujących warunków, o ile rzutowanie z typu expr do type jest obsługiwane:

• sourceExpr Jeśli wartość nie może mieścić się w domenie targetType wyniku, jest NULL zamiast błędu przepełnienia.
• sourceExpr Jeśli wartość nie jest poprawnie sformułowana lub zawiera nieprawidłowe znaki, wynik jest NULL zamiast nieprawidłowego błędu danych.

Wyjątek od powyższych:

• Rzutowanie do pola STRUCT z właściwością NOT NULL .
• Rzutowanie klucza MAP .

Przykłady

> SELECT try_cast('10' AS INT);
 10

> SELECT try_cast('a' AS INT);
 NULL

Funkcje pokrewne

• :: Operator (znak dwukropka)
• cast funkcja