decode (teckenuppsättning) funktion

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime

Översätter binär expr till en sträng med hjälp av teckenuppsättningen som kodar charSet.

Syntax

decode(expr, charSet)

Argument

  • expr: Ett BINARY uttryck som kodas i charset.
  • charSet: Ett STRING uttryck.

Returer

En STRING.

Om charSet inte stöds skapar Azure Databricks INVALID_PARAMETER_VALUE. CHARSET.

Om expr innehåller byte som inte är giltiga i charSet genererar Azure Databricks MALFORMED_CHARACTER_CODING.

Följande teckenuppsättningskodningar stöds (skiftlägesokänsliga):

  • 'US-ASCII': Sju bitars ASCII, ISO646-US.
  • 'ISO-8859-1': ISO Latinska alfabet nr 1, ISO-LATIN-1.
  • 'UTF-8': Åtta bitars UCS-transformeringsformat.
  • 'UTF-16BE': 16-bitars UCS-transformeringsformat, storslutsbyteordning.
  • 'UTF-16LE': Sexton-bitars UCS-transformeringsformat, liten-endiansk byteordning.
  • 'UTF-16': 16-bitars UCS-transformeringsformat, byteordning identifierad med ett valfritt byteordningsmärke.

Vanliga felvillkor

Exempel

-- 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
  • Last updated on