A try_validate_utf8 függvény

A következőre vonatkozik: Databricks SQL Databricks Runtime 15.4 vagy újabb

A bemeneti értéket adja vissza, ha egy érvényes UTF-8 sztringnek felel meg, vagy NULL másként.

Szemantika

try_validate_utf8(strExpr)

Argumentumok

• strExpr: Kifejezés STRING .

Válaszok

Egy STRING bájttal egyenlő strExpr , ha érvényes UTF-8 sztringet jelöl, vagy NULL más módon.

Ha hibát szeretne visszaadni, ha a bemenet nem érvényes UTF-8 sztring, használja a validate_utf8 függvényt.

Példák

-- Simple example taking a valid string as input.
> SELECT try_validate_utf8('Spark')
  Spark

-- Simple example taking a valid collated string as input.
> SELECT try_validate_utf8('SQL' COLLATE UTF8_LCASE)
  SQL

-- Simple example taking a valid hexadecimal string as input.
> SELECT try_validate_utf8(x'61')
  a

-- Example taking an invalid hexadecimal string as input (illegal UTF-8 byte sequence).
> SELECT try_validate_utf8(x'80')
  NULL

-- Example taking an invalid hexadecimal string as input (illegal UTF-8 byte sequence).
> SELECT try_validate_utf8(x'61C262')
  NULL

Kapcsolódó függvények

• is_valid_utf8 függvény
• make_valid_utf8 függvény
• validate_utf8 függvény