Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Referenz zu den Amazon DocumentDB-Clusterparametern
<a name="cluster_parameter_groups-list_of_parameters"></a>

Wenn Sie einen dynamischen Parameter ändern und die Cluster-Parametergruppe speichern, wird diese Änderung sofort übernommen, ungeachtet der Einstellung von *Apply immediately* (Sofort anwenden). Wenn Sie einen statischen Parameter ändern und eine Cluster-Parametergruppe speichern, wird die Änderung des Parameters nach einem manuellen Neustart der Instance angewendet. Sie können eine Instance über die Amazon DocumentDB DocumentDB-Konsole oder durch expliziten Aufruf `reboot-db-instance` neu starten.

Die folgende Tabelle zeigt die Parameter, die für alle Instances in einem Amazon DocumentDB-Cluster gelten. 


**Amazon DocumentDB DocumentDB-Parameter auf Clusterebene**  

| Parameter | Standardwert | Zulässige Werte | Anpassbar | Typ anwenden | Datentyp | Description | 
| --- | --- | --- | --- | --- | --- | --- | 
| audit\$1logs | disabled | aktiviert, deaktiviert, ddl, dml\$1read, dml\$1write, all, none | Ja | Dynamisch | Zeichenfolge | Definiert, ob CloudWatch Amazon-Audit-Logs aktiviert sind. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| change\$1stream\$1log\$1retention\$1duration | 10800 | 3600-604800 | Ja | Dynamisch | Ganzzahl | Definiert den Zeitraum (in Sekunden), den das Change Stream-Protokoll aufbewahrt und genutzt werden kann.  | 
| default\$1collection\$1compression | disabled | aktiviert, deaktiviert (Amazon DocumentDB 5.0)/zstd, lz4, keine (Amazon Document .0) DB8 | Ja | Dynamisch | Zeichenfolge | Definiert die Standardkomprimierungseinstellung für neue Sammlungen in einem Cluster [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| profiler | disabled | aktiviert, deaktiviert | Ja | Dynamisch | Zeichenfolge | Aktiviert die Profilerstellung für langsame Operationen. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| profiler\$1sampling\$1rate | 1,0 | 0,0 – 1,0 | Ja | Dynamisch | Gleitkommazahl | Definiert die Sampling-Rate für protokollierte Operationen. | 
| profiler\$1threshold\$1ms | 100 | 50 – 2147483646 | Ja | Dynamisch | Ganzzahl | Definiert den Schwellenwert für profiler. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| planner\$1version | 3.0 | 1.0, 2.0, 3.0 | Ja | Dynamisch | Gleitkommazahl | Definiert die Query Planner-Version, die für Abfragen verwendet werden soll.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| tls | aktiviert | aktiviert, deaktiviert, fips-140-3, tls1.2\$1, tls1.3\$1 | Ja | Statisch | Zeichenfolge | Gibt an, ob TLS-Verbindungen (Transport Layer Security) erforderlich sind. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| ttl\$1monitor | aktiviert | aktiviert, deaktiviert | Ja | Dynamisch | Zeichenfolge | Gibt an, ob TTL-Überwachung (Time to Live) für den Cluster aktiviert ist. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 

# Amazon DocumentDB-Cluster-Parameter ändern
<a name="cluster_parameter_groups-parameters"></a>

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
<a name="cluster_parameter_groups-describe_details_parameters"></a>

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

------
#### [ Using the AWS-Managementkonsole ]

**So zeigen Sie die Details einer Cluster-Parametergruppe an**

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

1. 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 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.

1. Wählen Sie im Bereich **Parameter groups (Parametergruppen)** den Namen der Cluster-Parametergruppe aus, für die Sie die Details anzeigen möchten.

1. 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.  
![\[Screenshot: Parameternamen und -werte.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-determine-parameter-value.png)

------
#### [ 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.

**Example**  
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
<a name="cluster_parameter_groups-modify_parameters"></a>

Sie können die Parameter einer Parametergruppe mit dem AWS-Managementkonsole oder AWS CLIändern.

------
#### [ Using the AWS-Managementkonsole ]

**So aktualisieren Sie die Parameter einer Cluster-Parametergruppe**

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

1. 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 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.

1. Wählen Sie im Bereich **Parameter groups (Parametergruppen)** die Cluster-Parametergruppe aus, deren Parameter Sie aktualisieren möchten.

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

1. 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](cluster_parameter_groups-list_of_parameters.md).

1. 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"
           }
       ]
   }
   ```

1. **Ä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"
   }
   ```

1. **Warten Sie mindestens 5 Minuten.**

1. **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"
           }
       ]
   }
   ```

------