

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.

# Création d’un cluster de bases de données qui utilise Aurora Serverless v2
<a name="aurora-serverless-v2.create"></a>

Pour créer un cluster Aurora dans lequel vous pouvez ajouter des instances de base de données Aurora Serverless v2, suivez la même procédure que la rubrique [Création d’un cluster de bases de données Amazon Aurora](Aurora.CreateInstance.md). Avec Aurora Serverless v2, vos clusters sont interchangeables avec les clusters approvisionnés. Vos clusters peuvent contenir des instances de base de données qui utilisent Aurora Serverless v2 et d’autres instances de base de données qui sont approvisionnées.

**Topics**
+ [Paramètres pour les clusters de bases de données Aurora Serverless v2](#aurora-serverless-v2.create-settings)
+ [Création d’un cluster de bases de données Aurora Serverless v2](#aurora-serverless-v2.create-cluster)
+ [Création d’une instance de base de données d’enregistreur Aurora Serverless v2](#aurora-serverless-v2-adding-writer)

## Paramètres pour les clusters de bases de données Aurora Serverless v2
<a name="aurora-serverless-v2.create-settings"></a>

Assurez-vous que les paramètres initiaux du cluster répondent aux exigences répertoriées dans [Exigences et limites relatives à Aurora Serverless v2](aurora-serverless-v2.requirements.md). Spécifiez les paramètres suivants pour vous assurer que vous pouvez ajouter des instances de base de données Aurora Serverless v2 au cluster :

**Région AWS**  
Créez le cluster dans une Région AWS où les instances de base de données Aurora Serverless v2 sont disponibles. Pour plus de détails sur les régions disponibles, consultez [Régions et moteurs de base de données Aurora pris en charge pour Aurora Serverless v2](Concepts.Aurora_Fea_Regions_DB-eng.Feature.ServerlessV2.md).

**Version du moteur de base de données**  
Choisissez une version de moteur compatible avec Aurora Serverless v2. Pour plus d’informations sur la version requise pour Aurora Serverless v2, consultez [Exigences et limites relatives à Aurora Serverless v2](aurora-serverless-v2.requirements.md).

**Classe d’instance de base de données**  
Si vous créez un cluster à l’aide d’AWS Management Console, vous choisissez également la classe d’instance de base de données pour l’instance de base de données du dispositif d’écriture. Choisissez la classe d’instance de base de données **Sans serveur**. Lorsque vous choisissez cette classe d’instance de base de données, vous spécifiez également la plage de capacité de l’instance de base de données d’enregistreur. Cette même plage de capacité s’applique à toutes les autres instances de base de données Aurora Serverless v2 que vous ajoutez à ce cluster.  
Si l’option **Sans serveur** ne s’affiche pas pour la classe d’instance de base de données, assurez-vous d’avoir choisi une version de moteur de base de données prise en charge par [Régions et moteurs de base de données Aurora pris en charge pour Aurora Serverless v2](Concepts.Aurora_Fea_Regions_DB-eng.Feature.ServerlessV2.md).  
Lorsque vous utilisez AWS CLI ou l’API Amazon RDS, le paramètre que vous spécifiez pour la classe d’instance de base de données est `db.serverless`.

**Plage de capacité**  
Renseignez les valeurs minimale et maximale d’unité de capacité Aurora (ACU) qui s’appliquent à toutes les instances de base de données du cluster. Cette option est disponible sur les pages de console **Créer un cluster** et **Ajouter un lecteur** lorsque vous choisissez **Sans serveur** pour la classe d’instance de base de données.  
Pour connaître les plages de capacité autorisées pour les différentes versions du moteur de base de données, consultez [Capacité Aurora Serverless v2](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity).  
Si les champs de valeur minimale et maximale d’ACU ne s’affichent pas, assurez-vous d’avoir choisi la classe d’instance de base de données **Sans serveur** pour l’instance de base de données d’enregistreur.

Si vous créez initialement le cluster avec une instance de base de données approvisionnée, vous ne spécifiez pas les nombres minimal et maximal d’ACU. Dans ce cas, vous pouvez modifier le cluster par la suite pour ajouter ce paramètre. Vous pouvez également ajouter une instance de base de données de lecteur Aurora Serverless v2 au cluster. Vous spécifiez la plage de capacité dans le cadre de ce processus.

Tant que vous ne spécifiez pas la plage de capacité de votre cluster, vous ne pouvez ajouter aucune instance de base de données Aurora Serverless v2 au cluster à l’aide d’AWS CLI ou de l’API RDS. Si vous essayez d’ajouter une instance de base de données Aurora Serverless v2, vous obtenez une erreur. Dans les procédures d’AWS CLI ou de l’API RDS, la plage de capacité est représentée par l’attribut `ServerlessV2ScalingConfiguration`.

Pour les clusters contenant plusieurs instances de base de données de lecteur, la priorité de basculement de chaque instance de base de données de lecteur Aurora Serverless v2 joue un rôle important dans l’augmentation et la réduction d’échelle de cette instance de base de données. Vous ne pouvez pas spécifier la priorité lors de la création initiale du cluster. Gardez cette propriété à l’esprit lorsque vous ajoutez une seconde instance de base de données de lecteur à votre cluster. Pour plus d’informations, consultez [Choix du niveau de promotion pour un lecteur Aurora Serverless v2](aurora-serverless-v2-administration.md#aurora-serverless-v2-choosing-promotion-tier).

## Création d’un cluster de bases de données Aurora Serverless v2
<a name="aurora-serverless-v2.create-cluster"></a>

Vous pouvez utiliser la AWS Management Console, l’AWS CLI ou l’API RDS pour créer un cluster de bases de données Aurora Serverless v2.

### Console
<a name="aurora-serverless-v2-create.console"></a>

**Pour créer un cluster avec un enregistreur Aurora Serverless v2**

1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l’adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans la panneau de navigation, choisissez **Bases de données**.

1. Choisissez **Create database (Créer une base de données)**. Sur la page qui s’affiche, choisissez les options suivantes :
   + Pour **Type de moteur**, choisissez **Aurora (compatible MySQL)** ou **Aurora (compatible PostgreSQL)**.
   + Dans **Version**, choisissez l’une des versions prises en charge pour [Régions et moteurs de base de données Aurora pris en charge pour Aurora Serverless v2](Concepts.Aurora_Fea_Regions_DB-eng.Feature.ServerlessV2.md).

1. Pour **Classe d’instance de base de données**, choisissez **Sans serveur v2**.

1. Pour **Paramètres de capacité**, vous pouvez accepter la plage par défaut. Vous pouvez également choisir d’autres valeurs pour les unités de capacité minimales ou maximales. Vous pouvez choisir entre 0 ACU minimum et 256 ACU maximum, par incréments de 0,5 ACU.

   Pour plus d’informations sur les unités de capacité Aurora Serverless v2, consultez [Capacité Aurora Serverless v2](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity) et [Performances et mise à l’échelle pour Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md). 

    Selon le moteur et la version que vous choisissez, la limite supérieure peut être de 128 ACU, la limite inférieure de 0,5 ACU, ou les deux. Pour plus de détails sur la limite pour chaque combinaison de moteur et de version Aurora, consultez [Capacité Aurora Serverless v2](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity).   
![\[Paramètres de configuration d’instance pour Aurora Serverless v2.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/serverless_v2_screencaps/serverless_v2_capacity_setting_incl_nonzero_minimum.png)

    Le choix d’une capacité minimale de 0 ACU active la fonctionnalité Aurora Serverless v2 de pause et de reprise automatiques. Dans ce cas, vous pouvez également choisir la durée d’attente des instances de base de données Aurora Serverless v2 sans connexion à la base de données avant de se mettre en pause automatiquement. Pour plus d’informations sur la fonctionnalité de pause et de reprise automatiques, consultez [Réduction verticale à zéro ACU avec pause et reprise automatiques pour Aurora Serverless v2](aurora-serverless-v2-auto-pause.md).   
![\[Définition du paramètre Aurora Serverless v2 lorsque la limite inférieure est de 0 ACU.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/serverless_v2_screencaps/serverless_v2_capacity_setting_incl_zero_minimum.png)

1. Choisissez n’importe quel autre paramètre de cluster de bases de données, comme décrit dans [Paramètres pour les clusters de bases de données Aurora](Aurora.CreateInstance.md#Aurora.CreateInstance.Settings).

1. Choisissez **Créer une base de données** pour créer votre cluster de bases de données Aurora avec une instance de base de données Aurora Serverless v2 en tant qu’instance d’enregistreur, également connue sous le nom d’instance de base de données principale.

### Interface de ligne de commande (CLI)
<a name="aurora-serverless-v2-create.cli"></a>

Pour créer un cluster de bases de données compatible avec les instances de base de données Aurora Serverless v2 à l’aide d’AWS CLI, suivez la procédure de la rubrique [Création d’un cluster de bases de données Amazon Aurora](Aurora.CreateInstance.md) pour l’interface de ligne de commande. Incluez les paramètres suivants dans votre commande `create-db-cluster` :
+ --region *région\$1AWS\$1où\$1instances\$1Aurora Serverless v2\$1sont\$1disponibles*
+ --engine-version *version\$1moteur\$1compatible\$1serverless\$1v2*
+ --serverless-v2-scaling-configuration MinCapacity=*capacité\$1minimale*,MaxCapacity=*capacité\$1maximale* 

L’exemple suivant illustre la création d’un cluster de bases de données Aurora Serverless v2.

```
aws rds create-db-cluster \
    --db-cluster-identifier my-serverless-v2-cluster \
    --region eu-central-1 \
    --engine aurora-mysql \
    --engine-version 8.0.mysql_aurora.3.04.1 \
    --serverless-v2-scaling-configuration MinCapacity=1,MaxCapacity=4 \
    --master-username myuser \
    --manage-master-user-password
```

**Note**  
Lorsque vous créez un cluster de bases de données Aurora Serverless v2 à l’aide de AWS CLI, le mode moteur apparaît dans la sortie sous la forme de `provisioned` plutôt que de `serverless`. Le mode moteur `serverless` fait référence à Aurora Serverless v1.

Cet exemple spécifie l’option `--manage-master-user-password` permettant de générer le mot de passe administratif et de le gérer dans Secrets Manager. Pour plus d’informations, consultez [Gestion des mots de passe avec Amazon Aurora et AWS Secrets Manager](rds-secrets-manager.md). Vous pouvez également utiliser l’option `--master-password` pour spécifier et gérer vous-même le mot de passe.

Pour plus d’informations sur la version requise pour Aurora Serverless v2, consultez [Exigences et limites relatives à Aurora Serverless v2](aurora-serverless-v2.requirements.md). Pour plus d’informations sur les nombres autorisés pour la plage de capacité et ce que représentent ces nombres, consultez [Capacité Aurora Serverless v2](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity) et [Performances et mise à l’échelle pour Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md). 

Pour vérifier si un cluster existant possède les paramètres de capacité spécifiés, vérifiez la sortie de la commande `describe-db-clusters` pour l’attribut `ServerlessV2ScalingConfiguration`. Cet attribut ressemble à ce qui suit.

```
"ServerlessV2ScalingConfiguration": {
    "MinCapacity": 1.5,
    "MaxCapacity": 24.0
}
```

**Astuce**  
Si vous ne spécifiez pas les nombres minimal et maximal d’ACU lors de la création du cluster, vous pouvez utiliser la commande `modify-db-cluster` pour ajouter ce paramètre par la suite. Tant que vous ne le faites pas, vous ne pouvez ajouter aucune instance de base de données Aurora Serverless v2 au cluster. Si vous essayez d’ajouter une instance de base de données `db.serverless`, vous obtenez une erreur.

### « Hello, World\$1 »
<a name="aurora-serverless-v2-create.api"></a>

Pour créer un cluster de bases de données compatible avec les instances de base de données Aurora Serverless v2 à l’aide de l’API RDS, suivez la procédure de la rubrique [Création d’un cluster de bases de données Amazon Aurora](Aurora.CreateInstance.md) pour l’API. Sélectionnez les paramètres suivants. Vérifiez que votre opération `CreateDBCluster` inclut les paramètres suivants :

```
EngineVersion serverless_v2_compatible_engine_version
ServerlessV2ScalingConfiguration with MinCapacity=minimum_capacity and MaxCapacity=maximum_capacity
```

Pour plus d’informations sur la version requise pour Aurora Serverless v2, consultez [Exigences et limites relatives à Aurora Serverless v2](aurora-serverless-v2.requirements.md). Pour plus d’informations sur les nombres autorisés pour la plage de capacité et ce que représentent ces nombres, consultez [Capacité Aurora Serverless v2](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity) et [Performances et mise à l’échelle pour Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md). 

Pour vérifier si un cluster existant possède les paramètres de capacité spécifiés, vérifiez la sortie de l’opération `DescribeDBClusters` pour l’attribut `ServerlessV2ScalingConfiguration`. Cet attribut ressemble à ce qui suit.

```
"ServerlessV2ScalingConfiguration": {
    "MinCapacity": 1.5,
    "MaxCapacity": 24.0
}
```

**Astuce**  
Si vous ne spécifiez pas les nombres minimal et maximal d’ACU lors de la création du cluster, vous pouvez utiliser l’opération `ModifyDBCluster` pour ajouter ce paramètre par la suite. Tant que vous ne le faites pas, vous ne pouvez ajouter aucune instance de base de données Aurora Serverless v2 au cluster. Si vous essayez d’ajouter une instance de base de données `db.serverless`, vous obtenez une erreur.

## Création d’une instance de base de données d’enregistreur Aurora Serverless v2
<a name="aurora-serverless-v2-adding-writer"></a>

 Bien que vous spécifiiez la plage de capacité Aurora Serverless v2 lorsque vous créez un cluster Aurora, vous pouvez choisir d’utiliser Aurora Serverless v2 ou provisionné pour chaque instance de base de données du cluster. Pour commencer à utiliser Aurora Serverless v2 immédiatement dans votre cluster de bases de données, ajoutez une instance de base de données d’enregistreur qui utilise la classe d’instance `db.serverless`. Dans la console, vous faites généralement ce choix dans le cadre du processus de création du cluster de bases de données. Par conséquent, cette procédure s’applique principalement lorsque vous effectuez la configuration via l’interface de ligne de commande. 

### Console
<a name="aurora-serverless-v2-adding-writer.CON"></a>

Lorsque vous créez un cluster de bases de données à l’aide de la AWS Management Console, vous spécifiez également les propriétés de l’instance de base de données d’enregistreur. Pour faire en sorte que l’instance de base de données d’enregistreur utilise Aurora Serverless v2, choisissez la classe d’instance de base de données **Sans serveur**.

Vous définissez ensuite la plage de capacité du cluster en spécifiant les valeurs minimale et maximale d’unité de capacité Aurora (ACU). Ces mêmes valeurs minimale et maximale s’appliquent à chaque instance de base de données Aurora Serverless v2 du cluster. Pour en savoir plus sur cette procédure et sur l’importance des valeurs de capacité minimale et maximale, consultez [Création d’un cluster de bases de données Aurora Serverless v2](#aurora-serverless-v2.create-cluster). 

Si vous ne créez pas d’instance de base de données Aurora Serverless v2 lorsque vous créez le cluster pour la première fois, vous pouvez ajouter une ou plusieurs instances de base de données Aurora Serverless v2 ultérieurement. Pour ce faire, suivez les procédures des rubriques [Ajout d’un lecteur Aurora Serverless v2](aurora-serverless-v2-administration.md#aurora-serverless-v2-adding-reader) et [Conversion d’un lecteur ou d’un enregistreur approvisionné en Aurora Serverless v2](aurora-serverless-v2-administration.md#aurora-serverless-v2-converting-from-provisioned). Vous spécifiez la plage de capacité au moment où vous ajoutez la première instance de base de données Aurora Serverless v2 au cluster. Vous pouvez modifier la plage de capacité ultérieurement en suivant la procédure de la rubrique [Définition de la plage de capacité Aurora Serverless v2 d’un cluster](aurora-serverless-v2-administration.md#aurora-serverless-v2-setting-acus).

### Interface de ligne de commande (CLI)
<a name="aurora-serverless-v2-adding-writer.CLI"></a>

Lorsque vous créez un cluster de bases de données Aurora Serverless v2 à l’aide d’AWS CLI, vous ajoutez explicitement l’instance de base de données d’enregistreur à l’aide de la commande [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html). Incluez le paramètre suivant :
+ `--db-instance-class db.serverless`

L’exemple suivant illustre la création d’une instance de base de données d’enregistreur Aurora Serverless v2.

```
aws rds create-db-instance \
    --db-cluster-identifier my-serverless-v2-cluster \
    --db-instance-identifier my-serverless-v2-instance \
    --db-instance-class db.serverless \
    --engine aurora-mysql
```