# Funciones de cadena
<a name="s3-select-sql-reference-string"></a>

**importante**  
Amazon S3 Select ya no está disponible para los nuevos clientes. Los clientes actuales de Amazon S3 Select pueden seguir utilizando la característica de la forma habitual. [Más información](https://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/) 

Amazon S3 Select admite las siguientes funciones de cadena.

**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` (o `CHARACTER_LENGTH`) cuenta el número de caracteres de la cadena especificada.

**nota**  
`CHAR_LENGTH` y `CHARACTER_LENGTH` son sinónimos.

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

```
CHAR_LENGTH ( string )
```

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

 *`string`*   
La cadena de destino sobre la que opera la función.

### Ejemplos
<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 una cadena, `LOWER` convierte todos los caracteres en mayúsculas a minúsculas. Los caracteres que no estén en mayúscula permanecen igual.

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

```
LOWER ( string )
```

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

 **`string`**   
La cadena de destino sobre la que opera la función.

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

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

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

Dada una cadena, un índice de comienzo y, de forma opcional, una longitud, `SUBSTRING` devuelve la subcadena que va desde el índice de comienzo hasta el final de la cadena, o hasta la longitud especificada.

**nota**  
El primer carácter de la cadena de entrada tiene una posición de índice de 1.  
 Si `start` es < 1, sin especificar una longitud, la posición de índice se establece a 1. 
 Si `start` es < 1, con la longitud especificada, la posición de índice se establece a `start + length -1`. 
 Si `start + length -1` < 0, se devuelve una cadena vacía. 
 Si `start + length -1` > = 0, se devuelve la subcadena que comienza en la posición de índice 1 con la longitud `start + length - 1`. 

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

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

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

 **`string`**   
La cadena de destino sobre la que opera la función.

 **`start`**   
La posición de inicio de la cadena.

 **`length`**   
La longitud de la subcadena que se va a devolver. Si no existe, continúa hasta el final de la cadena.

### Ejemplos
<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>

Elimina los caracteres anteriores o posteriores de una cadena. De forma predeterminada, el carácter que se elimina es un espacio (`' '`).

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

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

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

 **`string`**   
La cadena de destino sobre la que opera la función.

 `LEADING` \$1 `TRAILING` \$1 `BOTH`   
Este parámetro indica si se deben eliminar los caracteres anteriores o posteriores, o ambos.

 **`remove_chars`**   
El conjunto de caracteres que se debe eliminar. `remove_chars` puede ser una cadena con longitud > 1. Esta función devuelve la cadena con los caracteres de `remove_chars` encontrados al principio o al final de la cadena que se han eliminado.

### Ejemplos
<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 una cadena, `UPPER` convierte todos los caracteres en minúsculas a mayúsculas. Los caracteres que no estén en minúscula permanecen igual.

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

```
UPPER ( string )
```

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

 **`string`**   
La cadena de destino sobre la que opera la función.

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

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