O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Função TO\$1VARBYTE
<a name="r_TO_VARBYTE"></a>

TO\$1VARBYTE converte uma string no formato especificado para um valor binário. 

## Sintaxe
<a name="r_TO_VARBYTE-synopsis"></a>

```
TO_VARBYTE(string, format)
```

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

 *string*   
Uma string `CHAR` ou `VARCHAR`. 

 *format*   
O formato da string de entrada. Os valores válidos que não diferenciam maiúsculas e minúsculas são `hex`, `binary`, `utf8` (também `utf-8` e `utf_8`) e `base64`. 

## Tipo de retorno
<a name="r_TO_VARBYTE-return-type"></a>

`VARBYTE`

## Exemplos
<a name="r_TO_VARBYTE-examples"></a>

Para converter o hex `6162` em um valor binário, use o exemplo a seguir. O resultado é exibido automaticamente como a representação hexadecimal do valor binário.

```
SELECT TO_VARBYTE('6162', 'hex');
               
+------------+
| to_varbyte |
+------------+
|       6162 |
+------------+
```

Para retornar a representação binária de `4d`, use o exemplo a seguir. A representação binária de '4d' é `01001101`.

```
SELECT TO_VARBYTE('01001101', 'binary');
               
+------------+
| to_varbyte |
+------------+
|         4d |
+------------+
```

Para converter a string `'a'` em UTF-8 em um valor binário, use o exemplo a seguir. O resultado é exibido automaticamente como a representação hexadecimal do valor binário.

```
SELECT TO_VARBYTE('a', 'utf8');
               
+------------+
| to_varbyte |
+------------+
|         61 |
+------------+
```

Para converter a string `'4'` em hexadecimal em um valor binário, use o exemplo a seguir. Se o comprimento da string hexadecimal for um número ímpar, adiciona-se um `0` para formar um número hexadecimal válido.

```
SELECT TO_VARBYTE('4', 'hex');
               
+------------+
| to_varbyte |
+------------+
|         04 |
+------------+
```