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 OCTET\_LENGTH
<a name="r_OCTET_LENGTH"></a>

Devuelve la longitud de la cadena especificada como el número de bytes. 

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

```
OCTET_LENGTH(expression)
```

## Argumento
<a name="r_OCTET_LENGTH-argument"></a>

 *expresión*   
Una cadena `CHAR`, una cadena `VARCHAR`, una expresión `VARBYTE` o una expresión que se evalúe de forma implícita como un tipo `CHAR`, `VARCHAR` o `VARBYTE`. 

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

 INTEGER   
La función OCTET\_LENGTH devuelve un valor entero que indica la cantidad de bytes en la cadena de entrada.   
Si la cadena de entrada es una cadena de caracteres, la función [LEN](r_LEN.md) devuelve una cantidad real de caracteres en cadenas multibyte y no la cantidad de bytes. Por ejemplo, una columna `VARCHAR(12)` necesita almacenar tres caracteres chinos de cuatro bytes. La función OCTET\_LENGTH devolverá `12` para esa cadena, y la función LEN devolverá `3` para esa misma cadena.

## Notas de uso
<a name="r_OCTET_LENGTH_usage_notes"></a>

Si *expresión* es una `CHAR`, la función devuelve la longitud de la cadena `CHAR`. Por ejemplo, la salida de una entrada `CHAR(6)` es `CHAR(6)`. 

Si la *expresión* es una cadena `VARCHAR`, los espacios finales se cuentan. 

## Ejemplos
<a name="r_OCTET_LENGTH-example"></a>

Para devolver el número de bytes cuando la cadena `francais` con tres espacios finales se convierte en `CHAR` y un tipo de `VARCHAR`, utilice el siguiente ejemplo. Para obtener más información, consulte la [Función CAST](r_CAST_function.md).

```
SELECT OCTET_LENGTH(CAST('francais   ' AS CHAR(15))) AS octet_length_char, OCTET_LENGTH(CAST('francais   ' AS VARCHAR(15))) AS octet_length_varchar;

+-------------------+----------------------+
| octet_length_char | octet_length_varchar |
+-------------------+----------------------+
|                15 |                   11 |
+-------------------+----------------------+
```

Para devolver el número de bytes y el número de caracteres de la cadena `français`, use el siguiente ejemplo.

```
SELECT OCTET_LENGTH('français'), LEN('français');

+--------------+-----+
| octet_length | len |
+--------------+-----+
|            9 |   8 |
+--------------+-----+
```

Para devolver el número de bytes cuando la cadena `français` se convierte en `VARBYTE`, utilice el siguiente ejemplo.

```
SELECT OCTET_LENGTH(CAST('français' AS VARBYTE));

+--------------+
| octet_length |
+--------------+
|            9 |
+--------------+
```