Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Fonctions de chaîne
<a name="s3-select-sql-reference-string"></a>

**Important**  
Amazon S3 Select n’est plus disponible pour les nouveaux clients. Les clients existants d’Amazon S3 Select peuvent continuer à utiliser cette fonctionnalité comme d’habitude. [En savoir plus](https://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/) 

Amazon S3 Select prend en charge les fonctions de chaîne suivantes.

**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`) compte le nombre de caractères dans la chaîne spécifiée.

**Note**  
`CHAR_LENGTH` et `CHARACTER_LENGTH` sont synonymes.

### Syntaxe
<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`*   
Chaîne cible sur laquelle la fonction opère.

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

À partir d’une chaîne donnée, `LOWER` convertit tous les caractères majuscules en minuscules. Les caractères qui ne sont pas en majuscules restent inchangés.

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

```
LOWER ( string )
```

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

 **`string`**   
Chaîne cible sur laquelle la fonction opère.

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

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

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

À partir d’une chaîne, d’un index de début et éventuellement d’une longueur donnés, `SUBSTRING` renvoie la sous-chaîne de l’index de début à la fin de la chaîne ou à la fin de la longueur précisée.

**Note**  
Le premier caractère de la chaîne d’entrée possède la position d’index 1.  
 Si `start` est < 1, sans longueur spécifiée, la position d’index est définie sur 1. 
 Si `start` est < 1, avec une longueur spécifiée, la position d’index est définie sur `start + length -1`. 
 Si `start + length -1` est < 0, une chaîne vide est renvoyée. 
 Si `start + length -1` est > = 0, la sous-chaîne commençant à la position d’index 1 dont la longueur est `start + length - 1` est renvoyée. 

### Syntaxe
<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`**   
Chaîne cible sur laquelle la fonction opère.

 **`start`**   
Position de début de la chaîne.

 **`length`**   
Longueur de la sous-chaîne à renvoyer. En cas d’absence du paramètre, le traitement s’effectue jusqu’à la fin de la chaîne.

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

Supprime les caractères de tête ou de fin d’une chaîne. Le caractère par défaut à supprimer est un espace (`' '`).

### Syntaxe
<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`**   
Chaîne cible sur laquelle la fonction opère.

 `LEADING` \$1 `TRAILING` \$1 `BOTH`   
Ce paramètre indique s’il faut supprimer les caractères de tête ou de fin ou les deux.

 **`remove_chars`**   
Jeu de caractères à supprimer. `remove_chars` peut être une chaîne de longueur > 1. Cette fonction renvoie la chaîne avec n’importe quel caractère de `remove_chars` se trouvant au début ou à la fin de la chaîne qui a été supprimée.

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

À partir d’une chaîne donnée, `UPPER` convertit tous les caractères minuscules en majuscules. Les caractères qui ne sont pas en minuscules restent inchangés.

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

```
UPPER ( string )
```

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

 **`string`**   
Chaîne cible sur laquelle la fonction opère.

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

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