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.
# Verwaltung von Amazon DocumentDB-Cluster-Parametergruppen
Sie können die Amazon DocumentDB DocumentDB-Engine-Konfiguration verwalten, indem Sie Parameter in einer Cluster-Parametergruppe verwenden. Eine *Cluster-Parametergruppe* ist eine Sammlung von Amazon DocumentDB-Konfigurationswerten, die die Verwaltung der Parameter Ihrer Amazon DocumentDB-Cluster erleichtern. Cluster-Parametergruppen dienen als Container für Engine-Konfigurationswerte, die auf jede alle Instances im Cluster angewendet werden.
In diesem Abschnitt wird beschrieben, wie Cluster-Parametergruppen erstellt, angezeigt und geändert werden. Es wird auch gezeigt, wie Sie ermitteln können, welche Cluster-Parametergruppe einem bestimmten Cluster zugeordnet ist.
**Topics**
+ [Beschreibung von Cluster-Parametergruppen](cluster_parameter_groups-describe.md)
+ [Cluster-Parametergruppen erstellen](cluster_parameter_groups-create.md)
+ [Cluster-Parametergruppen ändern](cluster_parameter_groups-modify.md)
+ [Modifizieren von Clustern zur Verwendung benutzerdefinierter Cluster-Parametergruppen](cluster_parameter_groups-modify_clusters.md)
+ [Cluster-Parametergruppen werden kopiert](cluster_parameter_groups-copy.md)
+ [Cluster-Parametergruppen werden zurückgesetzt](cluster_parameter_groups-reset.md)
+ [Cluster-Parametergruppen löschen](cluster_parameter_groups-delete.md)
+ [Referenz zu den Cluster-Parametern](cluster_parameter_groups-list_of_parameters.md)
# Beschreibung von Amazon DocumentDB-Cluster-Parametergruppen
Eine `default` Cluster-Parametergruppe wird automatisch erstellt, wenn Sie den ersten Amazon DocumentDB-Cluster in einer neuen Region erstellen oder eine neue Engine verwenden. Nachfolgende Cluster, die in derselben Region erstellt werden und dieselbe Engine-Version haben, werden mit der `default` Cluster-Parametergruppe erstellt.
**Topics**
+ [Beschreibung der Details einer Cluster-Parametergruppe](#cluster_parameter_groups-describe_details)
+ [Ermitteln der Parametergruppe eines Clusters](#cluster_parameter_groups-determine)
+ [Ermitteln von Clustern und Instances, die einer Cluster-Parametergruppe zugeordnet sind](#cluster_parameter_groups-count)
## Beschreibung der Details einer Amazon DocumentDB-Cluster-Parametergruppe
Um die Details einer bestimmten Cluster-Parametergruppe zu beschreiben, führen Sie die folgenden Schritte mit dem AWS-Managementkonsole oder dem AWS Command Line Interface (AWS CLI) aus.
------
#### [ Using the AWS-Managementkonsole ]
****
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 **Cluster parameter groups (Cluster-Parametergruppen)** den Namen der Parametergruppe aus, deren Details Sie anzeigen möchten.
1. Auf der anschließend angezeigten Seite werden die Parameter der Parametergruppe, die letzte Aktivität und Tags angezeigt.
+ In **Cluster parameters (Cluster-Parameter)** werden Ihnen der Name, der aktuelle Wert, die zulässigen Werte, der Anwendungstyp, der Datentyp und die Beschreibung des Parameters angezeigt. Sie können auch erkennen, ob der Parameter geändert werden kann. Sie können einzelne Parameter ändern, indem Sie den Parameter auswählen und dann im Abschnitt **Cluster-Parameter** auf **Bearbeiten** klicken. Weitere Informationen finden Sie unter [Amazon DocumentDB-Cluster-Parameter ändern](cluster_parameter_groups-parameters.md).
+ In **Recent events (Aktuelle Ereignisse)** werden Ihnen die jeweils aktuellen Ereignisse für diese Parametergruppe angezeigt. Sie können diese Ereignisse über die Suchleiste in diesem Abschnitt filtern. Weitere Informationen finden Sie unter [Amazon DocumentDB DocumentDB-Ereignisse verwalten](managing-events.md).
+ Unter **Tags** werden die Tags angezeigt, die sich in dieser Cluster-Parametergruppe befinden. Sie können Tags hinzufügen oder entfernen, indem Sie im Abschnitt **Tags die Option** **Bearbeiten** wählen. Weitere Informationen finden Sie unter [Taggen von Amazon DocumentDB DocumentDB-Ressourcen](tagging.md).
------
#### [ Using the AWS CLI ]
Sie können den `describe-db-cluster-parameter-groups` AWS CLI Befehl verwenden, um den Amazon-Ressourcennamen (ARN), die Familie, die Beschreibung und den Namen einer einzelnen Cluster-Parametergruppe oder aller Cluster-Parametergruppen, die Sie für Amazon DocumentDB haben, anzuzeigen. Sie können den `describe-db-cluster-parameters` AWS CLI Befehl auch verwenden, um die Parameter und ihre Details innerhalb einer einzelnen Cluster-Parametergruppe anzuzeigen.
+ **--describe-db-cluster-parameter-groups**— Um eine Liste all Ihrer Cluster-Parametergruppen und ihrer Details zu sehen.
+ **--db-cluster-parameter-group-name**— Fakultativ. Der Name der Cluster-Parametergruppe, die beschrieben werden soll. Wenn dieser Parameter weggelassen wird, werden alle Cluster-Parametergruppen beschrieben.
+ **--describe-db-cluster-parameters**— Um alle Parameter innerhalb einer Parametergruppe und ihre Werte aufzulisten.
+ **--db-cluster-parameter-group name** – Erforderlich. Der Name der Cluster-Parametergruppe, die beschrieben werden soll.
**Example**
Der folgende Code listet bis zu 100 Cluster-Parametergruppen zusammen mit ARN, Familie, Beschreibung und Name auf.
```
aws docdb describe-db-cluster-parameter-groups
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
"DBClusterParameterGroups": [
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Default cluster parameter group for docdb4.0",
"DBClusterParameterGroupName": "default.docdb4.0"
},
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Custom docdb4.0 parameter group",
"DBClusterParameterGroupName": "sample-parameter-group"
}
]
}
```
**Example**
Der folgende Code listet den ARN, die Familie, die Beschreibung und den Namen für `sample-parameter-group` auf.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-cluster-parameter-groups \
--db-cluster-parameter-group-name sample-parameter-group
```
Für Windows:
```
aws docdb describe-db-cluster-parameter-groups ^
--db-cluster-parameter-group-name sample-parameter-group
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
"DBClusterParameterGroups": [
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group",
"Description": "Custom docdb4.0 parameter group",
"DBParameterGroupFamily": "docdb4.0",
"DBClusterParameterGroupName": "sample-parameter-group"
}
]
}
```
**Example**
Der folgende Code listet die Werte der Parameter in `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": "change_stream_log_retention_duration",
"ParameterValue": "17777",
"Description": "Duration of time in seconds that the change stream log is retained and can be consumed.",
"Source": "user",
"ApplyType": "dynamic",
"DataType": "integer",
"AllowedValues": "3600-86400",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------
## Ermitteln der Parametergruppe eines Amazon DocumentDB-Clusters
Um zu ermitteln, welche Parametergruppe einem bestimmten Cluster zugeordnet ist, führen Sie die folgenden Schritte mit dem AWS-Managementkonsole oder dem aus AWS CLI.
------
#### [ Using the AWS-Managementkonsole ]
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 linken Navigationsbereich **Cluster** aus.
1. Wählen Sie aus der Liste der Cluster den Namen des Clusters aus, an dem Sie interessiert sind.
1. Auf der anschließend angezeigten Seite werden die Details des von Ihnen ausgewählten Clusters angezeigt. Scrollen Sie nach unten zu **Cluster details (Clusterdetails)**. Sie finden den Namen der Parametergruppe unten in diesem Abschnitt unterhalb von **Cluster parameter group (Cluster-Parametergruppe)**.
![\[Screenshot: Anzeige der Parametergruppe eines Clusters.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-determine-parameter-group.png)
------
#### [ Using the AWS CLI ]
Der folgende AWS CLI Code bestimmt, welche Parametergruppe den Cluster steuert. `sample-cluster`
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
[
[
"sample-cluster",
"sample-parameter-group"
]
]
```
------
## Ermitteln von Clustern und Instances, die einer Amazon DocumentDB-Cluster-Parametergruppe zugeordnet sind
Um zu ermitteln, wie viele Cluster und Instances jeder Parametergruppe zugeordnet sind, führen Sie die folgenden Schritte mit dem aus AWS CLI.
------
#### [ Using the AWS CLI ]
Der folgende AWS CLI Code bestimmt, mit wie vielen Clustern und Instances verknüpft ist`sample-parameter-group`.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' \
--output json | \
jq -r 'group_by(.[0]) | map({
parameter_group_name: .[0][0],
total_clusters: length,
total_instances: map(.[2] | length) | add // 0
}) | .[]'
```
Für Windows:
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ^
--output json | ^
jq -r 'group_by(.[0]) | map({
parameter_group_name: .[0][0],
total_clusters: length,
total_instances: map(.[2] | length) | add // 0
}) | .[]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
"parameter_group_name": "sample-parameter-group",
"total_clusters": 50,
"total_instances": 150
}
```
------
# Amazon DocumentDB-Cluster-Parametergruppen erstellen
Standard-Cluster-Parametergruppen wie `default.docdb5.0``default.docdb4.0`, oder werden erstellt`default.docdb3.6`, wenn Sie einen Cluster mit einer neuen Engine-Version und in einer neuen Region erstellen. Nachfolgende Cluster, die in dieser Region und mit derselben Engine-Version erstellt wurden, erben die `default` Cluster-Parametergruppe. Nach der Erstellung können die `default` Parametergruppen 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](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-modify.html).
**Anmerkung**
Sie sollten nach der Erstellung einer Cluster-Parametergruppe mindestens 5 Minuten warten, bevor Sie diese Cluster-Parametergruppe verwenden. Dadurch kann Amazon DocumentDB die `create` Aktion vollständig abschließen, bevor die Cluster-Parametergruppe für einen neuen Cluster verwendet wird. Sie können die Operation AWS-Managementkonsole oder die `describe-db-cluster-parameter-groups` AWS CLI Operation verwenden, um zu überprüfen, ob Ihre Cluster-Parametergruppe erstellt wurde. Weitere Informationen finden Sie unter [Beschreibung von Amazon DocumentDB-Cluster-Parametergruppen](cluster_parameter_groups-describe.md).
------
#### [ Using the AWS-Managementkonsole ]
**So erstellen Sie eine 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 **Cluster parameter groups (Cluster-Parametergruppen)** die Option **Create (Erstellen)** aus.
1. Geben Sie im Bereich **Create cluster parameter group (Cluster-Parametergruppe erstellen)** Folgendes ein:
1. **Neuer Cluster-Parametergruppenname** — 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.
1. **Family** — Wählen Sie eine DocumentDB-Version, die Sie für Ihren Cluster verwenden möchten.
1. **Beschreibung** — Geben Sie eine Beschreibung für diese Cluster-Parametergruppe ein.
1. Um die Cluster-Parametergruppe zu erstellen, wählen Sie **Erstellen** aus. Um die Operation abzubrechen, wählen Sie **Abbrechen** aus.
1. 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` Vorgang 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-Parametergruppen-Familie, die als Vorlage für die benutzerdefinierte Cluster-Parametergruppe verwendet wird.
+ **--description**— Die vom Benutzer bereitgestellte Beschreibung für diese Cluster-Parametergruppe. Das folgende Beispiel verwendet "`Custom docdb4.0 parameter group`“.
Für Linux, macOS oder Unix:
**Example**
```
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"
}
}
```
------
# 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](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) oder [eine bestehende Parametergruppe kopieren](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), 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 den AWS CLI `describe-db-cluster-parameters` Vorgang AWS-Managementkonsole oder verwenden, um zu überprüfen, ob Ihre Cluster-Parametergruppe geändert wurde. Weitere Informationen finden Sie unter [Beschreibung von Cluster-Parametergruppen](cluster_parameter_groups-describe.md).
------
#### [ Using the AWS-Managementkonsole ]
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](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), 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](db-cluster-modify.md).
**So ändern Sie eine benutzerdefinierte 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 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 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.
1. 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 als aufgeführt ist.**
1. Wenn der Parameter geändert werden kann, wählen Sie ihn aus und wählen oben rechts auf der Konsolenseite **Edit (Bearbeiten)** aus.
1. Nehmen Sie im Dialogfeld **Modify ``** 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 `ParameterValue``Description`, oder `ApplyMethod` eines beliebigen modifizierbaren Parameters in einer benutzerdefinierten Amazon DocumentDB-Cluster-Parametergruppe ändern, indem Sie den. 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](cluster_parameter_groups-list_of_parameters.md) 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.
**Example - Ä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"
}
]
}
```
1. Ä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"
}
```
1. Warten Sie mindestens 5 Minuten.
1. 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"
}
]
}
```
------
# Ändern von Amazon DocumentDB-Clustern zur Verwendung benutzerdefinierter Cluster-Parametergruppen
Wenn Sie einen Amazon DocumentDB-Cluster erstellen, wird automatisch eine `default.docdb4.0` Parametergruppe für diesen Cluster erstellt. Sie können die Cluster-Parametergruppe `default` nicht ändern. Stattdessen können Sie Ihren Amazon DocumentDB-Cluster ändern, um ihm eine neue benutzerdefinierte Parametergruppe zuzuordnen.
In diesem Abschnitt wird erklärt, wie ein vorhandener Amazon DocumentDB-Cluster so geändert wird, dass er eine benutzerdefinierte Cluster-Parametergruppe mit AWS-Managementkonsole und AWS Command Line Interface (AWS CLI) verwendet.
------
#### [ Using the AWS-Managementkonsole ]
**Um einen Amazon DocumentDB-Cluster so zu ändern, dass er eine neue, nicht standardmäßige Cluster-Parametergruppe verwendet**
1. Bevor Sie beginnen, stellen Sie sicher, dass Sie einen Amazon DocumentDB-Cluster und eine Cluster-Parametergruppe erstellt haben. Weitere Anweisungen finden Sie unter [Einen Amazon DocumentDB-Cluster erstellen](db-cluster-create.md) und [Amazon DocumentDB-Cluster-Parametergruppen erstellen](cluster_parameter_groups-create.md).
1. Nachdem Sie Ihre Cluster-Parametergruppe erstellt haben, öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). Wählen Sie im Navigationsbereich **Clusters (Cluster)** aus, um die neue Parametergruppe einem Cluster hinzuzufügen.
1. Wählen Sie den Cluster aus, dem Sie die Parametergruppe zuordnen möchten. Wählen Sie **Actions (Aktionen=** und anschließend **Modify (Ändern)** aus, um den Cluster zu ändern.
1. Wählen Sie unter **Cluster options (Clusteroptionen)** die neue Parametergruppe aus, der Sie den Cluster zuordnen möchten.
1. Wählen Sie **Continue (Weiter)** aus, um eine Übersicht Ihrer Änderungen anzuzeigen.
1. Nachdem Sie Ihre Änderungen überprüft haben, können Sie diese sofort oder während des nächsten Wartungsfensters unter **Scheduling of modifications (Planen von Änderungen)** anwenden.
1. Wählen Sie **Modify cluster (Cluster ändern)** aus, um den Cluster mit der neuen Parametergruppe zu aktualisieren.
------
#### [ Using the AWS CLI ]
Bevor Sie beginnen, stellen Sie sicher, dass Sie einen Amazon DocumentDB-Cluster und eine Cluster-Parametergruppe erstellt haben. Mit diesem AWS CLI `create-db-cluster` Vorgang können Sie [einen Amazon DocumentDB-Cluster erstellen](https://docs.aws.amazon.com//documentdb/latest/developerguide/db-cluster-create.html). Sie können mithilfe des AWS CLI `create-db-cluster-parameter-group` Vorgangs [eine Cluster-Parametergruppe erstellen](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html).
Verwenden Sie den AWS CLI `modify-db-cluster` Vorgang mit den folgenden Parametern, um Ihrem Cluster Ihre neue Cluster-Parametergruppe hinzuzufügen.
+ **-- db-cluster-identifier** — Der Name Ihres Clusters (z. B.`sample-cluster`).
+ **-- db-cluster-parameter-group -name** — Der Name der Parametergruppe, der Sie Ihren Cluster zuordnen möchten (z. B.`sample-parameter-group`).
**Example**
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--db-cluster-parameter-group-name sample-parameter-group
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
"DBCluster": {
"AvailabilityZones": [
"us-west-2c",
"us-west-2b",
"us-west-2a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
...
}
```
------
# Amazon DocumentDB-Cluster-Parametergruppen kopieren
Sie können eine Kopie einer Cluster-Parametergruppe in Amazon DocumentDB mit dem AWS-Managementkonsole oder dem AWS Command Line Interface (AWS CLI) erstellen.
------
#### [ Using the AWS-Managementkonsole ]
Das folgende Verfahren führt Sie durch die Erstellung einer neuen Cluster-Parametergruppe, indem Sie eine vorhandene Cluster-Parametergruppe kopieren.
**So kopieren Sie eine 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.
1. Wählen Sie im Bereich **Cluster parameter groups (Cluster-Parametergruppen)** den Namen der Cluster-Parametergruppe aus, die Sie kopieren möchten.
1. Wählen Sie **Actions (Aktionen)** und anschließend **Copy (Kopieren)** aus, um diese Parametergruppe zu kopieren.
1. Geben Sie in **Copy options (Kopieroptionen)** einen Namen und eine Beschreibung für die neue Cluster-Parametergruppe ein. Wählen Sie anschließend **Copy (Kopieren)** aus, um Ihre Änderungen zu speichern.
------
#### [ Using the AWS CLI ]
Um eine Kopie einer Cluster-Parametergruppe zu erstellen, verwenden Sie die `copy-db-cluster-parameter-group`-Operation mit den folgenden Parametern.
+ **--source-db-cluster-parameter-group-identifier** – Erforderlich. Der Name oder Amazon-Ressourcenname (ARN) der Cluster-Parametergruppe, von der Sie eine Kopie erstellen möchten.
Wenn sich die Quell- und Zielcluster-Parametergruppen in derselben Gruppe befinden AWS-Region, kann der Identifier entweder ein Name oder ein ARN sein.
Wenn sich die Quell- und Zielcluster-Parametergruppen unterscheiden AWS-Regionen, muss es sich bei dem Bezeichner um einen ARN handeln.
+ **--target-db-cluster-parameter-group-identifier** – Erforderlich. Der Name oder ARN der Kopie der Cluster-Parametergruppe.
Einschränkungen:
+ Kann nicht Null, leer oder negativ sein.
+ Muss 1—255 Buchstaben, Zahlen oder Bindestriche enthalten.
+ Muss mit einem Buchstaben beginnen.
+ Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.
+ **--target-db-cluster-parameter-group-description** – Erforderlich. Eine vom Benutzer angegebene Beschreibung für die Kopie der Cluster-Parametergruppe.
**Example**
Der folgende Code erstellt eine Kopie von `sample-parameter-group` und benennt die Kopie `sample-parameter-group-copy`.
Für Linux, macOS oder Unix:
```
aws docdb copy-db-cluster-parameter-group \
--source-db-cluster-parameter-group-identifier sample-parameter-group \
--target-db-cluster-parameter-group-identifier sample-parameter-group-copy \
--target-db-cluster-parameter-group-description "Copy of sample-parameter-group"
```
Für Windows:
```
aws docdb copy-db-cluster-parameter-group ^
--source-db-cluster-parameter-group-identifier sample-parameter-group ^
--target-db-cluster-parameter-group-identifier sample-parameter-group-copy ^
--target-db-cluster-parameter-group-description "Copy of sample-parameter-group"
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group-copy",
"DBClusterParameterGroupName": "sample-parameter-group-copy",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Copy of sample-parameter-group"
}
}
```
------
# Amazon DocumentDB-Cluster-Parametergruppen zurücksetzen
Sie können einige oder alle Parameterwerte einer Amazon DocumentDB-Cluster-Parametergruppe auf ihre Standardwerte zurücksetzen, indem Sie das AWS-Managementkonsole oder das AWS Command Line Interface (AWS CLI) verwenden, um die Cluster-Parametergruppe zurückzusetzen.
------
#### [ Using the AWS-Managementkonsole ]
Führen Sie die folgenden Schritt aus, um einige oder alle Parameterwerte einer Cluster-Parametergruppe auf die Standardwerte zurückzusetzen.
**So setzen Sie die Parameterwerte einer Cluster-Parametergruppe zurück**
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 auf der linken Seite der Konsole **Parameter groups (Parametergruppen)** aus.
1. Wählen Sie im Bereich **Cluster parameter groups (Cluster-Parametergruppen)** den Namen der Cluster-Parametergruppe aus, die Sie zurücksetzen möchten.
1. Wählen Sie **Actions (Aktionen)** und anschließend **Reset (Zurücksetzen)** aus, um diese Parametergruppe zurückzusetzen.
1. Bestätigen Sie auf der Seite **Cluster parameter group reset confirmation (Zurücksetzen der Cluster-Parametergruppe bestätigen)**, dass Sie alle Cluster-Parameter für diese Parametergruppe auf die Standardwerte zurücksetzen möchten. Wählen Sie anschließend **Reset (Zurücksetzen)** aus, um die Parametergruppe zurückzusetzen. Sie können auch **Cancel (Abbrechen)** auswählen, um die Änderungen zu verwerfen.
------
#### [ Using the AWS CLI ]
Um einige oder alle Parameterwerte einer Cluster-Parametergruppe auf ihre Standardwerte zurückzusetzen, verwenden Sie die `reset-db-cluster-parameter-group`-Operation mit den folgenden Parametern.
+ **--db-cluster-parameter-group-name** – Erforderlich. Der Name der zurückzusetzenden Cluster-Parametergruppe.
+ **--parameters**— Fakultativ. Eine Liste von `ParameterName` und `ApplyMethod` in der Cluster-Parametergruppe, die auf ihre Standardwerte zurücksetzt werden sollen. Statische Parameter müssen auf `pending-reboot` gesetzt sein, damit sie beim nächsten Neustart der Instance oder `reboot-db-instance`-Anforderung wirksam werden. Sie müssen `reboot-db-instance` für alle Instances in Ihrem Cluster aufrufen, auf die der aktualisierte statische Parameter angewendet werden soll.
Dieser Parameter und `--reset-all-parameters` schließen sich gegenseitig aus. Sie können jede der beiden Optionen verwenden, jedoch nicht beide.
+ **--reset-all-parameters**oder **--no-reset-all-parameters** — Fakultativ. Gibt an, ob alle Parameter (`--reset-all-parameters`) oder nur einige der Parameter (`--no-reset-all-parameters`) auf ihre Standardwerte zurückgesetzt werden sollen. Der `--reset-all-parameters`-Parameter und `--parameters` schließen sich gegenseitig aus. Sie können jede der beiden Optionen verwenden, jedoch nicht beide.
Wenn Sie die gesamte Gruppe zurücksetzen, werden dynamische Parameter sofort aktualisiert. Statische Parameter werden auf `pending-reboot` festgelegt, damit sie beim nächsten Neustart der Instance oder bei der nächsten `reboot-db-instance`-Anforderung wirksam werden. Sie müssen `reboot-db-instance` für alle Instances in Ihrem Cluster aufrufen, auf die der aktualisierte statische Parameter angewendet werden soll.
**Example**
**Beispiel 1: Zurücksetzen aller Parameter auf ihre Standardwerte**
Der folgende Code setzt alle Parameter in der Cluster-Parametergruppe `sample-parameter-group` auf ihre Standardwerte zurück.
Für Linux, macOS oder Unix:
```
aws docdb reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--reset-all-parameters
```
Für Windows:
```
aws docdb reset-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--reset-all-parameters
```
**Beispiel 2: Zurücksetzen von angegebenen Parametern auf ihre Standardwerte**
Der folgende Code setzt den `tls`-Parameter in der Cluster-Parametergruppe `sample-parameter-group` auf seinen Standardwert zurück.
Für Linux, macOS oder Unix:
```
aws docdb reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--no-reset-all-parameters \
--parameters ParameterName=tls,ApplyMethod=pending-reboot
```
Für Windows:
```
aws docdb reset-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--no-reset-all-parameters ^
--parameters ParameterName=tls,ApplyMethod=pending-reboot
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
**Neustarten einer Cluster-Instance**
Bevor ein statischer Parameterwert geändert wird, muss die Cluster-Instance neu gestartet werden. Starten Sie alle Instances in Ihrem Cluster neu, auf die der aktualisierte statische Parameter angewendet werden soll.
Für Linux, macOS oder Unix:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-cluster-instance
```
Für Windows:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-cluster-instance
```
------
# Löschen von Amazon DocumentDB-Cluster-Parametergruppen
Sie können eine benutzerdefinierte Amazon DocumentDB-Cluster-Parametergruppe mit dem AWS-Managementkonsole oder dem AWS Command Line Interface (AWS CLI) löschen. Sie können die Cluster-Parametergruppe `default.docdb4.0` nicht löschen.
------
#### [ Using the AWS-Managementkonsole ]
**So löschen Sie eine 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 **Parametergruppen** das Optionsfeld links neben der Cluster-Parametergruppe aus, die Sie löschen möchten.
1. Wählen Sie **Aktionen** und anschließend **Löschen** aus.
1. Wählen Sie im Bestätigungsbereich **Delete (Löschen)** die Option **Delete (Löschen)** aus, um die Cluster-Parametergruppe zu löschen. Um die Cluster-Parametergruppe beizubehalten, wählen Sie **Cancel (Abbrechen)** aus.
------
#### [ Using the AWS CLI ]
Um eine Cluster-Parametergruppe zu löschen, verwenden Sie die `delete-db-cluster-parameter-group`-Operation mit dem folgenden Parameter.
+ **--db-cluster-parameter-group-name** – Erforderlich. Der Name der zu löschenden Cluster-Parametergruppe. Dabei muss es sich um eine vorhandene Cluster-Parametergruppe handeln. *Sie können die Cluster-Parametergruppe `default.docdb4.0` nicht löschen.*
**Example - Löschen einer Cluster-Parametergruppe**
Das folgende Beispiel führt Sie durch die drei Schritte zum Löschen einer Cluster-Parametergruppe:
1. Ermitteln des Namens der Cluster-Parametergruppe, die Sie löschen möchten.
1. Löschen der angegebene Cluster-Parametergruppe.
1. Überprüfen, ob die Cluster-Parametergruppe gelöscht wurde.
**1. Suchen Sie den Namen der Cluster-Parametergruppe, die Sie löschen möchten.**
Der folgende Code listet die Namen aller Cluster-Parametergruppen auf.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Für Windows:
```
aws docdb describe-db-cluster-parameter-groups ^
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Die Ausgabe der vorherigen Operation ist eine Liste der Namen der Cluster-Parametergruppen ähnlich der folgenden (JSON-Format).
```
[
[
"default.docdb4.0"
],
[
"sample-parameter-group"
],
[
"sample-parameter-group-copy"
]
]
```
**2. Löschen Sie eine angegebene Cluster-Parametergruppe.**
Der folgenden Code löscht die Cluster-Parametergruppe `sample-parameter-group-copy`.
Für Linux, macOS oder Unix:
```
aws docdb delete-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group-copy
```
Für Windows:
```
aws docdb delete-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group-copy
```
Diese Operation erzeugt keine Ausgabe.
**3. Überprüfen Sie, ob die angegebene Cluster-Parametergruppe gelöscht wurde.**
Der folgende Code listet die Namen aller verbleibenden Cluster-Parametergruppen auf.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Für Windows:
```
aws docdb describe-db-cluster-parameter-groups ^
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Die Ausgabe der obigen Operation ist eine Liste der Cluster-Parametergruppen, die der folgenden ähnelt (JSON-Format). Die Cluster-Parametergruppe, die Sie gerade gelöscht haben, sollte nicht in der Liste enthalten sein.
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
[
[
"default.docdb4.0"
],
[
"sample-parameter-group"
]
]
```
------
# Referenz zu den Amazon DocumentDB-Clusterparametern
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
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-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
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"
}
]
}
```
------