適用対象: Databricks SQL
Databricks Runtime 10.4 LTS 以降
キャストがサポートされている場合は、sourceExpr
にキャストtargetType
の値を返します。それ以外の場合は、NULL
の型からsourceExpr
へのキャストがサポートされている場合は、targetType
を返します。 ソースとターゲットの型が有効なキャストの組み合わせでない場合は、 DATATYPE_MISMATCH
エラーが返されます。 サポートされているキャストの組み合わせについては、「 戻り値 」を参照してください。
構文
try_cast(sourceExpr AS targetType)
引数
-
sourceExpr
: 任意のキャスト可能な式。 -
targetType
: 結果の型。
戻り値
結果は targetType
型です。
この関数は、詳細な説明を含む cast
関数 のより緩やかなバリアントです。
try_cast
は、cast
からへのキャストがサポートされている限り、次の条件を許容する点でexpr
関数と異なります。
-
sourceExpr
の値がtargetType
のドメイン内に適合しない場合、結果はオーバーフロー エラーではなくNULL
です。 -
sourceExpr
の値の形式が正しくない場合、または無効な文字が含まれている場合、結果は無効なデータ エラーではなくNULL
です。
上記の例外は次のとおりです。
-
プロパティを持つ
NOT NULL
フィールドへのキャスト。 - MAP キーのキャスト。
例
> SELECT try_cast('10' AS INT);
10
> SELECT try_cast('a' AS INT);
NULL