decode (znaková sada) funkce

Platí pro:zaškrtnuto Databricks SQL zaškrtnuto Databricks Runtime

Přeloží binární expr soubor na řetězec pomocí kódování charSetznakové sady .

Syntaxe

decode(expr, charSet)

Argumenty

  • expr: Výraz BINARY kódovaný v charset.
  • charSet: Výraz STRING .

Návraty

Úloha STRING.

Pokud charSet není podporované kódování, Azure Databricks vyvolá INVALID_PARAMETER_VALUE. ZNAKSET.

Pokud expr obsahuje bajty, které nejsou platné v charSet, Azure Databricks vyvolá MALFORMED_CHARACTER_CODING.

Podporují se následující kódování znakové sady (nerozlišují malá a velká písmena):

  • 'US-ASCII': Sedmibitový ASCII, ISO646-US.
  • 'ISO-8859-1': ISO latinská abeceda č. 1, ISO-LATIN-1.
  • 'UTF-8': Osmibitový formát transformace UCS.
  • 'UTF-16BE': Šestnáctibitový formát transformace UCS, pořadí velkých bajtů.
  • 'UTF-16LE': Šestnáctibitový formát transformace UCS, malé-endianové pořadí bajtů.
  • 'UTF-16': Šestnáctibitový formát transformace UCS, pořadí bajtů identifikované volitelným znakem pořadí bajtů.

Běžné chybové podmínky

Příklady

-- Wrap encode in hex to normalize UI dependent BINARY output.
> SELECT hex(encode('Spark SQL', 'UTF-16'));
 FEFF0053007000610072006B002000530051004C

> SELECT hex(encode('Spark SQL', 'US-ASCII'));
537061726B2053514C

> SELECT decode(X'FEFF0053007000610072006B002000530051004C', 'UTF-16')
 Spark SQL

-- 0xFF is not valid US-ASCII.
> SELECT decode(x'FF', 'US-ASCII');
  Error: MALFORMED_CHARACTER_CODING