文档首页/ 数据湖探索 DLI/ Spark SQL语法参考/ 内置函数/ 字符串函数/ encode
更新时间：2023-10-25 GMT+08:00
查看PDF
分享

encode

encode函数用于使用charset的编码方式对str进行编码。

命令格式

encode(string <str>, string <charset>)

参数说明

表1 参数说明

参数

是否必选

参数类型

说明

str

是

STRING

至少要指定2个字符串。

STRING类型。如果输入为BIGINT、DECIMAL、DOUBLE或DATETIME类型，则会隐式转换为STRING类型后参与运算。

charset

是

STRING

编码格式。

取值范围为：UTF-8、UTF-16、UTF-16LE、UTF-16BE、ISO-8859-1、US-ASCII。

返回值说明

返回BINARY类型的值。

str或charset值为NULL时，返回NULL。

示例代码

  • 将字符串abc按照UTF-8格式编码。命令示例如下。
    返回abc。 
    select encode("abc", "UTF-8");
  • 任一输入参数为NULL。命令示例如下。

    返回结果为NULL。

    select encode("abc", null);
父主题： 字符串函数