# Funções de string
<a name="s3-select-sql-reference-string"></a>

**Importante**  
O Amazon S3 Select não está mais disponível para novos clientes. Os clientes existentes do Amazon S3 Select podem continuar usando o recurso normalmente. [Saiba mais](https://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/) 

O Amazon S3 Select é compatível com as seguintes funções de string.

**Topics**
+ [CHAR\$1LENGTH, CHARACTER\$1LENGTH](#s3-select-sql-reference-char-length)
+ [LOWER](#s3-select-sql-reference-lower)
+ [SUBSTRING](#s3-select-sql-reference-substring)
+ [TRIM](#s3-select-sql-reference-trim)
+ [UPPER](#s3-select-sql-reference-upper)

## CHAR\$1LENGTH, CHARACTER\$1LENGTH
<a name="s3-select-sql-reference-char-length"></a>

`CHAR_LENGTH` (ou `CHARACTER_LENGTH`) conta o número de caracteres na string especificada.

**nota**  
`CHAR_LENGTH` e `CHARACTER_LENGTH` são sinônimos.

### Sintaxe
<a name="s3-select-sql-reference-char-length-syntax"></a>

```
CHAR_LENGTH ( string )
```

### Parâmetros
<a name="s3-select-sql-reference-char-length-parameters"></a>

 *`string`*   
A string de destino na qual a função opera.

### Exemplos
<a name="s3-select-sql-reference-char-length-examples"></a>

```
CHAR_LENGTH('')          -- 0
CHAR_LENGTH('abcdefg')   -- 7
```

## LOWER
<a name="s3-select-sql-reference-lower"></a>

Dada uma string, `LOWER` converte todos os caracteres maiúsculos em minúsculos. Todos os caracteres minúsculos permanecem inalterados.

### Sintaxe
<a name="s3-select-sql-reference-lower-syntax"></a>

```
LOWER ( string )
```

### Parâmetros
<a name="s3-select-sql-reference-lower-parameters"></a>

 **`string`**   
A string de destino na qual a função opera.

### Exemplos
<a name="s3-select-sql-reference-lower-examples"></a>

```
LOWER('AbCdEfG!@#$') -- 'abcdefg!@#$'
```

## SUBSTRING
<a name="s3-select-sql-reference-substring"></a>

Dada uma string, um índice inicial e, opcionalmente, um tamanho, `SUBSTRING` retorna a substring do índice inicial até o final da string ou até o tamanho fornecido.

**nota**  
O primeiro caractere da string de entrada tem uma posição de índice de 1.  
 Se `start` < 1, sem comprimento especificado, a posição do índice será definida como 1. 
 Se `start` for < 1, sem comprimento especificado, a posição do índice será definida como `start + length -1`. 
 Se `start + length -1` < 0, uma string vazia será retornada. 
 Se `start + length -1` > = 0, a substring começando na posição de índice 1 de comprimento `start + length - 1` será retornada. 

### Sintaxe
<a name="s3-select-sql-reference-substring-syntax"></a>

```
SUBSTRING( string FROM start [ FOR length ] )
```

### Parâmetros
<a name="s3-select-sql-reference-substring-parameters"></a>

 **`string`**   
A string de destino na qual a função opera.

 **`start`**   
A posição inicial da string.

 **`length`**   
O tamanho da substring a ser retornada. Se não estiver presente, prossiga para o final da string.

### Exemplos
<a name="s3-select-sql-reference-substring-examples"></a>

```
SUBSTRING("123456789", 0)      -- "123456789"
SUBSTRING("123456789", 1)      -- "123456789"
SUBSTRING("123456789", 2)      -- "23456789"
SUBSTRING("123456789", -4)     -- "123456789"
SUBSTRING("123456789", 0, 999) -- "123456789" 
SUBSTRING("123456789", 1, 5)   -- "12345"
```

## TRIM
<a name="s3-select-sql-reference-trim"></a>

Corta os caracteres iniciais ou finais de uma string. O caractere padrão a ser removido é um espaço (`' '`).

### Sintaxe
<a name="s3-select-sql-reference-trim-syntax"></a>

```
TRIM ( [[LEADING | TRAILING | BOTH remove_chars] FROM] string )
```

### Parâmetros
<a name="s3-select-sql-reference-trim-parameters"></a>

 **`string`**   
A string de destino na qual a função opera.

 `LEADING` \$1 `TRAILING` \$1 `BOTH`   
Esse parâmetro indica se é necessário cortar os caracteres iniciais ou finais, ou ambos.

 **`remove_chars`**   
O conjunto de caracteres a ser removido. `remove_chars` pode ser uma string com tamanho > 1. Essa função retorna a string com qualquer caractere de `remove_chars` encontrado no início ou final da string que foi removida.

### Exemplos
<a name="s3-select-sql-reference-trim-examples"></a>

```
TRIM('       foobar         ')               -- 'foobar'
TRIM('      \tfoobar\t         ')            -- '\tfoobar\t'
TRIM(LEADING FROM '       foobar         ')  -- 'foobar         '
TRIM(TRAILING FROM '       foobar         ') -- '       foobar'
TRIM(BOTH FROM '       foobar         ')     -- 'foobar'
TRIM(BOTH '12' FROM '1112211foobar22211122') -- 'foobar'
```

## UPPER
<a name="s3-select-sql-reference-upper"></a>

Dada uma string, `UPPER` converte todos os caracteres minúsculos em maiúsculos. Todos os caracteres maiúsculos permanecem inalterados.

### Sintaxe
<a name="s3-select-sql-reference-upper-syntax"></a>

```
UPPER ( string )
```

### Parâmetros
<a name="s3-select-sql-reference-upper-parameters"></a>

 **`string`**   
A string de destino na qual a função opera.

### Exemplos
<a name="s3-select-sql-reference-upper-examples"></a>

```
UPPER('AbCdEfG!@#$') -- 'ABCDEFG!@#$'
```