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.