全部產品
Search
文件中心

MaxCompute:SAFE_CONVERT_BYTES_TO_STRING

更新時間:Aug 02, 2025

將位元據轉換為字串。

命令格式

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函數屬於字串函數,更多尋找字串、轉換字串格式的相關函數請參見字串函數。