SAFE_CONVERT_BYTES_TO_STRING

将二进制数据转换为字符串。

命令格式

STRING SAFE_CONVERT_BYTES_TO_STRING(BINARY <value>)

参数说明

value:必填,BINARY类型。待转换的参数值。

返回值说明

返回STRING类型。返回规则如下:

  • 输入参数为STRING类型时,返回原字符串。

  • 输入参数为NULL时,返回报错。

  • 输入参数为非法UTF-8字符时,返回NULL。

使用示例

--返回 alibaba
SELECT SAFE_CONVERT_BYTES_TO_STRING(CAST ('alibaba' AS BINARY));

--返回 abc
SELECT SAFE_CONVERT_BYTES_TO_STRING(X'616263');

--返回 abc
SELECT SAFE_CONVERT_BYTES_TO_STRING(UNHEX('616263'));

--返回 010101
SELECT SAFE_CONVERT_BYTES_TO_STRING('010101');

--返回报错 FAILED: ODPS-0130071:[1,8] Semantic analysis exception - function SAFE_CONVERT_BYTES_TO_STRING is ambiguous with (VOID), candidates are STRING SAFE_CONVERT_BYTES_TO_STRING(BINARY arg0); STRING SAFE_CONVERT_BYTES_TO_STRING(STRING arg0)
SELECT SAFE_CONVERT_BYTES_TO_STRING(null);

--输入参数为非法utf-8字符,返回 NULL
SELECT SAFE_CONVERT_BYTES_TO_STRING(UNHEX('\xc2'));

相关函数

SAFE_CONVERT_BYTES_TO_STRING函数属于字符串函数,更多查找字符串、转换字符串格式的相关函数请参见字符串函数