функция decode (набор символов)

Область применения:отмечено да Databricks SQL отмечено да Databricks Runtime

Преобразует двоичное значение expr в строку с помощью кодировки символьного набора charSet.

Синтаксис

decode(expr, charSet)

Аргументы

  • expr BINARY: выражение, закодированное в charset.
  • charSet: Выражение STRING.

Возвраты

STRING.

Если charSet не поддерживается, Azure Databricks вызывает INVALID_PARAMETER_VALUE. CHARSET.

Если expr содержит байты, недопустимые в charSet, Azure Databricks вызывает MALFORMED_CHARACTER_CODING.

Поддерживаются следующие кодировки набора символов (без учета регистра):

  • 'US-ASCII': семибитный ASCII, ISO646-US.
  • 'ISO-8859-1': латинский алфавит ISO No 1, ISO-LATIN-1.
  • 'UTF-8': восьмибитовый формат преобразования UCS.
  • 'UTF-16BE': шестнадцатибитный формат преобразования UCS, порядок байтов с большим значением.
  • 'UTF-16LE': шестнадцати-разрядный формат преобразования UCS, маленький порядок байтов.
  • 'UTF-16': шестнадцателетний формат преобразования UCS, порядок байтов, определенный необязательным знаком порядка байтов.

Распространенные условия ошибки

Примеры

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