Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Função
Aplica-se a:
Databricks SQL preview
Databricks Runtime 11.3 LTS e superior
Retorna expr convertido para BINARY com base em fmt, ou NULL se a entrada não for válida.
Sintaxe
try_to_binary(expr [, fmt] )
Argumentos
-
expr: Uma expressão STRING para converter. -
fmt: Um literal STRING descrevendo como interpretarexpr.
Devoluções
UM BINÁRIO.
Notas
Se fmt for fornecido, deve ser um dos (sem distinção entre maiúsculas e minúsculas):
'HEX'exprdeve ser uma cadeia hexadecimal. Cada caractere deve ser um dígito hexadecimal e deve haver um número par de dígitos. O resultado é a representação binária da cadeia hexadecimal.Se
exprnão for um valor hexadecimal bem formado, a função retornaráNULL. Em vez disso, use to_binary para retornar um erro.'BASE64'exprdeve ser uma cadeia de caracteres codificada RFC 4648 §4: base64 (padrão). O resultado são os dados binários decodificados.'UTF-8'ou'UTF8'expré interpretado como uma cadeia de caracteres UTF-8. O resultado é a representação binária da cadeia de caracteres.
O padrão fmt é 'HEX'.
Exemplos
> SELECT cast(to_binary('537061726B') AS STRING);
Spark
> SELECT cast(to_binary('hello', 'hex') AS STRING);
Error: CONVERSION_INVALID_INPUT
> SELECT cast(try_to_binary('hello', 'hex') AS STRING);
NULL
> SELECT cast(to_binary('537061726B', 'hex') AS STRING);
Spark
> SELECT cast(to_binary('U3Bhcms=', 'base64') AS STRING);
Spark
> SELECT cast(to_binary('U3Bhxcms=', 'base64') AS STRING);
Error: CONVERSION_INVALID_INPUT
> SELECT cast(try_to_binary('U3Bhxcms=', 'base64') AS STRING);
NULL
> SELECT hex(to_binary('서울시(Seoul)', 'UTF-8'));
EC849CEC9AB8EC8B9C2853656F756C29