Amazon DocumentDB-Cluster-Parametergruppen ändern

In diesem Abschnitt wird erklärt, wie Sie eine benutzerdefinierte Amazon DocumentDB DocumentDB-Parametergruppe ändern. In Amazon DocumentDB können Sie eine default Cluster-Parametergruppe nicht ändern, die erstellt wird, wenn Sie zum ersten Mal einen Cluster mit einer neuen Engine-Version in einer neuen Region erstellen. Wenn Ihr Amazon DocumentDB-Cluster die Standard-Cluster-Parametergruppe verwendet und Sie einen Wert darin ändern möchten, müssen Sie zuerst eine neue Parametergruppe erstellen oder eine bestehende Parametergruppe kopieren, sie ändern und dann die geänderte Parametergruppe auf Ihren Cluster anwenden.

Gehen Sie wie folgt vor, um eine benutzerdefinierte Cluster-Parametergruppe zu ändern. Die Übertragung von Änderungsaktionen kann eine Weile dauern. Bitte warten Sie, bis die geänderte Cluster-Parametergruppe verfügbar ist, bevor Sie sie an Ihren Cluster anhängen. Sie können die AWS Management Console oder die AWS CLI-Operation describe-db-cluster-parameters verwenden, um zu überprüfen, ob die Cluster-Parametergruppe geändert wurde. Weitere Informationen finden Sie unter Beschreibung von Cluster-Parametergruppen.

Using the AWS Management Console

Gehen Sie wie folgt vor, um eine benutzerdefinierte Amazon DocumentDB DocumentDB-Parametergruppe zu ändern. Sie können eine default-Parametergruppe nicht ändern. Wenn Sie einen Wert in der default-Parametergruppe ändern möchten, können Sie die standardmäßige Cluster-Parametergruppe kopieren, sie ändern und die geänderte Parametergruppe anschließend auf Ihren Cluster anwenden. Weitere Hinweise zum Anwenden von Parametergruppen auf Ihren Cluster finden Sie unter Ändern eines Amazon DocumentDB-Clusters.

So ändern Sie eine benutzerdefinierte Cluster-Parametergruppe

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

2. Wählen Sie im Navigationsbereich auf der linken Seite der Konsole Parameter groups (Parametergruppen) aus. Wählen Sie in der Liste der Parametergruppen den Namen der Parametergruppe, die Sie ändern möchten.

   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. Gehen Sie bei jedem Parameter in der Parametergruppe, die Sie ändern möchten, wie folgt vor:

   1. Suchen Sie den Parameter, den Sie ändern möchten, und überprüfen Sie, ob er änderbar ist, indem Sie überprüfen, ob er in der true Spalte Modifizierbar aufgeführt ist.

   2. Wenn der Parameter geändert werden kann, wählen Sie ihn aus und wählen oben rechts auf der Konsolenseite Edit (Bearbeiten) aus.

   3. Nehmen Sie im Dialogfeld Modify <parameter-name> die gewünschten Änderungen vor. Wählen Sie anschließend Modify cluster parameter (Cluster-Parameter ändern) aus. Um die Änderungen zu verwerfen, wählen Sie Cancel (Abbrechen) aus.

Using the AWS CLI

Sie können den ParameterValueDescription, oder ApplyMethod eines beliebigen modifizierbaren Parameters in einer benutzerdefinierten Amazon DocumentDB-Cluster-Parametergruppe mit dem ändern. AWS CLI Sie können eine standardmäßige Cluster-Parametergruppe nicht direkt ändern.

Um die Parameter einer benutzerdefinierten Cluster-Parametergruppe zu ändern, verwenden Sie die Operation modify-db-cluster-parameter-group mit den folgenden Parametern.

• --db-cluster-parameter-group-name – Erforderlich. Der Name der Cluster-Parametergruppe, die Sie ändern.

• --parameters – Erforderlich. Die Parameter, die von Ihnen geändert werden. Eine Liste der Parameter, die für alle Instances in einem Amazon DocumentDB-Cluster gelten, finden Sie unter. Referenz zu den Amazon DocumentDB-Clusterparametern Jeder Parametereintrag muss Folgendes enthalten:

  • ParameterName— Der Name des Parameters, den Sie ändern.

  • ParameterValue— Der neue Wert für diesen Parameter.

  • ApplyMethod— Wie die Änderungen an diesem Parameter angewendet werden sollen. Zugelassene Werte sind immediate und pending-reboot.

    Anmerkung

    Parameter mit dem ApplyType von static müssen über einen ApplyMethod von pending-reboot verfügen.

Beispiel - Ändern eines Parameterwerts

In diesem Beispiel listen Sie die Parameterwerte von sample-parameter-group auf und ändern den tls-Parameter. Anschließend listen Sie nach einer Wartezeit von 5 Minuten die Parameterwerte von sample-parameter-group erneut auf, um die geänderten Parameterwerte anzuzeigen.

1. Listen Sie die Parameter von sample-parameter-group und ihre Werte auf.

   Für Linux, macOS oder Unix:

   aws docdb describe-db-cluster-parameters \
          --db-cluster-parameter-group-name sample-parameter-group

   Für Windows:

   aws docdb describe-db-cluster-parameters ^
          --db-cluster-parameter-group-name sample-parameter-group

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

   {
          "Parameters": [
              {
                  "Source": "system",
                  "ApplyType": "static",
                  "AllowedValues": "disabled,enabled",
                  "ParameterValue": "enabled",
                  "ApplyMethod": "pending-reboot",
                  "DataType": "string",
                  "ParameterName": "tls",
                  "IsModifiable": true,
                  "Description": "Config to enable/disable TLS"
              },
              {
                  "Source": "user",
                  "ApplyType": "dynamic",
                  "AllowedValues": "disabled,enabled",
                  "ParameterValue": "enabled",
                  "ApplyMethod": "pending-reboot",
                  "DataType": "string",
                  "ParameterName": "ttl_monitor",
                  "IsModifiable": true,
                  "Description": "Enables TTL Monitoring"
              }
          ]
   }

2. Ändern Sie den Parameter tls, sodass der Wert disabled ist.

   Sie können den ApplyMethod nicht ändern, da der ApplyType static ist.

   Für Linux, macOS oder Unix:

   aws docdb modify-db-cluster-parameter-group \
          --db-cluster-parameter-group-name sample-parameter-group \
          --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot

   Für Windows:

   aws docdb modify-db-cluster-parameter-group ^
          --db-cluster-parameter-group-name sample-parameter-group ^
          --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot

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

   {
          "DBClusterParameterGroupName": "sample-parameter-group"
      }

3. Warten Sie mindestens 5 Minuten.

4. Listen Sie die Parameterwerte von sample-parameter-group auf, um zu überprüfen, ob der Parameter tls geändert wurde.

   Für Linux, macOS oder Unix:

   aws docdb describe-db-cluster-parameters \
          --db-cluster-parameter-group-name sample-parameter-group

   Für Windows:

   aws docdb describe-db-cluster-parameters ^
          --db-cluster-parameter-group-name sample-parameter-group

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

   {
          "Parameters": [
              {
                  "ParameterValue": "false",
                  "ParameterName": "enable_audit_logs",
                  "ApplyType": "dynamic",
                  "DataType": "string",
                  "Description": "Enables auditing on cluster.",
                  "AllowedValues": "true,false",
                  "Source": "system",
                  "IsModifiable": true,
                  "ApplyMethod": "pending-reboot"
              },
              {
                  "ParameterValue": "disabled",
                  "ParameterName": "tls",
                  "ApplyType": "static",
                  "DataType": "string",
                  "Description": "Config to enable/disable TLS",
                  "AllowedValues": "disabled,enabled",
                  "Source": "system",
                  "IsModifiable": true,
                  "ApplyMethod": "pending-reboot"
              }
          ]
   }