Ändern der Amazon DocumentDB-Cluster-Parametergruppen

In diesem Abschnitt wird erklärt, wie Sie eine ändern kundenspezifisch Amazon DocumentDB-Parametergruppe. In Amazon DocumentDB können Sie eine nicht ändern default Cluster-Parametergruppe, 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 erstellen Sie eine neue Parametergruppe oder kopiere eine bestehende Parametergruppe, ändern Sie sie und wenden Sie dann die geänderte Parametergruppe auf Ihren Cluster an.

Führen Sie die folgenden Schritte aus, um eine benutzerdefinierte Cluster-Parametergruppe zu ändern. Es kann eine Weile dauern, bis Änderungsaktionen übernommen werden. Warten Sie, bis die geänderte Cluster-Parametergruppe verfügbar ist, bevor Sie sie an Ihren Cluster anhängen. Sie können das verwenden AWS-Managementkonsole oder die AWS CLI describe-db-cluster-parameters Vorgang, um zu überprüfen, ob Ihre Cluster-Parametergruppe geändert wurde. Weitere Informationen finden Sie unter Beschreibung der Cluster-Parametergruppen.

Using the AWS-Managementkonsole

Folgen Sie diesen Schritten, um eine benutzerdefinierte Amazon 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-Managementkonsole, und öffnen Sie die Amazon 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 vergewissern Sie sich, dass er geändert werden kann, indem Sie überprüfen, ob er aufgeführt ist als true unter dem Modifizierbar Spalte.

   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 das ändern ParameterValue, Description, oder ApplyMethod eines beliebigen modifizierbaren Parameters in einer benutzerdefinierten Amazon DocumentDB-Cluster-Parametergruppe mithilfe der 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 im Referenz zu den Amazon DocumentDB-Cluster-Parametern. Jeder Parametereintrag muss Folgendes enthalten:

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

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

  • ApplyMethod — Wie Sie Änderungen an diesem Parameter anwenden möchten. 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"
              }
          ]
   }