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

Retorna o tamanho da string especificada como número de bytes. 

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

```
OCTET_LENGTH(expression)
```

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

 *expressão*   
Uma string `CHAR`, uma string `VARCHAR`, uma expressão `VARBYTE` ou uma expressão que é avaliada implicitamente como um tipo `CHAR`, `VARCHAR` ou `VARBYTE`. 

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

 INTEGER   
A função OCTET\$1LENGTH retorna um número inteiro indicando o número de bytes na string de entrada.   
Se a string de entrada for uma cadeia de caracteres, a função [LEN](r_LEN.md) retornará o número real de caracteres em strings multibyte, e não o número de bytes. Por exemplo, uma coluna `VARCHAR(12)` deve armazenar três caracteres chineses de quatro bytes. A função OCTET\$1LENGTH retornará `12` para essa string, e a função LEN retornará `3` para essa mesma string.

## Observações de uso
<a name="r_OCTET_LENGTH_usage_notes"></a>

Se a *expressão* for uma string `CHAR`, a função retornará o comprimento da string `CHAR`. Por exemplo, a saída de uma entrada `CHAR(6)` é `CHAR(6)`. 

Se a *expressão* for uma string `VARCHAR`, os espaços finais serão contados. 

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

Para retornar o número de bytes quando a string `francais` com três espaços finais é lançada em um tipo `CHAR` e `VARCHAR`, use o exemplo a seguir. Para obter mais informações, consulte a [Função 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 retornar o número de bytes e o número de caracteres na string `français`, use o exemplo a seguir.

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

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

Para retornar o número de bytes quando a string `français` é transmitida como um `VARBYTE`, use o exemplo a seguir.

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

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