

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.

# Utilisation de groupes de partitions de base de données
<a name="limitless-shard"></a>

Les tâches suivantes permettent d’ajouter et de gérer un groupe de partitions de base de données dans Aurora PostgreSQL Limitless Database.

**Topics**
+ [

## Connexion de votre cluster de bases de données dans Aurora PostgreSQL Limitless Database
](#limitless-endpoint)
+ [

## Recherche du nombre de routeurs et de partitions dans un groupe de partitions de base de données
](#limitless-shard.number)
+ [

## Description des groupes de partitions de base de données
](#limitless-describe)
+ [

## Redémarrage d’un groupe de partitions de base de données
](#limitless-reboot)
+ [

# Modification de la capacité d’un groupe de partitions de base de données
](limitless-capacity.md)
+ [

# Fractionnement d’une partition dans un groupe de partitions de base de données
](limitless-shard-split.md)
+ [

# Ajout d’un routeur à un groupe de partitions de base de données
](limitless-add-router.md)
+ [

# Suppression d’un groupe de partitions de base de données
](limitless-shard-delete.md)
+ [

# Ajout d’un groupe de partitions de base de données à un cluster de bases de données Aurora PostgreSQL Limitless Database existant
](limitless-shard-add.md)

## Connexion de votre cluster de bases de données dans Aurora PostgreSQL Limitless Database
<a name="limitless-endpoint"></a>

Pour utiliser Aurora PostgreSQL Limitless Database, connectez-vous au point de terminaison du cluster d’écriture ou de lecture. Vous pouvez utiliser `psql` ou de tout autre utilitaire de connexion compatible avec PostgreSQL :

```
$ psql -h DB_cluster_endpoint -p port_number -U database_username -d postgres_limitless
```

L’exemple suivant illustre l’utilisation du point de terminaison du cluster de bases de données que vous avez créé dans [Interface de ligne de commande (CLI)](limitless-create-cluster.md#limitless-create-CLI).

```
$ psql -h my-limitless-cluster.cluster-ckifpdyyyxxx.us-east-1.rds.amazonaws.com -p 5432 -U postgres -d postgres_limitless
```

**Note**  
La base de données par défaut pour le groupe de partitions de base de données dans Aurora PostgreSQL Limitless Database est `postgres_limitless`.

### Utilisation de Limitless Connection Plugin
<a name="limitless-connection-plugin"></a>

Lors de la connexion à Aurora PostgreSQL Limitless Database, les clients se connectent via le point de terminaison du cluster et sont acheminés vers un routeur de transactions par Amazon Route 53. Cependant, la capacité de Route 53 à équilibrer la charge est limitée et peut entraîner des charges de travail inégales sur les routeurs de transactions. Le [Limitless Connection Plugin](https://github.com/aws/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheLimitlessConnectionPlugin.md) du [pilote JDBC AWS](https://github.com/awslabs/aws-advanced-jdbc-wrapper) résout ce problème en effectuant un équilibrage de charge côté client en tenant compte de la charge. Pour plus d’informations sur le [pilote JDBC AWS](https://github.com/awslabs/aws-advanced-jdbc-wrapper), consultez [Connexion à Aurora PostgreSQL avec le pilote Amazon Web Services (AWS) JDBC](Aurora.Connecting.md#Aurora.Connecting.JDBCDriverPostgreSQL).

## Recherche du nombre de routeurs et de partitions dans un groupe de partitions de base de données
<a name="limitless-shard.number"></a>

Vous pouvez utiliser la requête suivante pour rechercher le nombre de routeurs et de partitions :

```
SELECT * FROM rds_aurora.limitless_subclusters;

 subcluster_id | subcluster_type
---------------+-----------------
 1             | router
 2             | router
 3             | shard
 4             | shard
 5             | shard
 6             | shard
```

## Description des groupes de partitions de base de données
<a name="limitless-describe"></a>

Utilisez la commande `describe-db-shard-groups` de l’AWS CLI pour décrire vos groupes de partitions de base de données. Le paramètre suivant est facultatif :
+ `--db-shard-group-identifier` : le nom du groupe de partitions de base de données.

L’exemple suivant décrit un groupe de partitions de base de données spécifique.

```
aws rds describe-db-shard-groups --db-shard-group-identifier my-db-shard-group
```

La sortie ressemble à l’exemple suivant.

```
{
    "DBShardGroups": [
        {
            "DBShardGroupResourceId": "shardgroup-8986d309a93c4da1b1455add17abcdef",
            "DBShardGroupIdentifier": "my-shard-group",
            "DBClusterIdentifier": "my-limitless-cluster",
            "MaxACU": 1000.0,
            "ComputeRedundancy": 0,
            "Status": "available",
            "PubliclyAccessible": false,
            "Endpoint": "my-limitless-cluster.limitless-ccetp2abcdef.us-east-1.rds.amazonaws.com"
        }
    ]
}
```

## Redémarrage d’un groupe de partitions de base de données
<a name="limitless-reboot"></a>

Il peut être nécessaire de redémarrer le groupe de partitions de base de données, notamment lorsque le paramètre `max_connections` est modifié à la suite d’un changement de capacité maximale.

Vous pouvez utiliser la AWS Management Console ou l’AWS CLI pour modifier la capacité d’un groupe de partitions de base de données.

### Console
<a name="limitless-reboot.CON"></a>

Utilisez la procédure suivante.

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. Accédez à la page **Bases de données**.

1. Sélectionnez le groupe de partitions de base de données que vous souhaitez redémarrer.

1. Pour **Actions**, choisissez **Redémarrer**.

1. Choisissez **Confirmer**.

### Interface de ligne de commande (CLI)
<a name="limitless-reboot.CLI"></a>

Pour redémarrer votre groupe de partitions de base de données, utilisez la commande `reboot-db-shard-group` de l’AWS CLI avec le paramètre suivant :
+ `--db-shard-group-identifier` : le nom du groupe de partitions de base de données.

L’exemple suivant illustre le redémarrage d’un groupe de partitions de base de données.

```
aws rds reboot-db-shard-group --db-shard-group-identifier my-db-shard-group
```

# Modification de la capacité d’un groupe de partitions de base de données
<a name="limitless-capacity"></a>

Vous pouvez utiliser la AWS Management Console ou l’AWS CLI pour modifier la capacité d’un groupe de partitions de base de données.

## Console
<a name="limitless-capacity.CON"></a>

Utilisez la procédure suivante.

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. Accédez à la page **Bases de données**.

1. Sélectionnez le groupe de partitions de base de données que vous souhaitez modifier.

1. Pour **Actions**, choisissez **Modifier**.

   La page **Modifier le groupe de partitions de base de données** s’affiche.  
![\[Page Modifier le groupe de partitions de base de données.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/limitless_modify_shard_group.png)

1. Entrez une nouvelle valeur **Capacité minimale (ACU)**, par exemple **100**.

1. Entrez une nouvelle valeur **Capacité maximale (ACU)**, par exemple **1000**.

1. Choisissez **Continuer**.

   La page de confirmation s’affiche, avec un résumé de vos modifications.

1. Passez en revue vos modifications, puis choisissez **Modifier le groupe de partitions de base de données**.

## Interface de ligne de commande (CLI)
<a name="limitless-capacity.CLI"></a>

Utilisez la commande `modify-db-shard-group` de l’AWS CLI avec les paramètres suivants :
+ `--db-shard-group-identifier` : nom du groupe de partitions de base de données.
+ `--max-acu` : la nouvelle capacité maximale du groupe de partitions de base de données. Vous pouvez définir la capacité maximale du groupe de partitions de base de données entre 16 et 6 144 ACU. Pour les limites de capacité supérieures à 6 144 ACU, contactez AWS.

  Le nombre de routeurs et de partitions ne change pas.
+ `--min-acu` : la nouvelle capacité minimale de votre groupe de partitions de base de données. Il doit comporter au moins 16 ACU, qui est la valeur par défaut.

L’exemple ci-dessous montre comment modifier, via la CLI, la plage de capacité d’un groupe de partitions de base de données à 100 – 1 000 ACU.

```
aws rds modify-db-shard-group \
    --db-shard-group-identifier my-db-shard-group \
    --min-acu 100 \
    --max-acu 1000
```

# Fractionnement d’une partition dans un groupe de partitions de base de données
<a name="limitless-shard-split"></a>

Vous pouvez fractionner manuellement une partition d’un groupe de partitions de base de données en deux partitions plus petites. C’est ce qu’on appelle un fractionnement de partition *initiée par l’utilisateur*.

Aurora PostgreSQL Limitless Database peut également fractionner des partitions lorsqu’elles contiennent un volume de données très important ou lorsqu’elles sont fortement sollicitées. C’est ce qu’on appelle un fractionnement de partition *initiée par le système*.

**Topics**
+ [

## Prérequis
](#limitless-shard-split.prereqs)
+ [

## Fractionnement d’une partition
](#limitless-shard-split.proc)
+ [

## Suivi des fractionnements de partitions
](#limitless-shard-split.track)
+ [

## Finalisation des fractionnements de partitions
](#limitless-shard-split.finalize)
+ [

## Annulation d’un fractionnement de partition
](#limitless-shard-split.cancel)

## Prérequis
<a name="limitless-shard-split.prereqs"></a>

Les fractionnements de partitions initiés par l’utilisateur sont soumis aux conditions préalables suivantes :
+ Vous devez disposer d’un groupe de partitions de base de données.
+ Le groupe de partitions de base de données ne peut pas être vide : il doit contenir au moins une table partitionnée.
+ Un utilisateur doit disposer du privilège `rds_aurora_limitless_cluster_admin`. Ce privilège est détenu par le rôle `rds_superuser` ; il est donc également accordé à l’utilisateur principal. Le `rds_superuser` peut accorder le privilège à d’autres utilisateurs :

  ```
  /* Logged in as the master user or a user with rds_superuser privileges */
  CREATE USER username;
  GRANT rds_aurora_limitless_cluster_admin to username;
  ```
+ Vous devez connaître l’ID du sous-cluster (nœud) de la partition que vous souhaitez fractionner. Vous pouvez identifier les ID à l’aide de la requête suivante :

  ```
  SELECT * FROM rds_aurora.limitless_subclusters;
  
   subcluster_id | subcluster_type
  ---------------+-----------------
   1             | router
   2             | router
   3             | shard
   4             | shard
   5             | shard
   6             | shard
  ```

Pour activer les fractionnements de partitions initiés par le système, configurez les paramètres suivants du cluster de bases de données dans un groupe de paramètres personnalisé associé à votre cluster de bases de données :


| Paramètre | Valeur | 
| --- | --- | 
|  `rds_aurora.limitless_enable_auto_scale`  |  `on`  | 
|  `rds_aurora.limitless_auto_scale_options`  |  `split_shard` ou `add_router,split_shard`  | 
|  `rds_aurora.limitless_finalize_split_shard_mode`  |  Ce paramètre détermine la manière dont les fractionnements de partitions *initiées par le système* sont finalisés. La valeur peut être l’une des suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/limitless-shard-split.html) Pour plus d’informations, consultez [Finalisation des fractionnements de partitions](#limitless-shard-split.finalize).  Ce paramètre s’applique uniquement aux fractionnements de partitions initiés par le système.   | 

Pour plus d’informations, consultez [Groupes de paramètres de cluster de bases de données pour les clusters de bases de données Amazon Aurora](USER_WorkingWithDBClusterParamGroups.md).

## Fractionnement d’une partition
<a name="limitless-shard-split.proc"></a>

Pour fractionner une partition dans un groupe de partitions de base de données, utilisez la fonction `rds_aurora.limitless_split_shard`. Cette fonction lance une tâche de fractionnement de partition qui s’exécute de manière asynchrone.

```
SELECT rds_aurora.limitless_split_shard('subcluster_id');
```

Une fois la tâche soumise avec succès, attendez que l’ID de tâche soit renvoyé, par exemple :

```
SELECT rds_aurora.limitless_split_shard('3');

    job_id
---------------
 1691300000000
(1 row)
```

**Note**  
Les opérations simultanées de fractionnement de partition ne sont pas prises en charge. Effectuez chaque opération l’une après l’autre, en veillant à finaliser une opération avant d’en initier une nouvelle.

## Suivi des fractionnements de partitions
<a name="limitless-shard-split.track"></a>

Vous pouvez utiliser l’ID de tâche pour suivre une tâche de fractionnement de partition. Pour décrire une tâche particulière et obtenir plus de détails à son sujet, exécutez la requête suivante :

```
SELECT * FROM rds_aurora.limitless_list_shard_scale_jobs(job_id);
```

Exemples :

```
SELECT * FROM rds_aurora.limitless_list_shard_scale_jobs(1691300000000);

    job_id     |    action   |      job_details      | status  |    submission_time     |                  message                  
---------------+-------------+-----------------------+---------+------------------------+-------------------------------------------
 1691300000000 | SPLIT_SHARD | Split Shard 3 by User | SUCCESS | 2023-08-06 05:33:20+00 | Scaling job succeeded.                 +
               |             |                       |         |                        | New shard instance with ID 7 was created.
(1 row)
```

La requête génère une erreur si la tâche spécifiée en entrée n’existe pas.

```
SELECT * from rds_aurora.limitless_list_shard_scale_jobs(1691300000001);

ERROR:  no job found with the job ID provided
```

Vous pouvez suivre l’état de toutes les tâches de fractionnement de partition en utilisant la même requête sans ID de tâche, par exemple :

```
SELECT * FROM rds_aurora.limitless_list_shard_scale_jobs();

    job_id     |   action    |  job_details          |   status    |    submission_time     |                  message                 
---------------+-------------+-----------------------+-------------+------------------------+--------------------------------------------------------------
 1691200000000 | SPLIT_SHARD | Split Shard 3 by User | IN_PROGRESS | 2023-08-05 01:46:40+00 | 
 1691300000000 | SPLIT_SHARD | Split Shard 4 by User | SUCCESS     | 2023-08-06 05:33:20+00 | Scaling job succeeded. +
               |             |                       |             |                        | New shard instance with ID 7 was created.
 1691400000000 | SPLIT_SHARD | Split Shard 5 by User | FAILED      | 2023-08-07 09:20:00+00 | Error occurred for the add shard job 1691400000000.
               |             |                       |             |                        | Retry the command. If the issue persists, contact AWS Support.
 1691500000000 | SPLIT_SHARD | Split Shard 5 by User | CANCELED    | 2023-08-07 09:20:00+00 | Scaling job was cancelled.
(4 rows)
```

La tâche peut présenter l’un des états suivants :
+ `IN_PROGRESS` : la tâche de fractionnement de partition a été soumise et est en cours. Une seule tâche peut être en cours d’exécution à la fois.
+ `PENDING` : la tâche de fractionnement de partition attend que vous la finalisiez. Pour plus d’informations, consultez [Finalisation des fractionnements de partitions](#limitless-shard-split.finalize).
+ `CANCELLATION_IN_PROGRESS` : la tâche de fractionnement de partition est annulée par l’utilisateur.
+ `CANCELED` : la tâche de fractionnement de partition a été annulée par l’utilisateur ou le système.
+ `SUCCESS` : la tâche de fractionnement de partition s’est terminée avec succès. Le champ `message` contient l’ID d’instance de la nouvelle partition.
+ `FAILED` : la tâche de fractionnement de partition a échoué. Le champ `message` contient les détails de l’échec et toutes les actions qui peuvent être prises en conséquence.

## Finalisation des fractionnements de partitions
<a name="limitless-shard-split.finalize"></a>

La finalisation est la dernière étape du processus de fractionnement de partition. Cela peut engendrer une période d’indisponibilité. Si vous démarrez une tâche de fractionnement de partition, la finalisation est effectuée immédiatement une fois la tâche terminée.

Parfois, le système fractionne les partitions en fonction de la charge de travail, lorsque vous avez activé les fractionnements de partitions initiés par le système à l’aide du paramètre `rds_aurora.limitless_enable_auto_scale`.

Dans ce cas, vous pouvez décider si la finalisation doit avoir lieu immédiatement ou au moment de votre choix. Le paramètre `rds_aurora.limitless_finalize_split_shard_mode` de cluster de bases de données vous permet de définir quand cette opération a lieu :
+ Si vous définissez la valeur sur `immediate`, la finalisation se produit immédiatement.
+ Si vous définissez la valeur sur `user_initiated`, vous devez finaliser la tâche de fractionnement de partition manuellement.

  Un événement RDS vous est envoyé et l’état de la tâche de fractionnement de partition est défini sur `PENDING`.

Lorsque ce paramètre est défini sur `user_initiated`, vous utilisez la fonction `rds_aurora.limitless_finalize_split_shard` pour finaliser la tâche de fractionnement de partition :

```
SELECT * FROM rds_aurora.limitless_finalize_split_shard(job_id);
```

**Note**  
Cette fonction s’applique uniquement aux fractionnements de partitions initiés par le système, et non par vous.

## Annulation d’un fractionnement de partition
<a name="limitless-shard-split.cancel"></a>

Les fractionnements de partitions initiés par l’utilisateur ou par le système `IN_PROGRESS` ou `PENDING` peuvent être annulés. Vous avez besoin de l’ID de la tâche pour pouvoir l’annuler.

```
SELECT * from rds_aurora.limitless_cancel_shard_scale_jobs(job_id);
```

Aucune sortie n’est renvoyée sauf en cas d’erreur. Vous pouvez suivre l’annulation à l’aide d’une requête de suivi des tâches.

# Ajout d’un routeur à un groupe de partitions de base de données
<a name="limitless-add-router"></a>

Vous pouvez ajouter un routeur à un groupe de partitions de base de données.

**Topics**
+ [

## Prérequis
](#limitless-add-router.prereqs)
+ [

## Ajout d’un routeur
](#limitless-add-router.proc)
+ [

## Suivi des ajouts de routeurs
](#limitless-add-router.track)
+ [

## Annulation de l’ajout d’un routeur
](#limitless-add-router.cancel)

## Prérequis
<a name="limitless-add-router.prereqs"></a>

Les conditions préalables suivantes doivent être remplies avant d’ajouter un routeur :
+ Vous devez disposer d’un groupe de partitions de base de données.
+ Un utilisateur doit disposer du privilège `rds_aurora_limitless_cluster_admin`. Ce privilège est détenu par le rôle `rds_superuser` ; il est donc également accordé à l’utilisateur principal. Le `rds_superuser` peut accorder le privilège à d’autres utilisateurs :

  ```
  /* Logged in as the master user or a user with rds_superuser privileges */
  CREATE USER username;
  GRANT rds_aurora_limitless_cluster_admin to username;
  ```
**Note**  
Si vous modifiez le certificat CA par défaut de votre Compte AWS après la création du groupe de partitions de base de données, le nouveau routeur utilisera le nouveau certificat CA, qui est différent du certificat CA du routeur existant. Il se peut que certaines connexions échouent, selon la configuration de votre magasin d’approbations.
+ Pour activer l’ajout de routeur initié par le système, configurez les paramètres suivants du cluster de bases de données dans un groupe de paramètres personnalisé associé à votre cluster de bases de données :    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/limitless-add-router.html)

  Pour plus d’informations, consultez [Groupes de paramètres de cluster de bases de données pour les clusters de bases de données Amazon Aurora](USER_WorkingWithDBClusterParamGroups.md).

## Ajout d’un routeur
<a name="limitless-add-router.proc"></a>

Pour ajouter un routeur, utilisez la fonction `rds_aurora.limitless_add_router`. Cette fonction lance une tâche d’ajout de routeur qui s’exécute de manière asynchrone.

```
SELECT rds_aurora.limitless_add_router();
```

Une fois la tâche soumise avec succès, attendez que l’ID de tâche soit renvoyé, par exemple :

```
    job_id
---------------
 1691300000000
(1 row)
```

**Note**  
Les opérations simultanées d’ajout de routeur ne sont pas prises en charge. Procédez aux opérations d’ajout une par une et attendez la fin de chacune avant de lancer la suivante.

## Suivi des ajouts de routeurs
<a name="limitless-add-router.track"></a>

Vous pouvez utiliser l’ID de tâche pour suivre une tâche d’ajout de routeur. Pour décrire une tâche particulière et obtenir plus de détails à son sujet, exécutez la requête suivante :

```
SELECT * FROM rds_aurora.limitless_list_router_scale_jobs(job_id);
```

Exemples :

```
SELECT * FROM rds_aurora.limitless_list_router_scale_jobs(1691300000000);

    job_id     |   action   |        job_details       | status  |    submission_time     |                   message                   
---------------+------------+--------------------------+---------+------------------------+-------------------------------------------
 1691300000000 | ADD_ROUTER | Add 1 new Router by User | SUCCESS | 2023-08-06 05:33:20+00 | Scaling job succeeded.                  +
               |            |                          |         |                        | New router instance with ID 7 was created.
(1 row)
```

La requête génère une erreur si la tâche spécifiée en entrée n’existe pas.

```
SELECT * from rds_aurora.limitless_list_router_scale_jobs(1691300000001);

ERROR:  no job found with the job ID provided
```

Vous pouvez suivre l’état de toutes les tâches d’ajout de routeurs en utilisant la même requête sans ID de tâche, par exemple :

```
SELECT * FROM rds_aurora.limitless_list_router_scale_jobs();

    job_id     |   action   |        job_details       |   status    |    submission_time     |                  message                   
---------------+------------+--------------------------+-------------+------------------------+-------------------------------------------
 1691200000000 | ADD_ROUTER | Add 1 new Router by User | IN_PROGRESS | 2023-08-05 01:46:40+00 | 
 1691300000000 | ADD_ROUTER | Add 1 new Router by User | SUCCESS     | 2023-08-06 05:33:20+00 | Scaling job succeeded.                +
               |            |                          |             |                        | New router instance with ID 7 was created.
 1691400000000 | ADD_ROUTER | Add 1 new Router by User | FAILED      | 2023-08-07 09:20:00+00 | Error occurred for the add router job 1691400000000.
               |            |                          |             |                        | Retry the command. If the issue persists, contact AWS Support.
 1691500000000 | ADD_ROUTER | Add 1 new Router by User | CANCELED    | 2023-08-07 09:20:00+00 | Scaling job was cancelled.
(4 rows)
```

La tâche peut présenter l’un des états suivants :
+ `IN_PROGRESS` : la tâche d’ajout de routeur a été soumise et est en cours. Une seule tâche peut être en cours d’exécution à la fois.
+ `CANCELLATION_IN_PROGRESS` : la tâche d’ajout de routeur est annulée par l’utilisateur.
+ `CANCELED` : la tâche d’ajout de routeur a été annulée par l’utilisateur ou le système.
+ `SUCCESS` : la tâche d’ajout de routeur a bien été effectuée. Le champ `message` contient l’ID d’instance du nouveau routeur.
+ `FAILED` : la tâche d’ajout de routeur a échoué. Le champ `message` contient les détails de l’échec et toutes les actions qui peuvent être prises en conséquence.

**Note**  
Il n’y a aucun état `PENDING`, car les ajouts de routeurs n’ont pas besoin d’être finalisés. Ils n’entraînent aucune durée d’indisponibilité.

## Annulation de l’ajout d’un routeur
<a name="limitless-add-router.cancel"></a>

Vous pouvez annuler l’ajout d’un routeur présentant l’état `IN_PROGRESS`. Vous avez besoin de l’ID de la tâche pour pouvoir l’annuler.

```
SELECT * from rds_aurora.limitless_cancel_router_scale_jobs(job_id);
```

Aucune sortie n’est renvoyée sauf en cas d’erreur. Vous pouvez suivre l’annulation à l’aide d’une requête de suivi des tâches.

# Suppression d’un groupe de partitions de base de données
<a name="limitless-shard-delete"></a>

Vous pouvez supprimer un groupe de partitions de base de données si nécessaire. La suppression du groupe de partitions de base de données supprime les nœuds de calcul (partitions et routeurs), tout en conservant le stockage.

## Console
<a name="limitless-shard-delete.CON"></a>

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. Accédez à la page **Bases de données**.

1. Sélectionnez le groupe de partitions de base de données que vous souhaitez supprimer.

1. Pour **Actions**, choisissez **Supprimer**.

1. Saisissez **delete me** dans la case, puis choisissez **Supprimer**.

Le groupe de partitions de base de données est supprimé.

## AWS CLI
<a name="limitless-shard-delete.CLI"></a>

Pour supprimer votre groupe de partitions de base de données, utilisez la commande `delete-db-shard-group` de l’AWS CLI avec le paramètre suivant :
+ `--db-shard-group-identifier` : nom du groupe de partitions de base de données.

L’exemple suivant illustre la suppression d’un groupe de partitions de base de données dans le cluster de bases de données Aurora PostgreSQL créé précédemment.

```
aws rds delete-db-shard-group --db-shard-group-identifier my-db-shard-group
```

# Ajout d’un groupe de partitions de base de données à un cluster de bases de données Aurora PostgreSQL Limitless Database existant
<a name="limitless-shard-add"></a>

Vous pouvez créer un groupe de partitions de base de données dans un cluster de bases de données existant, par exemple si vous restaurez un cluster de bases de données ou si vous avez supprimé le groupe de partitions de base de données.

Pour plus d’informations sur les exigences relatives au cluster de bases de données principal et au groupe de partitions de base de données, consultez [Exigences et considérations relatives à Aurora PostgreSQL Limitless DatabaseExigences et considérations relatives à Aurora PostgreSQL Limitless Database](limitless-reqs-limits.md).

**Note**  
Un cluster ne peut contenir qu’un seul groupe de partitions de base de données.  
Le cluster de bases de données Limitless Database doit présenter l’état `available` pour que vous puissiez créer un groupe de partitions de base de données.

## Console
<a name="limitless-shard-add.CON"></a>

Vous pouvez utiliser la AWS Management Console pour ajouter un groupe de partitions de base de données à un cluster de bases de données existant.

**Pour ajouter un groupe de partitions de base de données**

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. Accédez à la page **Bases de données**.

1. Sélectionnez le cluster de bases de données Limitless Database dans lequel vous souhaitez ajouter un groupe de partitions de base de données.

1. Dans **Actions**, choisissez **Ajouter un groupe de partitions de base de données**.  
![\[Ajoutez un groupe de partitions de base de données.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/limitless_add_shard_group.png)

1. Entrez un **identifiant de groupe de partitions de base de données**.
**Important**  
Après avoir créé le groupe de partitions de base de données, vous ne pouvez pas modifier l’identifiant du cluster de bases de données ou l’identifiant du groupe de partitions de base de données.

1. Entrez la **Capacité minimale (ACU)**. Utilisez une valeur d’au moins 16 ACU.

1. Entrez la **Capacité maximale (ACU)**. Utilisez une valeur comprise entre 16 et 6 144 ACU.

   Pour plus d’informations, consultez [Corrélation de la capacité maximale du groupe de partitions de base de données avec le nombre de routeurs et de partitions créés](limitless-cluster.md#limitless-capacity-mapping).

1. Pour le **déploiement d’un groupe de partitions de base de données**, choisissez si vous souhaitez créer des instances de secours pour le groupe de partitions de base de données :
   + **Aucune redondance de calcul** : crée un groupe de partitions de base de données sans instance de secours pour chaque partition. C’est la valeur par défaut.
   + **Redondance des calculs avec une seule cible de basculement** : crée un groupe de partitions de base de données avec une instance de calcul de secours dans une zone de disponibilité (AZ) différente.
   + **Redondance de calcul avec deux cibles de basculement** : crée un groupe de partitions de base de données avec deux instances de calcul de secours situées dans deux zones de disponibilité différentes.

1. Choisissez si le groupe de partitions de base de données doit être accessible publiquement.
**Note**  
Ce paramètre ne peut plus être modifié une fois le groupe de partitions de base de données créé.

1. Choisissez **Ajouter un groupe de partitions de base de données**.

## AWS CLI
<a name="limitless-shard-add.CLI"></a>

Utilisez la commande `create-db-shard-group` de l’AWS CLI pour créer un nouveau groupe de partitions de base de données.

Les paramètres suivants sont obligatoires :
+ `--db-cluster-identifier` : le cluster de bases de données auquel appartient le groupe de partitions de base de données.
+ `--db-shard-group-identifier` : nom du groupe de partitions de base de données.

  L’identifiant du groupe de partitions de base de données respecte les contraintes suivantes :
  + Il doit être unique dans le Compte AWS et la Région AWS où vous le créez.
  + Il doit comporter entre 1 et 63 lettres, chiffres ou traits d’union.
  + Le premier caractère doit être une lettre.
  + Il ne peut pas se terminer par un trait d’union ou contenir deux traits d’union consécutifs.
**Important**  
Après avoir créé le groupe de partitions de base de données, vous ne pouvez pas modifier l’identifiant du cluster de bases de données ou l’identifiant du groupe de partitions de base de données.
+ `--max-acu` : la capacité maximale du groupe de partitions de base de données. Utilisez une valeur comprise entre 16 et 6 144 ACU.

Les paramètres suivants sont facultatifs :
+ `--compute-redundancy` : déterminer s’il faut créer des instances de secours pour le groupe de partitions de base de données. Ce paramètre peut présenter les valeurs suivantes :
  + `0` : crée un groupe de partitions de base de données sans instance de secours pour chaque partition. C’est la valeur par défaut.
  + `1` : crée un groupe de partitions de base de données avec une instance de calcul de secours dans une zone de disponibilité (AZ) différente.
  + `2` : crée un groupe de partitions de base de données avec deux instances de calcul de secours situées dans deux AZ différentes.
**Note**  
Si vous définissez la redondance de calcul sur une valeur autre que zéro, le nombre total de nœuds sera doublé ou triplé. Des frais supplémentaires vous seront alors facturés.
+ `--min-acu` : la capacité minimale de votre groupe de partitions de base de données. Il doit comporter au moins 16 ACU, qui est la valeur par défaut.
+ `--publicly-accessible|--no-publicly-accessible` : déterminer s’il faut attribuer des adresses IP accessibles au public au groupe de partitions de base de données. L’accès au groupe de partitions de base de données est contrôlé par les groupes de sécurité utilisés par le cluster.

  La valeur par défaut est `--no-publicly-accessible`.
**Note**  
Ce paramètre ne peut plus être modifié une fois le groupe de partitions de base de données créé.

L’exemple suivant illustre la création d’un groupe de partitions de base de données dans un cluster de bases de données Aurora.

```
aws rds create-db-shard-group \
    --db-cluster-identifier my-db-cluster \
    --db-shard-group-identifier my-new-shard-group \
    --max-acu 1000
```

La sortie ressemble à l’exemple suivant.

```
{
    "Status": "CREATING",
    "Endpoint": "my-db-cluster.limitless-ckifpdyyyxxx.us-east-1.rds.amazonaws.com",
    "PubliclyAccessible": false, 
    "DBClusterIdentifier": "my-db-cluster",
    "MaxACU": 1000.0,
    "DBShardGroupIdentifier": "my-new-shard-group",
    "DBShardGroupResourceId": "shardgroup-8986d309a93c4da1b1455add17abcdef",
    "ComputeRedundancy": 0
}
```