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.

# Fonction SUBSTRING dans Amazon QLDB
<a name="ql-functions.substring"></a>

**Important**  
Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez [Migrer un registre Amazon QLDB vers Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Dans Amazon QLDB, utilisez `SUBSTRING` la fonction pour renvoyer une sous-chaîne à partir d'une chaîne donnée. La sous-chaîne commence à partir de l'index de départ spécifié et se termine au dernier caractère de la chaîne ou à la longueur spécifiée.

## Syntaxe
<a name="ql-functions.substring.syntax"></a>

```
SUBSTRING ( string, start-index [, length ] )
```

## Arguments
<a name="ql-functions.substring.arguments"></a>

*string*  
Nom du champ ou expression du type de données à `string` partir duquel extraire une sous-chaîne.

*start-index*  
La position de départ à *string* partir de laquelle commencer l'extraction. Ce numéro peut être négatif.  
Le premier caractère de *string* a un indice de 1.

*length*  
(Facultatif) Le nombre de caractères (points de code) à extraire du*string*, en commençant *start-index* et en finissant par (*start-index*\$1*length*) - 1. En d'autres termes, la longueur de la sous-chaîne. Ce numéro ne peut pas être négatif.  
Si ce paramètre n'est pas fourni, la fonction continue jusqu'à la fin du*string*.

## Type de retour
<a name="ql-functions.substring.return-type"></a>

`string`

## Exemples
<a name="ql-functions.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', 0, 2)   -- '1'
SUBSTRING('123456789', 1, 999) -- '123456789'
SUBSTRING('123456789', 1, 2)   -- '12'
SUBSTRING('1', 1, 0)           -- ''
SUBSTRING('1', 1, 0)           -- ''
SUBSTRING('1', -4, 0)          -- ''
SUBSTRING('1234', 10, 10)      -- ''

-- Runnable statements
SELECT SUBSTRING('123456789', 1) FROM << 0 >>    -- "123456789"
SELECT SUBSTRING('123456789', 1, 2) FROM << 0 >> -- "12"
```

## Fonctions associées
<a name="ql-functions.substring.related"></a>
+ [CHAR\$1LENGTH](ql-functions.char_length.md)
+ [LOWER](ql-functions.lower.md)
+ [TRIM](ql-functions.trim.md)
+ [UPPER](ql-functions.upper.md)