

 Amazon Redshift dejará de admitir la creación de nuevas UDF de Python a partir del parche 198. Las UDF de Python existentes seguirán funcionando hasta el 30 de junio de 2026. Para obtener más información, consulte la [publicación del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Función TO\$1VARBYTE
<a name="r_TO_VARBYTE"></a>

TO\$1VARBYTE convierte una cadena con un formato especificado en un valor binario. 

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

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

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

 *string*   
Una cadena `CHAR` o `VARCHAR`. 

 *formato*   
El formato de la cadena de entrada. Los valores válidos sin distinción entre mayúsculas y minúsculas son `hex`, `binary`, `utf8` (también `utf-8` y `utf_8`) y `base64`. 

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

`VARBYTE`

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

Para convertir el `6162` hexadecimal en un valor binario, use el siguiente ejemplo. El resultado se muestra automáticamente como representación hexadecimal del valor binario.

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

Para devolver la representación binaria de `4d`, use el siguiente ejemplo. La representación binaria de “4d” es `01001101`.

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

Para convertir la cadena `'a'` en UTF-8 a un valor binario, use el siguiente ejemplo. El resultado se muestra automáticamente como representación hexadecimal del valor binario.

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

Para convertir la cadena `'4'` en hexadecimal a un valor binario, use el siguiente ejemplo. Si la longitud de la cadena hexadecimal es un número impar, entonces se le antepone un `0` que formará un número hexadecimal válido.

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