encode function

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime

Returns the binary representation of a string using the charSet character encoding.

Syntax 

encode(expr, charSet)

Arguments

  • expr: A STRING expression to be encoded.

  • charSet: A STRING expression specifying the encoding.

Returns

A BINARY.

The charset must be one of (case-insensitive):

  • ‘US-ASCII’

  • ‘ISO-8859-1’

  • ‘UTF-8’

  • ‘UTF-16BE’

  • ‘UTF-16LE’

  • ‘UTF-16’

Examples 

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