Todos os produtos
Search
Central de documentação

MaxCompute:SAFE_CONVERT_BYTES_TO_STRING

Última atualização: Sep 17, 2026

Converte dados binários em uma string.

Sintaxe

STRING SAFE_CONVERT_BYTES_TO_STRING(BINARY <value>)

Parâmetros

value: obrigatório. O valor BINARY a ser convertido.

Valor de retorno

Retorna um valor do tipo STRING. As regras a seguir se aplicam:

  • Se a entrada for uma STRING, a função retorna a string original.

  • Se o parâmetro de entrada for NULL, a função retornará um erro.

  • Se a entrada contiver um caractere UTF-8 inválido, o resultado será NULL.

Exemplos

-- Returns alibaba
SELECT SAFE_CONVERT_BYTES_TO_STRING(CAST ('alibaba' AS BINARY));

-- Returns abc
SELECT SAFE_CONVERT_BYTES_TO_STRING(X'616263');

-- Returns abc
SELECT SAFE_CONVERT_BYTES_TO_STRING(UNHEX('616263'));

-- Returns 010101
SELECT SAFE_CONVERT_BYTES_TO_STRING('010101');

-- An error is returned. 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);

-- The input parameter contains an invalid UTF-8 character. NULL is returned.
SELECT SAFE_CONVERT_BYTES_TO_STRING(UNHEX('\xc2'));

Funções relacionadas

SAFE_CONVERT_BYTES_TO_STRING é uma função de string. Para obter mais informações sobre funções que pesquisam strings ou convertem formatos de string, consulte String Functions Overview.