As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Função UNHEX
<a name="UNHEX"></a>

A função UNHEX converte uma string hexadecimal de volta à sua representação de string original.

Essa função pode ser útil em cenários em que você precisa trabalhar com dados que foram armazenados ou transmitidos em formato hexadecimal e restaurar a representação da string original para processamento ou exibição adicionais.

[A função UNHEX é a contrapartida da função HEX.](HEX.md)

## Sintaxe
<a name="UNHEX-syntax"></a>

```
unhex(expr)
```

## Argumentos
<a name="UNHEX-arguments"></a>

 *expr*   
Uma expressão STRING de caracteres hexadecimais.

## Tipo de retorno
<a name="UNHEX-returns"></a>

UNHEX retorna um BINÁRIO. 

Se o comprimento de *expr* for ímpar, o primeiro caractere será descartado e o resultado será preenchido com um byte nulo. Se *expr* contiver caracteres não hexadecimais, o resultado será NULL.

## Exemplo
<a name="UNHEX-example"></a>

O exemplo a seguir converte uma string hexadecimal de volta à sua representação de string original usando as funções UNHEX () e DECODE () juntas. A primeira parte da consulta usa a função UNHEX () para converter a string hexadecimal '537061726B2053514C' em sua representação binária. A segunda parte da consulta usa a função DECODE () para converter os dados binários obtidos da função UNHEX () em uma string, usando a codificação de caracteres 'UTF-8'. A saída da consulta é a string original 'Spark\$1SQL' que foi convertida em hexadecimal e depois novamente em uma string.

```
SELECT decode(unhex('537061726B2053514C'), 'UTF-8');
 Spark SQL
```