Condividi tramite

funzione decode (set di caratteri)

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime

Converte il binario expr in una stringa usando la codifica del set di caratteri charSet.

Sintassi

decode(expr, charSet)

Argomenti

  • expr BINARY: espressione codificata in charset.
  • charSet: un’espressione STRING.

Valori restituiti

Un oggetto STRING.

Se charSet non è una codifica supportata, Azure Databricks genera INVALID_PARAMETER_VALUE. CHARSET.

Se expr contiene byte non validi in charSet, Azure Databricks genera MALFORMED_CHARACTER_CODING.

Sono supportate le codifiche del set di caratteri seguenti (senza distinzione tra maiuscole e minuscole):

  • 'US-ASCII': ASCII a sette bit, ISO 646-US.
  • 'ISO-8859-1': alfabeto latino ISO n. 1, ISO-LATIN-1.
  • 'UTF-8': Formato di Trasformazione UCS a 8 bit.
  • 'UTF-16BE': Formato di trasformazione UCS a sedici bit, ordine dei byte big-endian.
  • 'UTF-16LE': formato di trasformazione UCS a sedici bit, ordine dei byte in modalità little-endian.
  • 'UTF-16': formato di trasformazione UCS a sedici bit, ordine di byte identificato da un marcatore d'ordine dei byte facoltativo.

Condizioni di errore comuni

Esempi

-- 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