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.
# Überblick über die globalen Amazon DocumentDB-Cluster
## Was ist ein globaler Cluster?
Ein globaler Cluster besteht aus einer primären Region und bis zu 10 schreibgeschützten sekundären Regionen. Sie führen Schreibvorgänge direkt in den primären Cluster in der primären Region durch und Amazon DocumentDB repliziert die Daten mithilfe einer dedizierten Infrastruktur automatisch in die sekundären Regionen. Die Latenz liegt in der Regel unter einer Sekunde.
## Wie sind globale Cluster nützlich?
+ **Wiederherstellung nach regionalen Ausfällen — Im Falle eines regionsweiten Ausfalls** können Sie einen der sekundären Cluster innerhalb von Minuten zu einem primären Cluster heraufstufen, wobei ein typisches Recovery Time Objective (RTO) unter einer Minute liegt. Das Recovery Point Objective (RPO) wird in der Regel in Sekunden gemessen. Dies hängt jedoch von der Verzögerung im Netzwerk zum Zeitpunkt des Ausfalls ab.
+ **Globale Lesevorgänge mit lokaler Latenz** — Wenn Sie Niederlassungen auf der ganzen Welt haben, können Sie einen globalen Cluster verwenden, um Ihre wichtigsten Informationsquellen in der Primärregion auf dem neuesten Stand zu halten. Niederlassungen in Ihren anderen Regionen können mit lokaler Latenz auf die Informationen in ihrer eigenen Region zugreifen.
+ **Skalierbare sekundäre Cluster** — Sie können Ihre sekundären Cluster skalieren, indem Sie einer sekundären Region weitere Nur-Lese-Instances hinzufügen. Der sekundäre Cluster ist schreibgeschützt, sodass er bis zu 16 schreibgeschützte Replikatinstanzen anstelle der üblichen Grenze von 15 für einen einzelnen Cluster unterstützen kann.
+ **Schnelle Replikation vom primären zum sekundären Cluster** — Die von einem globalen Cluster durchgeführte Replikation hat nur geringe Auswirkungen auf die Leistung des primären Datenbank-Clusters. Die Ressourcen der DB-Instances werden ausschließlich für Lese- und Schreib-Workloads von Anwendungen genutzt.
## Was sind die aktuellen Einschränkungen globaler Cluster?
+ Globale Cluster werden in Amazon DocumentDB v3.6 nicht unterstützt.
+ Globale Cluster werden auf allen Instance-Typen außer db.t3, db.t4g und db.r4 unterstützt.
+ Globale Cluster sind in den folgenden Regionen nicht verfügbar: Südamerika (São Paulo), Europa (Mailand), China (Peking) und China (Ningxia).
+ Switchover und globales Failover werden nicht unterstützt, wenn Regionen unterschiedliche Engine-Versionen verwenden. Manuelles Failover wird unterstützt, wenn die Engine-Versionen nicht übereinstimmen.
+ Nur der primäre Cluster führt Schreibvorgänge aus. Clients, die Schreibvorgänge ausführen, stellen eine Verbindung zum Clusterendpunkt des primären Clusters her.
+ Sie können maximal 10 sekundäre Regionen und eine primäre Region für Ihren Cluster einrichten.
+ Ein sekundärer Cluster kann nicht gestoppt werden. Ein primärer Cluster kann nicht gestoppt werden, wenn ihm sekundäre Cluster zugeordnet sind. Nur ein regionaler Cluster ohne sekundäre Cluster kann gestoppt werden.
+ An den sekundären Cluster angehängte Replikate können unter bestimmten Umständen neu gestartet werden. Wenn die Instanz der primären Region neu gestartet oder ein Failover durchgeführt wird, werden auch die Replikate in der sekundären Region neu gestartet. Der Cluster ist dann nicht verfügbar, bis alle Replikate wieder mit der Writer-Instance des primären Datenbankclusters synchronisiert sind. Dieses Verhalten wird erwartet. Stellen Sie sicher, dass Sie die Auswirkungen auf Ihren globalen Cluster verstehen, bevor Sie Änderungen an Ihrem primären Cluster vornehmen.
+ Sie können Change Streams nicht auf sekundären Clustern verwenden.
**Topics**
+ [
## Was ist ein globaler Cluster?
](#w2aac33b9b3)
+ [
## Wie sind globale Cluster nützlich?
](#w2aac33b9b5)
+ [
## Was sind die aktuellen Einschränkungen globaler Cluster?
](#w2aac33b9b7)
+ [Schnellstart-Anleitung](global-clusters.get-started.md)
+ [Verwaltung globaler Cluster](global-clusters.manage.md)
+ [Globale Cluster verbinden](global-clusters-connect.md)
+ [Überwachung globaler Cluster](global-clusters-monitor.md)
+ [Notfallwiederherstellung](global-clusters-disaster-recovery.md)
# Schnellstartanleitung: globale Cluster
**Topics**
+ [Konfiguration](#global-clusters.config)
+ [Einen globalen Cluster erstellen](#global-clusters-create)
+ [Eine Region zu einem globalen Cluster hinzufügen](#global-clusters.add-region)
+ [Verwenden eines Snapshots](#global-clusters.snapshot)
## Konfiguration
Der globale Amazon DocumentDB-Cluster umfasst mindestens zwei. AWS-Regionen Die primäre Region unterstützt einen Cluster mit einer primären (Writer-) Instance und bis zu 15 Replikat-Instances, während in einer sekundären Region ein schreibgeschützter Cluster läuft, der ausschließlich aus bis zu 16 Replikat-Instances besteht. Ein globaler Cluster kann bis zu fünf sekundäre Regionen haben. In der Tabelle sind die maximal zulässigen Cluster, Instances und Replikate in einem globalen Cluster aufgeführt.
| Description | Primär AWS-Region | Sekundär AWS-Region |
| --- | --- | --- |
| Cluster | 1 | 5 (maximal) |
| Writer-Inst | 1 | 0 |
| Nur-Lese-Instances (Amazon DocumentDB DocumentDB-Repliken) pro Cluster | 15 (Max.) | 16 (Total) |
| Schreibgeschützte Instances (maximal zulässig, bei tatsächlicher Anzahl von sekundären Regionen) | 15 - s | s = Gesamtzahl der sekundären AWS-Regionen |
Für die Cluster gelten die folgenden spezifischen Anforderungen:
+ **Klassenanforderungen für Datenbank-Instances** — Sie können nur die Klassen `db.r5` und `db.r6g` Instance verwenden.
+ **AWS-Region Anforderungen** — Der primäre Cluster muss sich in einer Region befinden, und mindestens ein sekundärer Cluster muss sich in einer anderen Region desselben Kontos befinden. Sie können bis zu fünf sekundäre (schreibgeschützte) Cluster erstellen, und jeder muss sich in einer anderen Region befinden. Mit anderen Worten, es können sich keine zwei Cluster in derselben Region befinden.
+ **Anforderungen an die Benennung** — Die Namen, die Sie für jeden Ihrer Cluster wählen, müssen in allen Regionen eindeutig sein. Sie können nicht denselben Namen für verschiedene Cluster verwenden, auch wenn sie sich in verschiedenen Regionen befinden.
## Einen globalen Amazon DocumentDB-Cluster erstellen
Sind Sie bereit, Ihren ersten globalen Cluster aufzubauen? In diesem Abschnitt erklären wir, wie Sie einen brandneuen globalen Cluster mit neuen Datenbankclustern und Instances erstellen, indem Sie entweder die AWS-Managementkonsole oder AWS CLI die folgenden Anweisungen verwenden.
### Mit dem AWS-Managementkonsole
1. Navigieren Sie in der AWS-Managementkonsole zu **Amazon DocumentDB**.
1. Wenn Sie zur Amazon DocumentDB DocumentDB-Konsole gelangen, wählen Sie **Clusters**.
![\[Die Cluster-Seite in der Amazon DocumentDB DocumentDB-Konsole.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Wählen Sie **Erstellen** aus.
![\[Die Schaltfläche Erstellen wird in der oberen rechten Ecke der Cluster-Tabelle angezeigt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png)
1. Füllen Sie den Abschnitt **Konfiguration** des Formulars **Amazon DocumentDB-Cluster erstellen** entsprechend aus:
+ **Cluster-ID**: Sie können entweder eine eindeutige Kennung für diese Instance eingeben oder Amazon DocumentDB erlauben, die Instance-ID auf der Grundlage der Cluster-ID bereitzustellen.
+ **Engine-Version: Wählen Sie 4.0.0**
+ **Instanzklasse: Wählen Sie db.r5.large**
+ **Anzahl der Instanzen: Wählen Sie 3.**
![\[Formular mit Konfigurationsoptionen für die Erstellung eines Amazon DocumentDB-Clusters.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png)
1. Geben Sie im Abschnitt **Authentifizierung** einen Master-Benutzernamen und ein Master-Passwort ein.
![\[Authentifizierungsformular zur Angabe eines Master-Benutzernamens und -Passworts für einen neuen Amazon DocumentDB-Cluster.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png)
1. Wählen Sie **Erweiterte Einstellungen anzeigen**.
![\[Umschaltfläche „Erweiterte Einstellungen anzeigen“ neben den Schaltflächen „Abbrechen“ und „Cluster erstellen“.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png)
1. Gehen Sie im Bereich **Netzwerkeinstellungen** wie folgt vor:
+ Behalten Sie die Standardoptionen für **Virtual Private Cloud (VPC)** und **Subnetzgruppe** bei.
![\[Formular mit Netzwerkeinstellungen mit Optionen für VPC, Subnetzgruppen und VPC-Sicherheitsgruppen. Für VPC- und Subnetzgruppenfelder sind Standardoptionen ausgewählt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png)
+ Für **VPC-Sicherheitsgruppen** sollte **Standard (VPC)** bereits hinzugefügt sein.
![\[Das Formular mit den Netzwerkeinstellungen zeigt, dass die Standard-VPC bereits hinzugefügt wurde.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png)
+ Geben Sie `DocDB` in das Feld **VPC-Sicherheitsgruppen** ein und wählen Sie **DoCDB-Inbound** (VFC) aus.
![\[DoCDB-Inbound-VFC wurde im Dropdownmenü VPC-Sicherheitsgruppen ausgewählt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png)
1. **Behalten Sie für **Cluster-Optionen und E** die Standardauswahl bei. ncryption-at-rest**
![\[Clusteroptionen und Encryption-at-rest -formulare mit ausgewählten Standardoptionen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png)
1. Behalten Sie für **Backup** - und **Protokollexporte** die Standardauswahl bei.
![\[Backup and Log exportiert Formulare mit ausgewählten Standardoptionen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png)
1. Behalten Sie für **Wartung**, **Tags** und **Löschschutz** die Standardauswahl bei.
![\[Formulare für Wartung, Tags und Löschschutz mit ausgewählten Standardoptionen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png)
1. Klicken Sie nun auf die Schaltfläche mit der **Aufschrift Cluster erstellen**.
![\[Die Schaltfläche Cluster erstellen wird am Ende des Clustererstellungsprozesses angezeigt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png)
### Mit dem AWS CLI
Um einen regionalen Amazon DocumentDB DocumentDB-Cluster zu erstellen, rufen Sie den auf [create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html). Der folgende AWS CLI Befehl erstellt einen Amazon DocumentDB-Cluster mit dem Namen`global-cluster-id`. Weitere Informationen zum Löschschutz finden Sie unter[Löschen eines Amazon DocumentDB-Clusters](db-cluster-delete.md).
Außerdem `--engine-version` ist dies ein optionaler Parameter, der standardmäßig die neueste Hauptversion der Engine verwendet. Die aktuelle Standard-Engine-Version ist `5.0.0` (Hinweis: Amazon DocumentDB 8.0 ist verfügbar, muss aber explizit als angegeben werden`8.0.0`). Wenn neue Hauptversionen der Engine veröffentlicht werden, `--engine-version` wird die Standard-Engine-Version für aktualisiert, sodass sie die letzte Hauptversion der Engine widerspiegelt. Daher empfehlen wir für Produktionsworkloads, insbesondere solche, die von Skripten, Automatisierung oder CloudFormation Vorlagen abhängig sind, die Angabe der `--engine-version` beabsichtigten Hauptversion ausdrücklich.
Wenn ein `db-subnet-group-name` oder nicht angegeben `vpc-security-group-id` ist, verwendet Amazon DocumentDB die Standard-Subnetzgruppe und die Amazon VPC-Sicherheitsgruppe für die angegebene Region.
Ersetzen Sie im folgenden Beispiel jede Information durch Ihre *user input placeholder* eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb create-db-cluster \
--global-cluster-identifier global-cluster-id \
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
Für Windows:
```
aws docdb create-db-cluster ^
--global-cluster-identifier global-cluster-id ^
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "4.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
"DBClusterIdentifier": "cluster-id",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb4.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
Die Erstellung des Clusters dauert mehrere Minuten. Sie können das AWS-Managementkonsole oder verwenden AWS CLI , um den Status Ihres Clusters zu überwachen. Weitere Informationen finden Sie unter [Den Status eines Amazon DocumentDB-Clusters überwachen](monitoring_docdb-cluster_status.md).
**Wichtig**
Wenn Sie den verwenden AWS CLI , um einen regionalen Amazon DocumentDB-Cluster zu erstellen, werden keine Instances erstellt. Daher müssen Sie explizit eine primäre Instance und alle benötigten Replikat-Instances anlegen. Sie können entweder die Konsole oder AWS CLI zum Erstellen der Instances verwenden. Weitere Informationen finden Sie unter [Hinzufügen einer Amazon DocumentDB DocumentDB-Instance zu einem Cluster](db-instance-add.md) und [CreateDBCluster](API_CreateDBCluster.md) in der Amazon DocumentDB DocumentDB-API-Referenz.
Sobald Ihr regionaler Cluster verfügbar ist, können Sie mit den folgenden Anweisungen einen sekundären Cluster in einer anderen Region hinzufügen:[Hinzufügen eines AWS-Region zu einem globalen Amazon DocumentDB-Cluster](#global-clusters.add-region). Wenn Sie eine Region hinzufügen, wird Ihr regionaler Cluster zu Ihrem primären Cluster, und Sie haben einen neuen sekundären Cluster in der von Ihnen ausgewählten Region.
## Hinzufügen eines AWS-Region zu einem globalen Amazon DocumentDB-Cluster
Ein globaler Cluster benötigt mindestens einen sekundären Cluster in einer anderen Region als der primäre Cluster, und Sie können bis zu fünf sekundäre Cluster hinzufügen. Beachten Sie, dass Sie für jeden sekundären Cluster, den Sie hinzufügen, die Anzahl der im primären Cluster zulässigen Replikate um eins reduzieren müssen. Wenn Ihr globaler Cluster beispielsweise fünf sekundäre Regionen hat, kann Ihr primärer Cluster nur 10 (statt 15) Replikate haben. Weitere Informationen finden Sie unter [Konfigurationsanforderungen eines globalen Amazon DocumentDB-Clusters](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config).
### Unter Verwendung des AWS-Managementkonsole
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole.
1. Klicken Sie im Navigationsbereich auf **Cluster**.
![\[Die Cluster-Seite in der Amazon DocumentDB DocumentDB-Konsole.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Wählen Sie den Cluster aus, dem Sie einen sekundären Cluster hinzufügen möchten. Stellen Sie sicher, dass der `Available` Cluster
![\[Liste der regionalen und globalen Cluster mit dem Verfügbarkeitsstatus, wobei mydocdbglobalcluster hervorgehoben ist.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png)
1. **Wählen Sie die Dropdownliste für **Aktionen** aus und wählen Sie dann Region hinzufügen aus.**
![\[Das Drop-down-Menü „Aktionen“ auf der Cluster-Oberfläche zeigt die Option „Region hinzufügen“.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png)
1. Wählen Sie auf der AWS-Region Seite **Hinzufügen** die sekundäre Region aus. Beachten Sie, dass Sie keine Region auswählen können, die bereits über einen sekundären Cluster für denselben globalen Cluster verfügt. Außerdem kann es sich nicht um dieselbe Region wie der primäre Cluster handeln. Wenn dies die erste Region ist, die Sie hinzufügen, müssen Sie auch eine globale Cluster-ID Ihrer Wahl angeben.
![\[Wählen Sie über das Drop-down-Menü im AWS-Region Formular Hinzufügen eine sekundäre Region aus.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png)
1. Füllen Sie die verbleibenden Felder für den sekundären Cluster in der neuen Region aus und wählen Sie dann **Cluster erstellen** aus. Nachdem Sie die Region hinzugefügt haben, können Sie sie in der Liste der **Cluster** in der sehen AWS-Managementkonsole.
![\[Letzte Schritte zum Hinzufügen einer Region zu einem Cluster. Das Konfigurationsformular, die stündliche Kostenschätzung und die Schaltfläche Cluster erstellen werden angezeigt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png)
### Mit dem AWS CLI
+ Verwenden Sie den `create-db-cluster` CLI-Befehl mit dem Namen `(--global-cluster-identifier)` Ihres globalen Clusters. Für andere Parameter, führen Sie die folgenden Schritte aus:
+ Wählen Sie für `--region` eine andere Region AWS-Region als die Ihrer Hauptregion.
+ Wählen Sie bestimmte Werte für die Parameter `--engine-version` und `--engine` aus.
+ Geben Sie für einen verschlüsselten Cluster Ihren primären Cluster AWS-Region als `--source-region` für die Verschlüsselung an.
Im folgenden Beispiel wird ein neuer Amazon DocumentDB-Cluster erstellt und als schreibgeschützter sekundärer Cluster an den globalen Cluster angehängt. Im letzten Schritt wird die Instance dem neuen Cluster hinzugefügt.
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb --region secondary-region-id \
create-db-cluster \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
aws docdb --region secondary-region-id \
create-db-instance \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
```
Für Windows:
```
aws docdb --region secondary-region-id ^
create-db-cluster ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
aws docdb --region secondary-region-id ^
create-db-instance ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
```
## Verwenden eines Snapshots für Ihren globalen Amazon DocumentDB-Cluster
Sie können einen Snapshot eines Amazon DocumentDB-Clusters wiederherstellen, um ihn als Ausgangspunkt für Ihren globalen Cluster zu verwenden. Dazu müssen Sie den Snapshot wiederherstellen und einen neuen Cluster erstellen. Dieser wird als primärer Cluster Ihres globalen Clusters dienen. Anschließend können Sie dem wiederhergestellten Cluster eine weitere Region hinzufügen und ihn so in einen globalen Cluster konvertieren.
# Verwaltung eines globalen Amazon DocumentDB-Clusters
Sie führen die meisten Verwaltungsvorgänge auf den einzelnen Clustern aus, aus denen ein globaler Cluster besteht. Wenn Sie auf der Seite **Cluster** in der Konsole die Option **Gruppenverwandte Ressourcen** auswählen, werden der primäre Cluster und die sekundären Cluster unter dem zugehörigen globalen Cluster gruppiert angezeigt.
Auf der Registerkarte **Konfiguration** für einen globalen Cluster werden AWS-Regionen der Standort der Cluster, die Version und die globale Cluster-ID angezeigt.
**Topics**
+ [Ändern globaler Cluster](#global-clusters.modify)
+ [Parameter ändern](#global-clusters.modify-parameters)
+ [Globale Cluster werden entfernt](#global-clusters.remove)
+ [Löschen globaler Cluster](#global-clusters.delete)
+ [Headless-Cluster](#global-clusters.headless)
## Ändern eines globalen Amazon DocumentDB-Clusters
Auf der **Cluster-Seite** AWS-Managementkonsole werden alle Ihre globalen Cluster aufgeführt, wobei der primäre Cluster und die sekundären Cluster für jeden Cluster angezeigt werden. Der globale Cluster hat seine eigenen Konfigurationseinstellungen. Insbesondere gibt es Regionen, die seinen primären und sekundären Clustern zugeordnet sind.
Wenn Sie Änderungen am globalen Cluster vornehmen, haben Sie die Möglichkeit, Änderungen rückgängig zu machen.
Wenn Sie Weiter wählen, bestätigen Sie die Änderungen.
## Parameter eines globalen Amazon DocumentDB-Clusters ändern
Sie können die Cluster-Parametergruppen unabhängig für jeden Cluster innerhalb des globalen Clusters konfigurieren. Die meisten Parameter funktionieren genauso wie für andere Arten von Amazon DocumentDB-Clustern. Wir empfehlen, dass Sie die Einstellungen zwischen allen Clustern in einer globalen Datenbank konsistent halten. Dies hilft, unerwartete Verhaltensänderungen zu vermeiden, wenn Sie einen sekundären Cluster zum primären Cluster hochstufen.
Sie sollten z. B. die gleichen Einstellungen für Zeitzonen und Zeichensätze verwenden, um inkonsistentes Verhalten zu vermeiden, wenn ein anderer Cluster die Rolle des primären Clusters übernimmt.
## Entfernen eines Clusters aus einem globalen Amazon DocumentDB-Cluster
Es gibt mehrere Situationen, in denen Sie möglicherweise Cluster aus Ihrem globalen Cluster entfernen möchten. Beispielsweise möchten Sie möglicherweise einen Cluster aus einem globalen Cluster entfernen, wenn der primäre Cluster heruntergestuft oder isoliert wird. Er wird dann zu einem eigenständigen bereitgestellten Cluster, der zur Erstellung eines neuen globalen Clusters verwendet werden kann. Weitere Informationen hierzu finden Sie unter [Durchführen eines manuellen Failovers für einen globalen Amazon DocumentDB-Cluster](global-clusters-disaster-recovery.md#manual-failover).
Möglicherweise möchten Sie auch Cluster entfernen, weil Sie einen globalen Cluster löschen möchten, den Sie nicht mehr benötigen. Sie können den globalen Cluster erst löschen, nachdem Sie alle zugehörigen Cluster getrennt haben und den primären Cluster als letzten übrig lassen. Weitere Informationen finden Sie unter [Löschen eines Clusters aus einem globalen Amazon DocumentDB-Cluster](#global-clusters.delete).
**Anmerkung**
Wenn ein Cluster vom globalen Cluster getrennt wird, wird er nicht mehr mit dem primären Cluster synchronisiert. Er wird zu einem eigenständigen bereitgestellten Cluster mit vollem read/write Funktionsumfang. Darüber hinaus ist es in der Amazon DocumentDB DocumentDB-Konsole nicht mehr sichtbar. Es ist nur sichtbar, wenn Sie die Region in der Konsole auswählen, in der sich der Cluster befand.
Sie können Cluster mithilfe der AWS-Managementkonsole, der oder der RDS-API aus Ihrem globalen Cluster entfernen. AWS CLI
------
#### [ Using the AWS-Managementkonsole ]
1. Melden Sie sich bei der an AWS-Managementkonsole und navigieren Sie zur Amazon DocumentDB DocumentDB-Konsole.
1. Wählen Sie in der linken Navigationsleiste **Clusters** aus.
![\[Bild: Das Cluster-Navigationsfeld mit einer Liste vorhandener Cluster-Links und der entsprechenden Instance-Links.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. Erweitern Sie den globalen Cluster, sodass Sie alle sekundären Cluster sehen können. Wählen Sie die sekundären Cluster aus, die Sie entfernen möchten. Wählen Sie **Aktionen** und wählen Sie im Dropdownmenü die Option **Aus Global entfernen aus**.
![\[Bild: Das Cluster-Navigationsfeld zeigt die Auswahl eines vorhandenen sekundären Clusters und hebt die Aktion „Aus dem globalen Cluster entfernen“ hervor.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/remove-global.png)
1. Es wird eine Aufforderung angezeigt, in der Sie aufgefordert werden, zu bestätigen, dass Sie den sekundären Cluster vom globalen Cluster trennen möchten. Wählen Sie **Entfernen und heraufstufen**, um den Cluster aus dem globalen Cluster zu entfernen.
![\[Bild: Die Aufforderung zum Entfernen und Heraufstufen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/remove-promote.png)
Jetzt dient dieser Cluster nicht mehr als sekundärer Cluster und ist nicht mehr mit dem primären Cluster synchronisiert. Es handelt sich um einen eigenständigen Cluster mit voller read/write Kapazität.
Nachdem Sie alle sekundären Cluster entfernt oder gelöscht haben, können Sie den primären Cluster auf die gleiche Weise entfernen. Sie können den primären Cluster erst vom globalen Cluster trennen oder entfernen, nachdem Sie alle sekundären Cluster entfernt haben. Der globale Cluster verbleibt möglicherweise in der Clusterliste mit null Regionen und AZs. Sie können diesen globalen Cluster löschen, wenn Sie ihn nicht mehr verwenden möchten.
------
#### [ Using the AWS CLI ]
Um einen Cluster aus einem globalen Cluster zu entfernen, führen Sie den `remove-from-global-cluster` CLI-Befehl mit den folgenden Parametern aus:
+ `--global-cluster-identifier`— Der Name (Bezeichner) Ihres globalen Clusters.
+ `--db-cluster-identifier`— Der Name jedes Clusters, der aus dem globalen Cluster entfernt werden soll.
In den folgenden Beispielen wird zuerst ein sekundärer Cluster und dann der primäre Cluster aus einem globalen Cluster entfernt.
Für Linux, macOS oder Unix:
```
aws docdb --region secondary_region \
remove-from-global-cluster \
--db-cluster-identifier secondary_cluster_ARN \
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region \
remove-from-global-cluster \
--db-cluster-identifier primary_cluster_ARN \
--global-cluster-identifier global_cluster_id
```
Wiederholen Sie den `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` Befehl für jede sekundäre Region in Ihrem globalen Cluster.
Für Windows:
```
aws docdb --region secondary_region ^
remove-from-global-cluster ^
--db-cluster-identifier secondary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region ^
remove-from-global-cluster ^
--db-cluster-identifier primary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
```
Wiederholen Sie den `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` Befehl für jede sekundäre Region in Ihrem globalen Cluster.
------
## Löschen eines Clusters aus einem globalen Amazon DocumentDB-Cluster
Gehen Sie wie folgt vor, um einen globalen Cluster zu löschen:
+ Entfernen Sie alle sekundären Cluster aus dem globalen Cluster. Jeder Cluster wird zu einem eigenständigen Cluster. Siehe den vorherigen Abschnitt,[Entfernen eines Clusters aus einem globalen Amazon DocumentDB-Cluster](#global-clusters.remove).
+ Löschen Sie aus jedem eigenständigen Cluster alle Replikate.
+ Entfernen Sie den primären Cluster aus dem globalen Cluster. Dies wird zu einem eigenständigen Cluster.
+ Löschen Sie aus dem primären Cluster zuerst alle Replikate und dann die primäre Instanz. Wenn Sie die primäre Instanz aus dem neuen eigenständigen Cluster löschen, werden in der Regel auch der Cluster und der globale Cluster entfernt.
------
#### [ Using the AWS-Managementkonsole ]
1. Melden Sie sich bei der an AWS-Managementkonsole und navigieren Sie zur Amazon DocumentDB DocumentDB-Konsole.
1. Wählen Sie **Clusters** und suchen Sie den globalen Cluster, den Sie löschen möchten.
![\[Bild: Das Cluster-Navigationsfeld mit einer Liste vorhandener Cluster-Links und der entsprechenden Instance-Links.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. Wählen Sie Ihren globalen Cluster aus und wählen Sie im Menü **Aktionen** die Option **Löschen** aus.
![\[Bild: Das Cluster-Navigationsfeld zeigt die Auswahl eines globalen Clusters und hebt die Aktion „Löschen“ hervor.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/global-clusters/delete-cluster.png)
Vergewissern Sie sich, dass alle Cluster aus dem globalen Cluster entfernt wurden. Der globale Cluster sollte keine Regionen AZs und eine Größe von Null Clustern aufweisen. Wenn der globale Cluster Cluster enthält, können Sie ihn noch nicht löschen. Sie müssen zunächst den Anweisungen im vorherigen Schritt folgen, **[Entfernen eines Clusters aus einem globalen Amazon DocumentDB-Cluster](#global-clusters.remove)**.
------
#### [ Using the AWS CLI ]
Um einen globalen Cluster zu löschen, führen Sie den `delete-global-cluster` CLI-Befehl mit dem Namen des AWS-Region und der globalen Cluster-ID aus, wie im folgenden Beispiel gezeigt.
Für Linux, macOS oder Unix:
```
aws docdb --region primary_region delete-global-cluster \
--global-cluster-identifier global_cluster_id
```
Für Windows:
```
aws docdb --region primary_region delete-global-cluster ^
--global-cluster-identifier global_cluster_id
```
------
## Erstellen eines Headless-Amazon-DocumentDB-Clusters in einer sekundären Region
Obwohl ein globaler Amazon DocumentDB-Cluster mindestens einen sekundären Cluster in einem anderen AWS-Region als dem primären Cluster benötigt, können Sie für den sekundären Cluster eine Headless-Konfiguration verwenden. Ein kopfloser sekundärer Amazon DocumentDB-Cluster ist ein Cluster ohne Instance. Diese Art der Konfiguration kann die Kosten für einen globalen Cluster senken. In einem Amazon DocumentDB-Cluster sind Rechenleistung und Speicher entkoppelt. Ohne die Instance werden Ihnen keine Rechenleistung, sondern nur Speicherplatz in Rechnung gestellt. Wenn es korrekt eingerichtet ist, wird das Speichervolumen eines sekundären Headless-Clusters mit dem des primären Clusters synchronisiert.
Sie fügen den sekundären Cluster wie gewohnt hinzu, wenn Sie einen globalen Amazon DocumentDB-Cluster erstellen. Nachdem der primäre Cluster jedoch mit der Replikation auf den sekundären Cluster begonnen hat, löschen Sie die schreibgeschützte Instance aus dem sekundären Cluster. Dieser sekundäre Cluster gilt nun als „kopflos“, da er keine Instanz mehr hat. Das Speichervolumen wird jedoch mit dem primären Amazon DocumentDB-Cluster synchronisiert.
**Wichtig**
Wir empfehlen Headless-Cluster nur für Kunden, die regionsweite Ausfälle für mehr als 15 Minuten tolerieren können. Dies liegt daran, dass der Benutzer bei der Wiederherstellung nach einem regionsweiten Ausfall mit einem sekundären Headless-Cluster nach einem Failover eine neue Instanz erstellen muss. Es kann \$110-15 Minuten dauern, bis eine neue Instanz verfügbar ist.
### So fügen Sie Ihrem globalen Cluster einen sekundären Headless-Cluster hinzu
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon DocumentDB DocumentDB-Konsole](https://console.aws.amazon.com/rds/).
1. Wählen Sie in der linken Navigationsleiste **Clusters** aus.
1. Wählen Sie den globalen Cluster aus, der einen sekundären Cluster benötigt. Stellen Sie sicher, dass der primäre `Available` Cluster
1. Wählen Sie unter **Actions (Aktionen)** die Option **Add region (Region hinzufügen)** aus.
1. Wählen Sie auf der Seite „**Region hinzufügen**“ die sekundäre Region aus.
**Anmerkung**
Sie können keine Region auswählen, die bereits über einen sekundären Cluster für denselben globalen Cluster verfügt. Außerdem kann es sich nicht um dieselbe Region wie der primäre Cluster handeln.
1. Füllen Sie die verbleibenden Felder für den sekundären Cluster in der neuen Region aus. Dies sind dieselben Konfigurationsoptionen wie für jede Clusterinstanz.
1. Fügen Sie eine Region hinzu. Nachdem Sie die Region zu Ihrem globalen Cluster hinzugefügt haben, wird sie in der Liste von `Clusters` angezeigt AWS-Managementkonsole.
1. Überprüfen Sie den Status des sekundären Clusters und seiner Reader-Instance, bevor Sie fortfahren, indem Sie den Befehl AWS-Managementkonsole oder den verwenden AWS CLI. Hier ist ein Beispielbefehl, wenn Sie den folgenden Befehl verwenden AWS CLI:
```
$ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text
```
Es kann mehrere Minuten dauern, bis der Status eines neu hinzugefügten sekundären Clusters von „Wird erstellt“ auf „Verfügbar“ geändert wird. Wenn der Cluster verfügbar ist, können Sie die Reader-Instanz löschen.
1. Wählen Sie die Reader-Instanz im sekundären Cluster aus und klicken Sie dann auf **Löschen**.
1. Nach dem Löschen der Reader-Instanz bleibt der sekundäre Cluster Teil des globalen Clusters. Ihm sollte keine Instanz zugeordnet sein.
**Anmerkung**
Sie können diesen kopflosen sekundären Amazon DocumentDB-Cluster verwenden, um Ihren globalen Amazon DocumentDB-Cluster manuell nach einem ungeplanten Ausfall in der primären Region wiederherzustellen, falls ein solcher Ausfall auftritt.
# Stellen Sie eine Connect zu einem globalen Amazon DocumentDB-Cluster her
Wie Sie eine Verbindung zu einem globalen Cluster herstellen, hängt davon ab, ob Sie in den Cluster schreiben oder aus dem Cluster lesen müssen:
+ Für schreibgeschützte Anfragen oder Abfragen stellen Sie eine Verbindung zum Reader-Endpunkt für den Cluster in Ihrem her. AWS-Region
+ Stellen Sie zum Ausführen von Data Manipulation Language (DML)- und Data Definition Language (DDL)-Anweisungen eine Verbindung zum Cluster-Endpunkt des primären Clusters her. Dieser Endpunkt befindet sich möglicherweise in einer anderen Anwendung AWS-Region als Ihrer Anwendung.
Wenn Sie sich einen globalen Cluster in der Konsole ansehen, können Sie alle Allzweck-Endpunkte sehen, die mit all seinen Clustern verknüpft sind.
Wie Sie eine Verbindung zu einem globalen Cluster herstellen, hängt davon ab, ob Sie in die Datenbank schreiben oder aus der Datenbank lesen müssen. Für DDL-, DML- und Lesevorgänge, die Sie von der primären Region aus ausführen möchten, sollten Sie eine Verbindung zu Ihrem primären Cluster herstellen. Wir empfehlen, dass Sie eine Verbindung zu Ihrem primären Cluster herstellen, indem Sie den Cluster-Endpunkt im Replikatsatzmodus verwenden, mit der Lesepräferenz von. `secondaryPreferred=true` Dadurch wird der Schreibdatenverkehr an die Writer-Instance Ihres primären Clusters und der Lesetraffic an die Replikat-Instance Ihres primären Clusters weitergeleitet.
Für regionsübergreifenden, schreibgeschützten Datenverkehr sollten Sie eine Verbindung zu einem Ihrer sekundären Cluster herstellen. Wir empfehlen, dass Sie über den Cluster-Endpunkt im Replikatsatzmodus eine Verbindung zu Ihrem sekundären Cluster herstellen. Da es sich bei allen Instanzen um schreibgeschützte Replikatinstanzen handelt, müssen Sie keine Lesepräferenz angeben. Um die Latenz zu minimieren, wählen Sie den Reader-Endpunkt aus, der sich in Ihrer Region oder in der Region befindet, die Ihnen am nächsten ist.
# Überwachung globaler Amazon DocumentDB-Cluster
Amazon DocumentDB (mit MongoDB-Kompatibilität) lässt sich integrieren, CloudWatch sodass Sie Betriebsmetriken für Ihre Cluster sammeln und analysieren können. Sie können diese Metriken mit der CloudWatch Konsole, der Amazon DocumentDB DocumentDB-Konsole, der AWS Command Line Interface (AWS CLI) oder der CloudWatch API überwachen.
Verwenden Sie die folgenden CloudWatch Metriken, um einen globalen Cluster zu überwachen.
| Metrik | Description |
| --- | --- |
| GlobalClusterReplicatedWriteIO | Die durchschnittliche Anzahl der fakturierten I/O Schreibvorgänge, die vom Cluster-Volume im primären AWS-Region auf das Cluster-Volume in einem sekundären Cluster-Volume repliziert wurden AWS-Region, wird in Intervallen von 5 Minuten gemeldet. Die Anzahl der Replikationen in ReplicatedWriteIOs jede sekundäre Region entspricht der Anzahl der in der Region VolumeWriteIOPs durchgeführten Replikationen in der primären Region. |
| GlobalClusterDataTransferBytes | Die Datenmenge, die vom primären Cluster AWS-Region zu dem eines sekundären Clusters übertragen wird AWS-Region, gemessen in Byte. |
| GlobalClusterReplicationLag | Das Ausmaß der Verzögerung in Millisekunden bei der Replikation von Änderungsereignissen vom primären Cluster auf das eines sekundären Clusters AWS-Region AWS-Region |
[Weitere Informationen zum Anzeigen dieser Metriken finden Sie unter Daten anzeigen. CloudWatch ](https://docs.aws.amazon.com/documentdb/latest/developerguide/cloud_watch.html#cloud_watch-view_data)
# Disaster Recovery und globale Amazon DocumentDB-Cluster
**Topics**
+ [
## Durchführen eines verwalteten Failovers für einen globalen Amazon DocumentDB-Cluster
](#managed-failover)
+ [
## Durchführen eines manuellen Failovers für einen globalen Amazon DocumentDB-Cluster
](#manual-failover)
+ [
## Durchführen eines Switchovers für einen globalen Amazon DocumentDB-Cluster
](#global-cluster-switchover)
+ [
## Entsperren eines globalen Cluster-Switchovers oder -Failovers
](#unblocking-gc-so-fo)
Durch die Verwendung eines globalen Clusters können Sie nach Katastrophen wie regionalen Ausfällen schnell Daten wiederherstellen. Die Wiederherstellung nach einem Notfall wird in der Regel anhand von RTO- und RPO-Werten gemessen.
+ **Recovery Time Objective (RTO)** – Die Zeit, die ein System benötigt, um nach einem Notfall in einen arbeitsfähigen Zustand zurückzukehren. Mit anderen Worten: RTO misst die Ausfallzeit. Für einen globalen Cluster: RTO innerhalb von Minuten.
+ **Recovery Point Objective (RPO)** – Die Datenmenge, die verloren gehen kann (gemessen in Zeit). Für einen globalen Cluster wird RPO normalerweise in Sekunden gemessen.
+ Zur Wiederherstellung nach einem ungeplanten Ausfall können Sie ein regionsübergreifendes Failover zu einem der sekundären Cluster in Ihrem globalen Cluster durchführen. Wenn Ihr globaler Cluster über mehrere sekundäre Regionen verfügt, stellen Sie sicher, dass Sie alle sekundären Regionen, die Sie als primäre Regionen heraufstufen möchten, abtrennen. Anschließend stufen Sie eine dieser sekundären Regionen zur neuen Hauptregion herauf. AWS-Region Schließlich erstellen Sie in jeder der anderen sekundären Regionen neue Cluster und fügen diese Cluster Ihrem globalen Cluster hinzu.
## Durchführen eines verwalteten Failovers für einen globalen Amazon DocumentDB-Cluster
Dieser Ansatz dient der Geschäftskontinuität im Falle einer echten regionalen Katastrophe oder eines kompletten Service-Level-Ausfalls.
Während eines verwalteten Failovers wird Ihr primärer Cluster auf die sekundäre Region Ihrer Wahl umgestellt, während die bestehende Replikationstopologie Ihres globalen Amazon DocumentDB-Clusters beibehalten wird. Der gewählte sekundäre Cluster stuft einen seiner schreibgeschützten Knoten auf vollen Writer-Status herauf. In diesem Schritt kann der Cluster die Rolle des primären Clusters übernehmen. Ihre Datenbank ist für kurze Zeit nicht verfügbar, während dieser Cluster seine neue Rolle annimmt. Daten, die nicht vom alten primären auf den ausgewählten sekundären Cluster repliziert wurden, fehlen möglicherweise, wenn dieser sekundäre zum neuen primären Cluster wird. Das alte primäre Volume versucht nach besten Kräften, vor der Synchronisierung mit dem neuen primären Volume einen Snapshot zu erstellen, sodass nicht replizierte Daten auf dem Snapshot erhalten bleiben.
**Anmerkung**
Sie können ein verwaltetes regionsübergreifendes Cluster-Failover auf einem globalen Amazon DocumentDB-Cluster nur durchführen, wenn der primäre und alle sekundären Cluster dieselben Engine-Versionen haben. Wenn Ihre Engine-Versionen nicht kompatibel sind, können Sie das Failover manuell durchführen, indem Sie die Schritte unter [Durchführen eines manuellen Failovers für einen globalen Amazon DocumentDB-Cluster](#manual-failover) ausführen.
Wenn die Engine-Versionen der Region nicht übereinstimmen, wird der Failover blockiert. Bitte suchen Sie nach ausstehenden Upgrades und wenden Sie sie an, um sicherzustellen, dass die Engine-Versionen aller Regionen übereinstimmen und der globale Cluster-Failover entsperrt ist. Weitere Informationen finden Sie unter [Entsperren eines globalen Cluster-Switchovers oder -Failovers](#unblocking-gc-so-fo).
Um Datenverlust zu minimieren, empfehlen wir Ihnen, vor der Verwendung dieser Funktion Folgendes zu tun:
+ Schalten Sie Anwendungen offline, um zu verhindern, dass Schreibvorgänge an den primären Cluster des globalen Amazon DocumentDB-Clusters gesendet werden.
+ Überprüfen Sie die Verzögerungszeiten für alle sekundären Amazon DocumentDB-Cluster. Durch die Auswahl der sekundären Region mit der geringsten Replikationsverzögerung kann der Datenverlust in der aktuell ausgefallenen primären Region minimiert werden. Überprüfen Sie die Verzögerungszeiten für alle sekundären Amazon DocumentDB-Cluster im globalen Cluster, indem Sie sich die `GlobalClusterReplicationLag` Metrik in Amazon CloudWatch ansehen. Diese Metriken zeigen Ihnen, wie weit (in Millisekunden) die Replikation auf einen sekundären Cluster auf den primären Cluster zurückliegt.
Weitere Informationen zu CloudWatch Metriken für Amazon DocumentDB finden Sie unter[Amazon DocumentDB-Metriken](cloud_watch.md#cloud_watch-metrics_list).
Während eines verwalteten Failovers wird dem ausgewählten sekundären Cluster seine neue Rolle als primärer Cluster zugewiesen. Er erbt jedoch nicht die verschiedenen Konfigurationsoptionen des primären Clusters. Wenn die Konfiguration nicht übereinstimmt, kann dies Leistungsprobleme, Workload-Inkompatibilitäten und anderes anomales Verhalten zur Folge haben. Um solche Probleme zu vermeiden, empfehlen wir Ihnen, die Unterschiede zwischen Ihren globalen Amazon DocumentDB-Clustern für Folgendes zu beheben:
+ **Konfigurieren Sie bei Bedarf eine Amazon DocumentDB-Cluster-Parametergruppe für den neuen Primärserver** — Sie können Ihre Amazon DocumentDB-Cluster-Parametergruppen unabhängig für jeden Cluster in Ihrem globalen Amazon DocumentDB-Cluster konfigurieren. Wenn Sie also einen sekundären Cluster zur Übernahme der primären Rolle heraufstufen, wird die Parametergruppe aus dem sekundären Cluster möglicherweise anders konfiguriert als für den primären. Falls ja, ändern Sie die Parametergruppe des hochgestuften sekundären Clusters so, dass sie den Einstellungen Ihres primären Clusters entspricht. Um zu erfahren wie dies geht, vgl. [Amazon DocumentDB-Cluster-Parametergruppen ändern](cluster_parameter_groups-modify.md).
+ **Überwachungstools und -optionen wie CloudWatch Amazon-Ereignisse und -Alarme** konfigurieren — Konfigurieren Sie den beworbenen Cluster mit denselben Protokollierungsfunktionen, Alarmen usw., wie es für den globalen Cluster erforderlich ist. Wie bei Parametergruppen wird die Konfiguration für diese Funktionen während des Failover-Prozesses nicht vom primären Cluster übernommen. Einige CloudWatch Metriken, wie z. B. die Verzögerung bei der Replikation, sind nur für sekundäre Regionen verfügbar. Daher ändert ein Failover die Art und Weise, wie diese Metriken angezeigt und Alarme für sie eingerichtet werden, und es können Änderungen an allen vordefinierten Dashboards erforderlich sein. Weitere Informationen zu Amazon DocumentDB-Clustern und deren Überwachung finden Sie unter[Überwachung von Amazon DocumentDB](monitoring_docdb.md).
In der Regel übernimmt der gewählte sekundäre Cluster innerhalb einer Minute die primäre Rolle. Sobald der Writer-Knoten der neuen primären Region verfügbar ist, können Sie Ihre Anwendungen mit diesem verbinden und Ihre Workloads fortsetzen. Nachdem Amazon DocumentDB den neuen primären Cluster hochgestuft hat, erstellt es automatisch alle zusätzlichen sekundären Regionscluster neu.
Da globale Amazon DocumentDB-Cluster asynchrone Replikation verwenden, kann die Replikationsverzögerung in jeder sekundären Region variieren. Amazon DocumentDB erstellt diese sekundären Regionen neu, sodass sie genau dieselben point-in-time Daten wie der neue Cluster für die primäre Region haben. Die Dauer der vollständigen Neuerstellungsaufgabe kann je nach Größe des Speichervolumens und der Entfernung zwischen den Regionen einige Minuten bis mehrere Stunden dauern. Wenn der Wiederaufbau der Cluster der sekundären Region aus der neuen primären Region abgeschlossen ist, stehen sie für den Lesezugriff zur Verfügung. Sobald der neue primäre Writer beworben und verfügbar ist, kann der Cluster der neuen primären Region Lese- und Schreibvorgänge für den globalen Amazon DocumentDB-Cluster abwickeln.
Um die ursprüngliche Topologie des globalen Clusters wiederherzustellen, überwacht Amazon DocumentDB die Verfügbarkeit der alten primären Region. Sobald diese Region fehlerfrei und wieder verfügbar ist, fügt Amazon DocumentDB sie automatisch wieder als sekundäre Region zum globalen Cluster hinzu. Bevor das neue Speichervolume in der alten primären Region erstellt wird, versucht Amazon DocumentDB, zum Zeitpunkt des Fehlers einen Snapshot des alten Speichervolumes zu erstellen. Auf diese Weise können Sie alle fehlenden Daten wiederherstellen. Wenn dieser Vorgang erfolgreich ist, platziert Amazon DocumentDB diesen Snapshot mit dem Namen „rds: docdb-unplanned-global-failover - name-of-old-primary -DB-Cluster-timestamp“ im Snapshot-Abschnitt von. AWS-Managementkonsole Sie können diesen Snapshot auch in den Informationen sehen, die von der API-Operation zurückgegeben werden. `DescribeDBClusterSnapshots`
**Anmerkung**
Der Snapshot des alten Speichervolumes ist ein System-Snapshot, der der auf dem alten primären Cluster konfigurierten Aufbewahrungsfrist für Backups unterliegt. Um diesen Snapshot außerhalb des Aufbewahrungszeitraums zu speichern, können Sie ihn kopieren, um ihn als manuellen Snapshot zu speichern. Weitere Informationen zum Kopieren von Snapshots, einschließlich der Preise, finden Sie unter [Einen Cluster-Snapshot kopieren](backup_restore-copy_cluster_snapshot.md#backup_restore-copy_a_cluster_snapshot).
Nachdem die ursprüngliche Topologie wiederhergestellt ist, können Sie Ihr globales Cluster auf die ursprüngliche primäre Region zurückführen, indem Sie einen Switchover-Vorgang durchführen, wenn dies für Ihr Unternehmen und Ihre Arbeitslast am sinnvollsten ist. Eine Schritt-für-Schritt-Anleitung hierzu finden Sie unter [Durchführen eines Switchovers für einen globalen Amazon DocumentDB-Cluster](#global-cluster-switchover).
Sie können ein Failover Ihres globalen Amazon DocumentDB-Clusters mithilfe der AWS-Managementkonsole, der oder der Amazon DocumentDB DocumentDB-API durchführen. AWS CLI
------
#### [ Using the AWS-Managementkonsole ]
**Führen Sie ein verwaltetes Failover auf Ihrem globalen Amazon DocumentDB-Cluster durch**
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. Klicken Sie im Navigationsbereich auf **Cluster**.
1. Suchen Sie den globalen Amazon DocumentDB-Cluster, für den Sie ein Failover durchführen möchten, und wählen Sie ihn aus.
![\[Bild: Cluster-Tabelle mit ausgewähltem globalen Cluster.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/failover-cluster-table.png)
1. Wählen Sie im ****Aktionsmenü** Switchover oder Failover** aus.
1. Wählen Sie im daraufhin angezeigten Dialogfeld **Failover** und dann den sekundären Cluster aus der Dropdownliste **Neues primäres Clusterfeld** aus.
![\[Bild: Globales Cluster-Switchover- oder Failover-Dialogfeld.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/switch-fail-confirm.png)
1. Geben Sie „Bestätigen“ in das letzte Feld ein. Wählen Sie dann **Confirm** (Bestätigen) aus.
Der Status des primären Clusters ändert sich in "**Failing-over**“. Dieser Zustand sollte ungefähr eine Minute dauern. Während dieser Zeit zeigt der Status des neuen primären Clusters "Wird **geändert...** “. Sobald der neue Primärserver hochgestuft wurde, wird dort "**Verfügbar**" angezeigt und er kann Lese- und Schreibtransaktionen ausführen. In den sekundären Regionen, einschließlich der alten Primärregion, wird "**Resyncing...** angezeigt ", während es mit dem neuen primären System erneut synchronisiert wird. Ähnlich wie bei der neuen primären Version kann die Transaktion erst ausgeführt werden, wenn sich der Status auf "**Verfügbar**" ändert.
1. Wenn der Vorgang abgeschlossen ist, wird der ursprüngliche primäre Cluster zum sekundären Cluster. Der ausgewählte sekundäre Cluster wird zum primären Cluster.
![\[Bild: Cluster-Tabelle mit dem neuen primären Cluster.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Führen Sie ein verwaltetes Failover auf Ihrem globalen Amazon DocumentDB-Cluster durch**
Führen Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html)CLI-Befehl aus, um ein Failover für Ihren globalen Amazon DocumentDB-Cluster durchzuführen. Übergeben Sie mit dem Befehl Werte für die folgenden Optionen:
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
+ `--allow-data-loss`
Ersetzen Sie in den folgenden Beispielen jedes *user input placeholder* durch die Informationen Ihres Clusters.
Für Linux, macOS oder Unix:
```
aws docdb failover-global-cluster \
--region region_of_selected_secondary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote \
--allow-data-loss
```
Für Windows:
```
aws docdb failover-global-cluster ^
--region region_of_selected_secondary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote ^
--allow-data-loss
```
------
## Durchführen eines manuellen Failovers für einen globalen Amazon DocumentDB-Cluster
Wenn ein ganzer Cluster in einem Cluster nicht AWS-Region mehr verfügbar ist, können Sie einen anderen Cluster im globalen Cluster so heraufstufen, dass er über read/write Kapazitäten verfügt.
Sie können den globalen Cluster-Failover-Mechanismus manuell aktivieren, wenn ein Cluster in einem anderen Cluster die bessere Wahl als primärer Cluster AWS-Region ist. Sie können beispielsweise die Kapazität eines sekundären Clusters erhöhen und diesen Cluster dann zum primären Cluster hochstufen. Oder das Gleichgewicht zwischen den Aktivitäten AWS-Regionen könnte sich ändern, sodass ein Wechsel des primären Clusters zu einem anderen zu einer geringeren Latenz bei Schreibvorgängen führen AWS-Region kann.
Das folgende Verfahren beschreibt, wie Sie einen der sekundären Cluster in einem globalen Amazon DocumentDB-Cluster bewerben können.
Um einen sekundären Cluster heraufzustufen:
1. Beenden Sie die Ausgabe von DML-Anweisungen und anderen Schreibvorgängen an den primären Cluster während des AWS-Region Ausfalls.
1. Identifizieren Sie einen Cluster aus einem sekundären Cluster AWS-Region , der als neuer primärer Cluster verwendet werden soll. Wenn Sie zwei (oder mehr) sekundäre Cluster AWS-Regionen in Ihrem globalen Cluster haben, wählen Sie den sekundären Cluster mit der geringsten Verzögerungszeit aus.
1. Trennen Sie den ausgewählten sekundären Cluster vom globalen Cluster.
Wenn Sie einen sekundären Cluster aus einem globalen Cluster entfernen, wird die Replikation vom primären auf diesen sekundären Cluster sofort beendet und der Cluster wird zu einem eigenständigen, bereitgestellten Cluster mit vollem read/write Funktionsumfang heraufgestuft. Alle anderen sekundären Cluster, die dem primären Cluster in der Region zugeordnet sind, in der der Ausfall aufgetreten ist, sind weiterhin verfügbar und können Anrufe von Ihrer Anwendung annehmen. Sie verbrauchen auch Ressourcen. Da Sie den globalen Cluster neu erstellen, sollten Sie zur Vermeidung von Split-Brain- und anderen Problemen die anderen sekundären Cluster entfernen, bevor Sie den neuen globalen Cluster in den folgenden Schritten erstellen.
Ausführliche Schritte zum Trennen finden Sie unter [Entfernen eines Clusters aus einem globalen Amazon DocumentDB-Cluster](global-clusters.manage.md#global-clusters.remove).
1. Dieser Cluster wird zum primären Cluster eines neuen globalen Clusters, wenn Sie im nächsten Schritt damit beginnen, ihm Regionen hinzuzufügen.
1. Fügen Sie AWS-Region dem Cluster eine hinzu. Wenn Sie dies tun, beginnt der Replikationsprozess vom primären zum sekundären Cluster.
1. Fügen Sie nach AWS-Regionen Bedarf weitere hinzu, um die Topologie neu zu erstellen, die zur Unterstützung Ihrer Anwendung erforderlich ist. Stellen Sie sicher, dass Anwendungsschreibvorgänge vor, während und nach solchen Änderungen an den richtigen Cluster gesendet werden, um Dateninkonsistenzen zwischen den Clustern im globalen Cluster zu vermeiden (Split-Brain-Probleme).
1. Wenn der Ausfall behoben ist und Sie bereit sind, Ihren ursprünglichen Cluster wieder AWS-Region als primären Cluster zuzuweisen, führen Sie dieselben Schritte in umgekehrter Reihenfolge durch.
1. Entfernen Sie einen der sekundären Cluster aus dem globalen Cluster. Dadurch kann er read/write Datenverkehr bereitstellen.
1. Leiten Sie den gesamten Schreibverkehr auf den primären Cluster im Original um AWS-Region.
1. Fügen Sie einen hinzu AWS-Region , um einen oder mehrere sekundäre Cluster AWS-Region wie zuvor einzurichten.
Globale Amazon DocumentDB-Cluster können mithilfe von Amazon DocumentDB verwaltet werden AWS SDKs, sodass Sie Lösungen zur Automatisierung des globalen Cluster-Failover-Prozesses für Anwendungsfälle wie Disaster Recovery und Business Continuity Planning erstellen können. [Eine solche Lösung wird unseren Kunden unter der Apache 2.0-Lizenz zur Verfügung gestellt und kann hier in unserem Tool-Repository abgerufen werden.](https://github.com/awslabs/amazon-documentdb-tools/tree/master/global-clusters-automation) Diese Lösung nutzt Amazon Route 53 für das Endpunktmanagement und bietet AWS Lambda Funktionen, die auf der Grundlage geeigneter Ereignisse ausgelöst werden können.
## Durchführen eines Switchovers für einen globalen Amazon DocumentDB-Cluster
Mithilfe von Umstellungen können Sie die Region Ihres primären Clusters routinemäßig ändern. Dieser Ansatz ist für kontrollierte Szenarien gedacht, z. B. für betriebliche Wartungen und andere geplante Betriebsverfahren.
Es gibt drei gängige Anwendungsfälle für die Verwendung von Switchovers:
+ Für Anforderungen an die „regionale Rotation“, die in bestimmten Branchen gelten. Beispielsweise könnten die Vorschriften für Finanzdienstleistungen vorschreiben, dass Tier-0-Systeme für mehrere Monate in eine andere Region wechseln müssen, um sicherzustellen, dass die Notfallwiederherstellungsverfahren regelmäßig geübt werden.
+ Für "follow-the-sun" -Anwendungen mit mehreren Regionen. Beispielsweise möchte ein Unternehmen möglicherweise Schreibvorgänge mit niedrigerer Latenz in verschiedenen Regionen bereitstellen, basierend auf den Geschäftszeiten in verschiedenen Zeitzonen.
+ Als zero-data-loss Methode, um nach einem Failover zur ursprünglichen primären Region zurückzukehren.
**Anmerkung**
Switchover sind für die Verwendung in einem gesunden globalen Amazon DocumentDB-Cluster konzipiert. Folgen Sie zur Wiederherstellung nach einem ungeplanten Ausfall dem entsprechenden Verfahren unter [Durchführen eines manuellen Failovers für einen globalen Amazon DocumentDB-Cluster](#manual-failover).
Um einen Switchover durchzuführen, müssen in allen sekundären Regionen exakt dieselbe Engine-Version wie in der primären Region ausgeführt werden. Wenn die Engine-Versionen der Region nicht übereinstimmen, wird der Switchover blockiert. Bitte suchen Sie nach ausstehenden Upgrades und wenden Sie sie an, um sicherzustellen, dass die Engine-Versionen aller Regionen übereinstimmen und der globale Cluster-Switchover entsperrt ist. Weitere Informationen finden Sie unter [Entsperren eines globalen Cluster-Switchovers oder -Failovers](#unblocking-gc-so-fo).
Während eines Switchovers wechselt Amazon DocumentDB Ihren primären Cluster in die von Ihnen gewählte sekundäre Region, während die bestehende Replikationstopologie Ihres globalen Clusters beibehalten wird. Bevor der Switchover-Prozess gestartet wird, wartet Amazon DocumentDB, bis alle Cluster der sekundären Region vollständig mit dem Cluster der primären Region synchronisiert sind. Dann wird der DB-Cluster in der primären Region schreibgeschützt, und der ausgewählte sekundäre Cluster stuft einen seiner schreibgeschützten Knoten auf vollen Writer-Status hoch. Durch die Heraufstufung dieses Knotens zu einem Writer kann dieser sekundäre Cluster die Rolle des primären Clusters übernehmen. Da alle sekundären Cluster zu Beginn des Prozesses mit dem primären synchronisiert wurden, setzt der neue primäre Cluster den Betrieb für den globalen Amazon DocumentDB-Cluster fort, ohne Daten zu verlieren. Ihre Datenbank ist für kurze Zeit nicht verfügbar, während der primäre und der ausgewählte sekundäre Cluster ihre neuen Rollen übernehmen.
Um die Anwendungsverfügbarkeit zu optimieren, empfehlen wir Ihnen, vor der Verwendung dieser Funktion Folgendes zu tun:
+ Führen Sie diesen Vorgang außerhalb der Spitzenzeiten oder zu einem anderen Zeitpunkt durch, zu dem die Schreibvorgänge auf den primären Cluster minimal sind.
+ Schalten Sie Anwendungen offline, um zu verhindern, dass Schreibvorgänge an den primären Cluster des globalen Amazon DocumentDB-Clusters gesendet werden.
+ Überprüfen Sie die Verzögerungszeiten für alle sekundären Amazon DocumentDB-Cluster im globalen Cluster, indem Sie sich die `GlobalClusterReplicationLag` Metrik in Amazon CloudWatch ansehen. Diese Metrik zeigt Ihnen, wie weit (in Millisekunden) die Replikation auf einen sekundären Cluster auf den primären Cluster zurückliegt. Dieser Wert ist direkt proportional zu der Zeit, die Amazon DocumentDB benötigt, um den Switchover abzuschließen. Je größer der Verzögerungswert, desto länger dauert die Umstellung.
Weitere Informationen zu CloudWatch Metriken für Amazon DocumentDB finden Sie unter[Amazon DocumentDB-Metriken](cloud_watch.md#cloud_watch-metrics_list).
Während einer Umstellung wird der ausgewählte sekundäre DB-Cluster in seine neue Rolle als primärer Cluster hochgestuft. Er übernimmt jedoch nicht die verschiedenen Konfigurationsoptionen des primären DB-Clusters. Wenn die Konfiguration nicht übereinstimmt, kann dies Leistungsprobleme, Workload-Inkompatibilitäten und anderes anomales Verhalten zur Folge haben. Um solche Probleme zu vermeiden, empfehlen wir Ihnen, die Unterschiede zwischen Ihren globalen Amazon DocumentDB-Clustern für Folgendes zu beheben:
+ **Konfigurieren Sie die Amazon DocumentDB-DB-Cluster-Parametergruppe für den neuen Primärserver, falls erforderlich** — Sie können Ihre Amazon DocumentDB-Cluster-Parametergruppen unabhängig für jeden Cluster in Ihrem globalen Amazon DocumentDB-Cluster konfigurieren. Wenn Sie also einen sekundären DB-Cluster zur Übernahme der primären Rolle hochstufen, kann die Parametergruppe des sekundären Clusters im Vergleich zum primären Cluster möglicherweise anders konfiguriert werden. Ist dies der Fall, ändern Sie die Parametergruppe des hochgestuften sekundären DB-Clusters so, dass sie den Einstellungen des primären Clusters entspricht. Um zu erfahren wie, siehe [Verwaltung von Amazon DocumentDB-Cluster-Parametergruppen](cluster_parameter_groups.md).
+ **Überwachungstools und -optionen wie Amazon CloudWatch Events und Alarme** konfigurieren — Konfigurieren Sie den beworbenen Cluster mit den gleichen Protokollierungsfunktionen, Alarmen usw., wie es für den globalen Cluster erforderlich ist. Wie bei Parametergruppen wird die Konfiguration für diese Funktionen während der Umstellung nicht vom primären Cluster übernommen. Einige CloudWatch Metriken, wie z. B. die Verzögerung bei der Replikation, sind nur für primäre Regionen verfügbar. Daher ändert sich bei einer Umstellung die Art und Weise, wie diese Metriken angezeigt und Alarme für sie eingerichtet werden, und es können Änderungen an allen vordefinierten Dashboards erforderlich sein. Weitere Informationen finden Sie unter [Überwachung von Amazon DocumentDB](monitoring_docdb.md).
**Anmerkung**
In der Regel kann der Rollenwechsel bis zu mehreren Minuten dauern.
Wenn der Switchover-Prozess abgeschlossen ist, kann der beworbene Amazon DocumentDB-Cluster Schreibvorgänge für den globalen Cluster verarbeiten.
Sie können Ihren globalen Amazon DocumentDB-Cluster mit dem AWS-Managementkonsole oder dem AWS CLI folgenden Befehl umschalten:
------
#### [ Using the AWS-Managementkonsole ]
**Führen Sie einen Switchover auf Ihrem globalen Amazon DocumentDB-Cluster durch**
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. Klicken Sie im Navigationsbereich auf **Cluster**.
1. Suchen Sie den globalen Amazon DocumentDB-Cluster, zu dem Sie wechseln möchten, und wählen Sie ihn aus.
![\[Bild: Cluster-Tabelle mit ausgewähltem globalen Cluster.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/switchover-cluster-table.png)
1. Wählen Sie im ****Aktionsmenü** Switchover oder Failover** aus.
1. Wählen Sie im daraufhin angezeigten Dialogfeld **Switchover** und dann den sekundären Cluster aus der Dropdownliste **Neues primäres Clusterfeld** aus.
![\[Bild: Cluster-Switchover-Dialog mit ausgewähltem sekundärem Cluster.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/switch-fail-confirm-2.png)
1. Wählen Sie **Bestätigen** aus.
Der Status des primären Clusters ändert sich in "**Switching-over**“. Dieser Zustand sollte ungefähr drei Minuten dauern. Während dieser Zeit zeigt der Status aller regionalen Cluster "Wird **geändert...** “. Sobald die Regionen synchronisiert sind und die neue Primärregion beworben wurde, wird in allen Statusfeldern „**Verfügbar**“ angezeigt und Transaktionen können bearbeitet werden.
1. Wenn der Vorgang abgeschlossen ist, wird der ursprüngliche primäre Cluster zum sekundären Cluster. Der ausgewählte sekundäre Cluster wird zum primären Cluster.
![\[Bild: Cluster-Tabelle mit dem neuen primären Cluster.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Führen Sie einen Switchover auf Ihrem globalen Amazon DocumentDB-Cluster durch**
Führen Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html)CLI-Befehl aus, um Ihren globalen Amazon DocumentDB-Cluster umzuschalten. Übergeben Sie mit dem Befehl Werte für die folgenden Optionen:
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
Ersetzen Sie in den folgenden Beispielen jedes *user input placeholder* durch die Informationen Ihres Clusters.
Für Linux, macOS oder Unix:
```
aws docdb switchover-global-cluster \
--region region_of_primary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote
```
Für Windows:
```
aws docdb switchover-global-cluster ^
--region region_of_primary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote
```
------
## Entsperren eines globalen Cluster-Switchovers oder -Failovers
Globale Cluster-Switchover und -Failover werden blockiert, wenn sich nicht alle regionalen Cluster im globalen Cluster auf derselben Engine-Version befinden. Wenn die Versionen nicht übereinstimmen, wird beim Aufrufen eines Switchovers oder Failovers möglicherweise dieser Fehler angezeigt: Auf dem angegebenen Ziel-DB-Cluster wird eine Engine-Version mit einem anderen Patch-Level ausgeführt als auf dem Quell-DB-Cluster. Wir empfehlen, routinemäßig die neuesten Engine-Versionen zu installieren, um sicherzustellen, dass Sie die neuesten Updates ausführen, damit Ihre globalen Cluster in einem fehlerfreien Zustand bleiben.
Um diesen Fehler zu beheben, aktualisieren Sie bitte zuerst alle sekundären Regionen und dann die primäre Region auf dieselbe Engine-Version, indem Sie alle ausstehenden Wartungsmaßnahmen anwenden. Führen Sie die Anweisungen auf einer der folgenden Registerkarten aus, um ausstehende Wartungsmaßnahmen anzuzeigen und die zur Behebung des Problems erforderlichen Änderungen vorzunehmen:
------
#### [ Using the AWS-Managementkonsole ]
Um die Blockierung eines globalen Cluster-Switchovers oder -Failovers aufzuheben, müssen Sie feststellen, ob noch Wartungsaktionen für Ihre Cluster ausstehen, und diese anwenden. Gehen Sie wie folgt vor, um Wartungsaktionen anzuzeigen und anzuwenden:
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. Klicken Sie im Navigationsbereich auf **Cluster**.
1. Suchen Sie in der **Cluster-Tabelle** in der Spalte Cluster-ID nach Ihrem globalen **Cluster**. Notieren Sie sich unter Ihrem globalen Cluster jeden sekundären Cluster und den primären Cluster für den jeweiligen globalen Cluster und führen Sie für jeden Cluster die folgenden Schritte aus.
1. Für jeden sekundären Cluster:
1. Wenn ein Update für Ihren Cluster verfügbar ist, wird es in der Spalte **Wartung** als **Verfügbar**, **Erforderlich** oder **Nächstes Fenster** angezeigt.
1. Um eine Aktion auszuführen, wählen Sie den Cluster aus, dessen Details angezeigt werden sollen, und wählen Sie dann **Wartung und Backups** aus. Die Einträge **„Ausstehende Wartung**“ werden angezeigt.
1. Wenn unter **Beschreibung** angezeigt wird, dass ein „Neues Wartungsupdate verfügbar ist“, wählen Sie es aus und klicken Sie dann **auf Jetzt anwenden**.
1. Für Ihren primären Cluster:
1. Wenn ein Update für Ihren Cluster verfügbar ist, wird es in der Spalte **Wartung** als **Verfügbar**, **Erforderlich** oder **Nächstes Fenster** angezeigt.
1. Um eine Aktion auszuführen, wählen Sie den Cluster aus, dessen Details angezeigt werden sollen, und wählen Sie dann **Wartung und Backups** aus. Die Einträge **„Ausstehende Wartung**“ werden angezeigt.
1. Wenn unter **Beschreibung** angezeigt wird, dass ein „Neues Wartungsupdate verfügbar ist“, wählen Sie es aus und klicken Sie dann **auf Jetzt anwenden**.
------
#### [ Using the AWS CLI ]
Um die Blockierung eines globalen Cluster-Switchovers oder -Failovers aufzuheben, müssen Sie feststellen, ob noch Wartungsaktionen für den Cluster ausstehen, und diese anwenden. Gehen Sie wie folgt vor, um Wartungsaktionen zunächst auf den sekundären Clustern und dann auf dem primären Cluster für Ihren globalen Cluster anzuzeigen und anzuwenden:
1. Führen Sie Folgendes zuerst für den regionalen Cluster jeder sekundären Region und dann für den regionalen Cluster der primären Regionen aus.
1. Führen Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)CLI-Befehl mit der `--resource-identifier` Option aus, um festzustellen, ob Wartungsaktionen für Ihren regionalen Amazon DocumentDB-Cluster verfügbar sind.
Ersetzen Sie in den folgenden Beispielen jedes *user input placeholder* durch die Informationen Ihres Clusters.
Für Linux, macOS oder Unix:
```
aws docdb describe-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
Für Windows:
```
aws docdb describe-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
Das Ergebnis sieht in etwa so aus:
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"CurrentApplyDate": "2025-04-11T03:01:00Z",
"Description": "db-version-upgrade",
"ForcedApplyDate": "2025-06-18T03:01:00Z",
"AutoAppliedAfterDate": "2025-05-11T03:01:00Z"
"OptInStatus": "pending"
}
]
}
]
}
```
1. Wenn eine Wartungsaktion erforderlich ist, führen Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html)CLI-Befehl mit den folgenden Optionen aus:
+ `--resource-identifier`
+ `--apply-action`
+ `--opt-in-type`
+ `--region`
Ersetzen Sie in den folgenden Beispielen jedes Beispiel *user input placeholder* durch die Informationen Ihres Clusters.
Für Linux, macOS oder Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 \
--apply-action system-update \
--opt-in-type immediate \
--region us-east-1
```
Für Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ^
--apply-action system-update ^
--opt-in-type immediate ^
--region us-east-1
```
1. Sobald die Wartungsaktion abgeschlossen ist, führen Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)Befehl erneut aus, um sicherzustellen, dass keine weiteren Aktionen für Ihren Cluster ausstehen.
Das gewünschte Ergebnis ist:
```
{
"PendingMaintenanceActions": []
}
```
------
#### [ Using the Amazon DocumentDB API ]
Um die Blockierung eines globalen Cluster-Switchovers oder -Failovers aufzuheben, müssen Sie feststellen, ob noch Wartungsaktionen für den Cluster ausstehen, und diese anwenden. Gehen Sie wie folgt vor APIs , um Wartungsaktionen anzuzeigen und anzuwenden:
1. Führen Sie den folgenden Befehl zuerst für den regionalen Cluster jeder sekundären Region und dann für den regionalen Cluster der primären Regionen aus.
1. Rufen Sie die [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html)API auf, um festzustellen, ob Wartungsaktionen für Ihren globalen Amazon DocumentDB-Cluster verfügbar sind.
1. Wenden Sie alle Änderungen an, indem Sie die [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html)API aufrufen.
------