Création de groupes de paramètres de cluster Amazon DocumentDB

Les groupes de paramètres de cluster par défaut tels que default.docdb5.0 default.docdb4.0default.docdb3.6, ou sont créés lorsque vous créez un cluster avec une nouvelle version du moteur et dans une nouvelle région. Les clusters suivants créés dans cette région et dotés de la même version de moteur héritent du groupe de paramètres de default cluster. Une fois créés, les groupes de default paramètres ne peuvent pas être supprimés ou renommés. Vous pouvez modifier le comportement du moteur des instances de cluster en créant un groupe de paramètres personnalisé avec des valeurs de paramètres préférées et en l'attachant à votre cluster Amazon DocumentDB.

La procédure suivante vous guide tout au long de la création d'un groupe de paramètres de cluster personnalisé. Vous pouvez ensuite modifier les paramètres de ce groupe de paramètres.

Note

Après la création d'un groupe de paramètres de cluster, patientez au moins 5 minutes avant d'utiliser ce groupe de paramètres de cluster. Cela permet à Amazon DocumentDB de terminer complètement l'createaction avant que le groupe de paramètres du cluster ne soit utilisé pour un nouveau cluster. Vous pouvez utiliser l'describe-db-cluster-parameter-groups AWS CLI opération AWS Management Console ou pour vérifier que votre groupe de paramètres de cluster a été créé. Pour de plus amples informations, veuillez consulter Décrire les groupes de paramètres du cluster Amazon DocumentDB.

Using the AWS Management Console

Créer un groupe de paramètres de cluster

1. Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.

2. Dans le panneau de navigation, choisissez Groupes de paramètres.

   Astuce

   Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu () dans le coin supérieur gauche de la page.

3. Dans le panneau Groupes de paramètres de cluster, choisissez Créer.

4. Dans le panneau Create cluster parameter group (Créer un groupe de paramètres de cluster) entrez les éléments suivants :

   1. Nom du groupe — Entrez le nom du groupe de paramètres du cluster. Par exemple, sample-parameter-group. Les groupes de paramètres de cluster sont soumis aux contraintes de dénomination suivantes :

      • Entre 1 et 255 caractères alphanumériques.

      • Le premier caractère doit être une lettre.

      • Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs.

   2. Description — Fournissez une description de ce groupe de paramètres de cluster.

5. Choisissez Créer pour créer le groupe de paramètres de cluster. Pour annuler l'opération, choisissez Annuler.

6. Une fois que vous avez sélectionné Créer, le texte suivant s'affiche en haut de la page pour confirmer que votre groupe de paramètres de cluster a été créé avec succès :

   Successfully created cluster parameter group 'sample-parameter-group'.

Using the AWS CLI

Pour créer un nouveau groupe de paramètres de cluster pour les clusters Amazon DocumentDB 4.0, utilisez l' AWS CLI create-db-cluster-parameter-groupopération avec les paramètres suivants :

• --db-cluster-parameter-group-name— Nom du groupe de paramètres de cluster personnalisé. Par exemple, sample-parameter-group.

• --db-cluster-parameter-group-family— La famille de groupes de paramètres de cluster utilisée comme modèle pour le groupe de paramètres de cluster personnalisé. Actuellement, il doit s'agir de docdb4.0.

• --description— Description fournie par l'utilisateur pour ce groupe de paramètres de cluster. L'exemple suivant utilise Custom docdb4.0 parameter group.

Pour Linux, macOS ou Unix :

aws docdb create-db-cluster-parameter-group \
 --db-cluster-parameter-group-name sample-parameter-group \
 --db-parameter-group-family docdb4.0 \
 --description "Custom docdb4.0 parameter group"

Pour Windows :

aws docdb create-db-cluster-parameter-group ^
 --db-cluster-parameter-group-name sample-parameter-group ^
 --db-parameter-group-family docdb4.0 ^
 --description "Custom docdb4.0 parameter group"

Le résultat de cette opération ressemble à ce qui suit (JSONformat).

{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "sample-parameter-group",
        "DBParameterGroupFamily": "docdb4.0",
        "Description": "Custom docdb4.0 parameter group",
        "DBClusterParameterGroupArn": "sample-parameter-group-arn"
    }
}