Erstellen von Amazon DocumentDB-Cluster-Parametergruppen

Standard-Cluster-Parametergruppen wie default.docdb5.0, default.docdb4.0, oder default.docdb3.6, werden erstellt, wenn Sie einen Cluster mit einer neuen Engine-Version und in einer neuen erstellen AWS-Region. Nachfolgende Cluster, die in derselben Region und mit derselben Engine-Version erstellt wurden, erben default Cluster-Parametergruppe. Nach der Erstellung wird der default Parametergruppen können nicht gelöscht oder umbenannt werden. Sie können das Engine-Verhalten von Cluster-Instances ändern, indem Sie eine benutzerdefinierte Parametergruppe mit bevorzugten Parameterwerten erstellen und sie an Ihren Amazon DocumentDB-Cluster anhängen.

Das folgende Verfahren führt Sie durch die Erstellung einer benutzerdefinierten Cluster-Parametergruppe. Anschließend können Sie die Parameter innerhalb dieser Parametergruppe ändern.

Anmerkung

Sie sollten nach der Erstellung einer Cluster-Parametergruppe mindestens 5 Minuten warten, bevor Sie diese Cluster-Parametergruppe verwenden. Auf diese Weise kann Amazon DocumentDB das vollständig abschließen create Aktion, bevor die Cluster-Parametergruppe für einen neuen Cluster verwendet wird. Sie können das verwenden AWS-Managementkonsole oder die describe-db-cluster-parameter-groups AWS CLI Vorgang, um zu überprüfen, ob Ihre Cluster-Parametergruppe erstellt wurde. Weitere Informationen finden Sie unter Beschreibung der Amazon DocumentDB-Cluster-Parametergruppen.

Using the AWS-Managementkonsole

So erstellen Sie eine Cluster-Parametergruppe

1. Melden Sie sich bei der AWS-Managementkonsole, und öffnen Sie die Amazon DocumentDB-Konsole unter https://console.aws.amazon.com/docdb.

2. Wählen Sie im Navigationsbereich Parameter groups (Parametergruppen) aus.

   Tipp

   Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol () aus.

3. Wählen Sie im Bereich Cluster parameter groups (Cluster-Parametergruppen) die Option Create (Erstellen) aus.

4. Geben Sie im Bereich Create cluster parameter group (Cluster-Parametergruppe erstellen) Folgendes ein:

   1. Neuer Gruppenname für Cluster-Parameter — Geben Sie einen Namen für die Cluster-Parametergruppe ein. Beispiel, sample-parameter-group. Für Cluster-Parametergruppen gelten die folgenden Benennungseinschränkungen:

      • Die Länge muss [1 bis 255] alphanumerische Zeichen betragen.

      • Muss mit einem Buchstaben beginnen.

      • Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.

   2. Familie — Wählen Sie eine DocumentDB-Version, die Sie für Ihren Cluster verwenden möchten.

   3. Beschreibung — Geben Sie eine Beschreibung für diese Cluster-Parametergruppe ein.

5. Um die Cluster-Parametergruppe zu erstellen, wählen Sie Erstellen aus. Um die Operation abzubrechen, wählen Sie Abbrechen aus.

6. Nach der Auswahl von Create (Erstellen) wird oben auf der Seite der folgende Text angezeigt, um zu bestätigen, dass die Cluster-Parametergruppe erfolgreich erstellt wurde:

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

Using the AWS CLI

Um eine neue Cluster-Parametergruppe für Amazon DocumentDB 4.0-Cluster zu erstellen, verwenden Sie den AWS CLI create-db-cluster-parameter-group Betrieb mit den folgenden Parametern:

• --db-cluster-parameter-group-name — Der Name der benutzerdefinierten Cluster-Parametergruppe. Beispiel, sample-parameter-group.

• --db-cluster-parameter-group-family — Die Cluster-Parametergruppenfamilie, die als Vorlage für die benutzerdefinierte Cluster-Parametergruppe verwendet wird.

• --description — Die vom Benutzer bereitgestellte Beschreibung für diese Cluster-Parametergruppe. Im folgenden Beispiel wird“ verwendetCustom docdb4.0 parameter group“.

Für Linux, macOS oder Unix:

Beispiel

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"

Für 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"

Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).

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