Amazon DocumentDB-Cluster-Parameter ändern

In Amazon DocumentDB bestehen Cluster-Parametergruppen aus Parametern, die für alle Instances gelten, die Sie im Cluster erstellen. Im Fall benutzerdefinierter Cluster-Parametergruppen können Sie für alle von Ihnen erstellten Parametergruppen die Parameterwerte jederzeit ändern oder alle Parameterwerte jederzeit auf die Standardwerte für Parametergruppen zurücksetzen. In diesem Abschnitt wird beschrieben, wie Sie die Parameter, aus denen eine Amazon DocumentDB-Cluster-Parametergruppe besteht, und ihre Werte anzeigen und wie Sie diese Werte ändern oder aktualisieren können.

Parameter können dynamisch oder statisch sein. Wenn Sie einen dynamischen Parameter ändern und die Cluster-Parametergruppe speichern, wird die Änderung sofort übernommen, ungeachtet der Einstellung für Apply Immediately. Wenn Sie einen statischen Parameter ändern und die Cluster-Parametergruppe speichern, wird die Änderung des Parameters erst nach einem manuellen Neustart der Instances angewendet.

Parameter einer Amazon DocumentDB-Cluster-Parametergruppe anzeigen

Sie können die Parameter eines Amazon DocumentDB-Clusters und ihre Werte mit dem AWS Management Console oder AWS CLI sehen.

Using the AWS Management Console

So zeigen Sie die Details einer Cluster-Parametergruppe an

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 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 Parameter groups (Parametergruppen) den Namen der Cluster-Parametergruppe aus, für die Sie die Details anzeigen möchten.

4. Auf der anschließend angezeigten Seite werden Ihnen für die einzelnen Parameter die folgenden Werte angezeigt: Name, aktueller Wert, zulässige Werte, ob der Parameter geändert werden kann, Anwendungstyp, Datentyp und Beschreibung.

   

Using the AWS CLI

Um die Parameter einer Cluster-Parametergruppe und deren Werte anzuzeigen, verwenden Sie die describe-db-cluster-parameters-Operation mit den folgenden Parametern.

• --db-cluster-parameter-group-name – Erforderlich. Der Name der Cluster-Parametergruppe, für die Sie eine detaillierte Parameterliste möchten.

• --source— Fakultativ. Wenn angegeben, werden nur Parameter für eine bestimmte Quelle zurückgegeben. Parameterquellen können engine-default, system oder user sein.

Der folgende Code listet die Parameter und deren Werte für die Parametergruppe custom3-6-param-grp auf. Um weitere Informationen zur Parametergruppe zu erhalten, lassen Sie die Zeile --query aus. Um Informationen zu allen Parametergruppen zu erhalten, lassen Sie die Zeile --db-cluster-parameter-group-name aus.

Für Linux, macOS oder Unix:

aws docdb describe-db-cluster-parameters \
   --db-cluster-parameter-group-name custom3-6-param-grp \
   --query 'Parameters[*].[ParameterName,ParameterValue]'

Für Windows:

aws docdb describe-db-cluster-parameters ^
   --db-cluster-parameter-group-name custom3-6-param-grp ^
   --query 'Parameters[*].[ParameterName,ParameterValue]'

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

[
    [
        "audit_logs",
        "disabled"
    ],
    [
        "tls",
        "enabled"
    ],
    [
        "ttl_monitor",
        "enabled"
    ]
]

Parameter einer Amazon DocumentDB-Cluster-Parametergruppe ändern

Sie können die Parameter einer Parametergruppe über die AWS Management Console oder die AWS CLI ändern.

Using the AWS Management Console

So aktualisieren Sie die Parameter einer 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 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 Parameter groups (Parametergruppen) die Cluster-Parametergruppe aus, deren Parameter Sie aktualisieren möchten.

4. Auf der resultierenden Seite werden die Parameter und die entsprechenden Details zu dieser Cluster-Parametergruppe angezeigt. Wählen Sie einen zu aktualisierenden Parameter aus.

5. Klicken Sie oben rechts auf der Seite auf Edit (Bearbeiten), um den Wert des Parameters zu ändern. Weitere Informationen zu den Typen von Cluster-Parametern finden Sie unter Referenz zu den Amazon DocumentDB-Clusterparametern.

6. Führen Sie die Änderung aus. Wählen Sie anschließend Modify cluster parameter (Cluster-Parameter ändern) aus, um die Änderungen zu speichern. Um die Änderungen zu verwerfen, wählen Sie Cancel (Abbrechen) aus.

Using the AWS CLI

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

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

• --parameters – Erforderlich. Der Parameter oder die Parameter, die Sie ändern. 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.

So ändern Sie die Werte der Parameter einer Cluster-Parametergruppe (AWS CLI)

Im folgenden Beispiel wird der Parameter tls geändert.

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 tls-Parameter, sodass sein 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.

   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": [
           {
               "ParameterName": "audit_logs",
               "ParameterValue": "disabled",
               "Description": "Enables auditing on cluster.",
               "Source": "system",
               "ApplyType": "dynamic",
               "DataType": "string",
               "AllowedValues": "enabled,disabled",
               "IsModifiable": true,
               "ApplyMethod": "pending-reboot"
           },
           {
               "ParameterName": "tls",
               "ParameterValue": "disabled",
               "Description": "Config to enable/disable TLS",
               "Source": "user",
               "ApplyType": "static",
               "DataType": "string",
               "AllowedValues": "disabled,enabled",
               "IsModifiable": true,
               "ApplyMethod": "pending-reboot"
           }
       ]
   }