View a markdown version of this page

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

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 de groupes de paramètres de cluster Amazon DocumentDB

Groupes de paramètres de cluster par défaut tels que default.docdb5.0, default.docdb4.0, ou default.docdb3.6, sont créés lorsque vous créez un cluster avec une nouvelle version du moteur et dans un nouveau Région AWS. Les clusters suivants créés dans la même région et avec la même version de moteur héritent du default groupe de paramètres de cluster. Une fois créé, le default les groupes de 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'associant à votre cluster Amazon DocumentDB.

La procédure suivante vous explique comment créer 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 compléter entièrement le create action avant que le groupe de paramètres du cluster ne soit utilisé pour un nouveau cluster. Vous pouvez utiliser le Console de gestion AWS ou le describe-db-cluster-parameter-groups AWS CLI opération pour vérifier que votre groupe de paramètres de cluster a été créé. Pour plus d’informations, consultez Décrire les groupes de paramètres de cluster Amazon DocumentDB.

Using the Console de gestion AWS
Créer un groupe de paramètres de cluster
  1. Connectez-vous au Console de gestion AWS, et ouvrez la console Amazon DocumentDB à l'adresse https://console.aws.amazon.com/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 (Menu button.) 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. Nouveau nom de groupe de paramètres de cluster — Entrez un nom pour le 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. Famille — Choisissez la version de DocumentDB que vous souhaitez utiliser pour votre cluster.

    3. Descriptif — 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 le AWS CLI create-db-cluster-parameter-group fonctionnement 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é.

  • --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 :

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

Pour Windows :

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

La sortie de cette opération ressemble à ceci (format JSON).

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