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.
# Aktualisieren Ihres Amazon DocumentDB-Clusters mit AWS Database Migration Service
**Wichtig**
Amazon DocumentDB folgt nicht denselben Support-Lebenszyklen wie MongoDB und der end-of-life Zeitplan von MongoDB gilt nicht für Amazon DocumentDB.
Sie können Ihren Amazon DocumentDB-Cluster mit minimaler Ausfallzeit auf eine höhere Version aktualisieren, indem Sie AWS DMS. AWS DMS ist ein vollständig verwalteter Service, der die Migration von älteren Amazon DocumentDB DocumentDB-Versionen, relationalen Datenbanken und nicht-relationalen Datenbanken zu Ihrem Amazon DocumentDB DocumentDB-Zielcluster erleichtert.
**Topics**
+ [Schritt 1: Change Streams aktivieren](#docdb-migration.versions-step1)
+ [Schritt 2: Ändern Sie die Aufbewahrungsdauer für Change-Streams](#docdb-migration.versions-step2)
+ [Schritt 3: Migrieren Sie Ihre Indizes](#docdb-migration.versions-step3)
+ [Schritt 4: Erstellen Sie eine AWS DMS Replikationsinstanz](#docdb-migration.versions-step4)
+ [Schritt 5: Erstellen Sie einen AWS DMS Quellendpunkt](#docdb-migration.versions-step5)
+ [Schritt 6: Erstellen Sie einen AWS DMS Zielendpunkt](#docdb-migration.versions-step6)
+ [Schritt 7: Erstellen Sie eine Migrationsaufgabe und führen Sie sie aus](#docdb-migration.versions-step7)
+ [Schritt 8: Ändern des Anwendungsendpunkts auf den Amazon DocumentDB DocumentDB-Zielcluster](#docdb-migration.versions-step8)
## Schritt 1: Change Streams aktivieren
Um eine Migration mit minimalen Ausfallzeiten durchzuführen, ist Zugriff auf die Change-Streams des Clusters AWS DMS erforderlich. [Amazon DocumentDB DocumentDB-Change-Streams](https://docs.aws.amazon.com/documentdb/latest/developerguide/change_streams.html#change_streams-enabling) bieten eine zeitlich geordnete Abfolge von Aktualisierungsereignissen, die in den Sammlungen und Datenbanken Ihres Clusters auftreten. Das Lesen aus dem Change-Stream ermöglicht es AWS DMS , Change Data Capture (CDC) durchzuführen und inkrementelle Aktualisierungen auf den Amazon DocumentDB DocumentDB-Zielcluster anzuwenden.
Um Change-Streams für alle Sammlungen in einer bestimmten Datenbank zu aktivieren, authentifizieren Sie sich mit der Mongo-Shell bei Ihrem Amazon DocumentDB-Cluster und führen Sie die folgenden Befehle aus:
```
db.adminCommand({modifyChangeStreams: 1,
database: "db_name",
collection: "",
enable: true});
```
## Schritt 2: Ändern Sie die Aufbewahrungsdauer für Change-Streams
Ändern Sie als Nächstes den Aufbewahrungszeitraum für den Change-Stream je nachdem, wie lange Sie Änderungsereignisse im Change-Stream behalten möchten. Wenn Sie beispielsweise davon ausgehen, dass Ihre Amazon AWS DMS DocumentDB-Cluster-Migration 12 Stunden dauern wird, sollten Sie die Aufbewahrung des Change-Streams auf einen Wert von mehr als 12 Stunden festlegen. Die Standardaufbewahrungsdauer für Ihren Amazon DocumentDB-Cluster beträgt drei Stunden. Sie können die Aufbewahrungsdauer des Change-Stream-Protokolls für Ihren Amazon DocumentDB-Cluster zwischen einer Stunde und sieben Tagen ändern, indem Sie die AWS-Managementkonsole oder die AWS CLI verwenden. Weitere Informationen finden Sie unter [Ändern der Aufbewahrungsdauer für das Change-Stream-Protokoll](https://docs.aws.amazon.com/documentdb/latest/developerguide/change_streams.html#change_streams-modifying_log_retention).
## Schritt 3: Migrieren Sie Ihre Indizes
Erstellen Sie dieselben Indizes auf Ihrem Amazon DocumentDB DocumentDB-Zielcluster wie auf Ihrem Amazon DocumentDB DocumentDB-Quellcluster. Es AWS DMS wickelt zwar die Migration von Daten ab, migriert aber keine Indizes. Um die Indizes zu migrieren, verwenden Sie das Amazon DocumentDB Index Tool, um Indizes aus dem Amazon DocumentDB DocumentDB-Quellcluster zu exportieren. Sie können das Tool herunterladen, indem Sie einen Klon des Amazon DocumentDB GitHub DocumentDB-Tools-Repos erstellen und den Anweisungen unter folgen. [https://github.com/awslabs/amazon-documentdb-tools/blob/master/index-tool/README.md](https://github.com/awslabs/amazon-documentdb-tools/blob/master/index-tool/README.md) Sie können das Tool von einer EC2 Amazon-Instance oder einer AWS Cloud9 Umgebung aus ausführen, die in derselben Amazon VPC wie Ihr Amazon DocumentDB-Cluster läuft.
Ersetzen Sie im folgenden Beispiel jede Information *user input placeholder* durch Ihre eigenen Informationen.
Der folgende Code gibt Indizes aus Ihrem Amazon DocumentDB DocumentDB-Quellcluster aus:
```
python migrationtools/documentdb_index_tool.py --dump-indexes
--uri mongodb://sample-user:user-password@sample-source-cluster.node.us-east 1.docdb.amazonaws.com:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false'
--dir ~/index.js/
2020-02-11 21:51:23,245: Successfully authenticated to database: admin2020-02-11 21:46:50,432: Successfully connected to instance docdb-40-xx.cluster-xxxxxxxx.us-east-1.docdb.amazonaws.com:27017
2020-02-11 21:46:50,432: Retrieving indexes from server...2020-02-11 21:46:50,440: Completed writing index metadata to local folder: /home/ec2-user/index.js/
```
Sobald Ihre Indizes erfolgreich exportiert wurden, stellen Sie diese Indizes in Ihrem Amazon DocumentDB DocumentDB-Zielcluster wieder her. Verwenden Sie das Amazon DocumentDB Index Tool, um die Indizes wiederherzustellen, die Sie im vorherigen Schritt exportiert haben. Der folgende Befehl stellt die Indizes in Ihrem Amazon DocumentDB DocumentDB-Zielcluster aus dem angegebenen Verzeichnis wieder her.
```
python migrationtools/documentdb_index_tool.py --restore-indexes
--uri mongodb://sample-user:user-password@sample-destination-cluster.node.us-east 1.docdb.amazonaws.com:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false'
--dir ~/index.js/
2020-02-11 21:51:23,245: Successfully authenticated to database: admin2020-02-11 21:51:23,245: Successfully connected to instance docdb-50-xx.cluster-xxxxxxxx.us-east-1.docdb.amazonaws.com:27017
2020-02-11 21:51:23,264: testdb.coll: added index: _id
```
Um zu überprüfen, ob Sie die Indizes korrekt wiederhergestellt haben, stellen Sie mit der Mongo-Shell eine Verbindung zu Ihrem Amazon DocumentDB DocumentDB-Zielcluster her und listen Sie die Indizes für eine bestimmte Sammlung auf. Sehen Sie sich den folgenden Code an:
```
mongo --ssl
--host docdb-xx-xx.cluster-xxxxxxxx.us-east-1.docdb.amazonaws.com:27017
--sslCAFile rds-ca-2019-root.pem --username documentdb --password documentdb
db.coll.getIndexes()
```
## Schritt 4: Erstellen Sie eine AWS DMS Replikationsinstanz
Eine AWS DMS Replikationsinstanz stellt eine Verbindung her und liest Daten aus Ihrem Amazon DocumentDB DocumentDB-Quellcluster und schreibt sie in Ihren Amazon DocumentDB DocumentDB-Zielcluster. Die AWS DMS Replikationsinstanz kann sowohl Massenlade- als auch CDC-Operationen ausführen. Der Großteil dieser Verarbeitung findet im Speicher statt. Bei großen Vorgängen kann jedoch eine gewisse Pufferung auf der Festplatte erforderlich sein. Zwischengespeicherte Transaktionen und Protokolldateien werden ebenfalls auf Festplatte geschrieben. Sobald die Daten migriert sind, streamt die Replikationsinstanz auch alle Änderungsereignisse, um sicherzustellen, dass Quelle und Ziel synchron sind.
**So erstellen Sie eine AWS DMS Replikationsinstanz:**
1. Öffnen Sie die AWS DMS [Konsole](https://console.aws.amazon.com/dms/v2).
1. Wählen Sie im Navigationsbereich **Replication instances (Replikations-Instances)** aus.
1. Wählen Sie **Create replication instance (Replikations-Instance erstellen)** aus und geben Sie die folgenden Informationen ein:
+ Geben Sie unter Name einen Namen Ihrer Wahl ein. Beispiel, `docdb36todocdb40`.
+ Geben Sie unter **Beschreibung** eine Beschreibung Ihrer Wahl ein. Für lititem eine Replikationsinstanz von Amazon DocumentDB 3.6 auf Amazon DocumentDB 4.0.
+ Wählen Sie für **Instance-Klasse** die Größe entsprechend Ihren Anforderungen aus.
+ Wählen Sie für **Engine-Version** `3.4.1.`
+ Wählen Sie für **Amazon VPC** die Amazon VPC aus, die Ihre Amazon DocumentDB DocumentDB-Quell- und Zielcluster beherbergt.
+ Verwenden **Sie für Allocation Storage** (GiB) den Standardwert von 50 GiB. Wenn Sie einen Workload mit hohem Schreibdurchsatz haben, erhöhen Sie diesen Wert entsprechend Ihrer Arbeitslast.
+ Wählen Sie für **Multi-AZ** **Ja** aus, wenn Sie Hochverfügbarkeits- und Failover-Unterstützung benötigen.
+ Für **Publicly accessible (Öffentlich zugänglich)** aktivieren Sie diese Option.
![\[Bild: Dialogfeld zur Konfiguration der Replikationsinstanz mit 10 konfigurierbaren Feldern und Schaltflächen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/replication-instance-config.png)
1. Wählen Sie **Create replication instance (Replikations-Instance erstellen)** aus.
## Schritt 5: Erstellen Sie einen AWS DMS Quellendpunkt
Der Quellendpunkt wird für den Amazon DocumentDB DocumentDB-Quellcluster verwendet.
**Um einen Quellendpunkt zu erstellen**
1. Öffnen Sie die AWS DMS [Konsole](https://console.aws.amazon.com/dms/v2).
1. Wählen Sie im Navigationsbereich **Endpunkte** aus.
1. Wählen Sie die folgenden Informationen aus `Create endpoint` und geben Sie sie ein:
+ Für **Endpoint type (Endpunkttyp)** wählen Sie **Source (Quelle)** aus.
+ >Geben Sie für **Endpoint Identifier** beispielsweise `docdb-source` einen Namen ein, den Sie sich leicht merken können.
+ Wählen Sie `docdb` für **Source Engine**.
+ Geben Sie als **Servername** den DNS-Namen Ihres Amazon DocumentDB DocumentDB-Quell-Clusters ein.
+ Geben Sie für **Port** die Portnummer Ihres Amazon DocumentDB DocumentDB-Quell-Clusters ein.
+ Wählen Sie `verify-full` für **den SSL-Modus**.
+ Wählen Sie für **CA-Zertifikat** die Option **Neues CA-Zertifikat hinzufügen** aus. Laden Sie das [neue CA-Zertifikat (neues CA-Zertifikat](https://truststore.pki.rds.amazonaws.com/global/global-bundle.p7b) herunter, um ein TLS-Verbindungspaket zu erstellen. Geben Sie als **Certificate Identifier** ein `rds-combined-ca-bundle`. Wählen Sie unter **Import certificate file (Zertifikatsdatei importieren)** die Option **Choose file (Datei auswählen)** und navigieren Sie zu der `.pem`-Datei, die Sie zuvor heruntergeladen haben. Wählen Sie die Datei aus und öffnen Sie sie. Wählen Sie **Zertifikat importieren** und wählen Sie dann `rds-combined-ca-bundle` aus der **Dropdownliste Zertifikat auswählen**
+ Geben Sie **unter Benutzername** den primären Benutzernamen Ihres Amazon DocumentDB DocumentDB-Quell-Clusters ein.
+ Geben Sie **unter Passwort** das primäre Passwort Ihres Amazon DocumentDB DocumentDB-Quell-Clusters ein.
+ Geben Sie **unter Datenbankname** den Datenbanknamen ein, für den Sie ein Upgrade durchführen möchten.
![\[Bild: Ein Dialogfeld zur Endpunktkonfiguration für die AWS DMS Quelle mit neun konfigurierbaren Feldern und Dropdownmenüs.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/endpoint-config.png)
1. Testen Sie Ihre Verbindung, um sicherzustellen, dass sie erfolgreich eingerichtet wurde.
![\[Bild: Dialogfeld zum Testen der Endpunktverbindung für die AWS DMS Quelle mit zwei Dropdownmenüs, einer Testschaltfläche und einer Liste der ausgeführten Tests.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/test-endpoint-config.png)
1. Klicken Sie auf **Endpunkt erstellen**.
**Anmerkung**
AWS DMS kann jeweils nur eine Datenbank migrieren.
## Schritt 6: Erstellen Sie einen AWS DMS Zielendpunkt
Der Zielendpunkt ist für Ihren Amazon DocumentDB DocumentDB-Zielcluster.
**Um einen Zielendpunkt zu erstellen:**
1. Öffnen Sie die [AWS DMS -Konsole](https://console.aws.amazon.com/dms/v2).
1. Wählen Sie im Navigationsbereich **Endpunkte** aus.
1. Wählen Sie **Create endpoint (Endpunkt erstellen)** und geben Sie die folgenden Informationen ein:
+ Für **Endpoint type (Endpunkttyp)** wählen Sie **Target (Ziel)** aus.
+ Für **Endpoint Identifier (Endpunkt-ID)** geben Sie einen Namen ein, der leicht zu merken ist, zum Beispiel `docdb-target`.
+ Wählen Sie für **Source Engine**`docdb`.
+ Geben Sie als **Servername** den DNS-Namen Ihres Amazon DocumentDB DocumentDB-Ziel-Clusters ein.
+ Geben Sie für **Port** die Portnummer Ihres Amazon DocumentDB DocumentDB-Ziel-Clusters ein.
+ Wählen Sie `verify-full` für **den SSL-Modus**.
+ Wählen Sie für **CA-Zertifikat** das vorhandene `rds-combined-ca-bundle` Zertifikat aus der **Drop-down-Liste Zertifikat auswählen** aus.
+ Geben Sie **unter Benutzername** den primären Benutzernamen Ihres Amazon DocumentDB DocumentDB-Ziel-Clusters ein.
+ Geben Sie **unter Passwort** das primäre Passwort Ihres Amazon DocumentDB DocumentDB-Ziel-Clusters ein.
+ Geben Sie als **Datenbankname** denselben Datenbanknamen ein, den Sie zur Einrichtung Ihres Quellendpunkts verwendet haben.
![\[Bild: Ein Dialogfeld zur Endpunktkonfiguration für das AWS DMS Ziel mit neun konfigurierbaren Feldern und Dropdownmenüs.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/target-endpoint-config.png)
1. Testen Sie Ihre Verbindung, um sicherzustellen, dass sie erfolgreich eingerichtet wurde.
![\[Bild: Dialogfeld zum Testen der Endpunktverbindung für das AWS DMS Ziel mit zwei Dropdownmenüs, einer Testschaltfläche und einer Liste der ausgeführten Tests.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/test-target-endpoint.png)
1. Klicken Sie auf **Endpunkt erstellen**.
## Schritt 7: Erstellen Sie eine Migrationsaufgabe und führen Sie sie aus
Eine AWS DMS Aufgabe verbindet die Replikationsinstanz mit Ihrer Quell- und Zielinstanz. Wenn Sie eine Migrationsaufgabe erstellen, geben Sie den Quellendpunkt, den Zielendpunkt, die Replikationsinstanz und alle gewünschten Migrationseinstellungen an. Eine AWS DMS Aufgabe kann mit drei verschiedenen Migrationstypen erstellt werden: Migration vorhandener Daten, Migration vorhandener Daten und Replikation laufender Änderungen oder nur Datenänderungen. Da der Zweck dieser Anleitung darin besteht, einen Amazon DocumentDB-Cluster mit minimaler Ausfallzeit zu aktualisieren, nutzen die Schritte die Option, vorhandene Daten zu migrieren und laufende Änderungen zu replizieren. Mit dieser Option werden Änderungen bei der Migration Ihrer vorhandenen Daten AWS DMS erfasst. AWS DMS erfasst weiterhin Änderungen und wendet sie an, auch nachdem die Massendaten geladen wurden. Schließlich sind die Quell- und Zieldatenbanken synchronisiert, unter Berücksichtigung einer minimalen Ausfallzeit während der Migration.
**Im Folgenden finden Sie die Schritte zum Erstellen einer Migrationsaufgabe für eine Migration mit minimalen Ausfallzeiten:**
1. Öffnen Sie die AWS DMS [Konsole](https://console.aws.amazon.com/dms/v2).
1. Wählen Sie im Navigationsbereich die Option **Datenbankmigrationsaufgaben** aus.
1. Wählen Sie **Aufgabe zur Datenbankmigration erstellen** und geben Sie die folgenden Informationen in den Abschnitt **Aufgabenkonfiguration** ein:
+ Geben Sie **unter Task-ID** beispielsweise einen Namen ein, den Sie sich leicht merken können`my-dms-upgrade-task`.
+ Geben Sie für **Descriptive Amazon Resource Name (ARN)** einen benutzerfreundlichen Namen ein, um den standardmäßigen DMS-ARN zu überschreiben.
+ Für **Replication instance (Replikations-Instance)** wählen Sie die Replikations-Instance aus, die Sie in [Schritt 4: Erstellen Sie eine AWS DMS Replikationsinstanz](#docdb-migration.versions-step4) erstellt haben.
+ Wählen Sie für **Quelldatenbank-Endpunkt** den Quellendpunkt aus, in dem Sie ihn erstellt haben. [Schritt 5: Erstellen Sie einen AWS DMS Quellendpunkt](#docdb-migration.versions-step5)
+ Wählen Sie für **Zieldatenbank-Endpunkt** den Zielendpunkt aus, in dem Sie ihn erstellt haben[Schritt 6: Erstellen Sie einen AWS DMS Zielendpunkt](#docdb-migration.versions-step6).
+ Wählen Sie als **Migrationstyp** die Option **Migrieren und replizieren** aus.
![\[Bild: Dialogfeld zur Aufgabenkonfiguration für die Migrationsaufgabe.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/task-config.png)
1. Geben Sie im Abschnitt **Aufgabeneinstellungen** die folgenden Informationen ein:
+ Wählen Sie für den Abschnitt **Zieltabellenvorbereitungsmodus** die Option **Nichts tun** aus. Dadurch wird sichergestellt, dass die in Schritt 3 erstellten Indizes nicht gelöscht werden.
+ Wählen Sie im Unterabschnitt **Task-Protokolle** die Option Protokolle **aktivieren** aus. CloudWatch
+ Wählen Sie für die **Startkonfiguration der Migrationsaufgabe** die Option **Automatisch bei Erstellung** aus. Dadurch wird die Migrationsaufgabe automatisch gestartet, sobald Sie sie erstellt haben.
+ Wählen Sie **Datenbankmigrationsaufgabe erstellen** aus.
AWS DMS beginnt jetzt mit der Migration von Daten aus Ihrem Amazon DocumentDB DocumentDB-Quellcluster zu Ihrem Amazon DocumentDB DocumentDB-Zielcluster. Der Aufgabenstatus sollte sich von „Wird gestartet“ auf „Wird ausgeführt“ ändern. Sie können den Fortschritt überwachen, indem Sie in der AWS DMS Konsole Aufgaben auswählen. Nach mehreren minutes/hours Schritten (abhängig von der Größe Ihrer Migration) sollte sich der Status von „Laden abgeschlossen“ ändern, wobei die Replikation läuft. Das bedeutet, dass AWS DMS Sie eine vollständige Lastmigration Ihres Amazon DocumentDB-Quell-Clusters zu einem Amazon DocumentDB DocumentDB-Zielcluster abgeschlossen haben und jetzt Änderungsereignisse repliziert haben.
![\[Bild: Dialogfeld mit einer Zusammenfassung der Migration.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/migration-load-complete.png)
Irgendwann werden Ihre Quelle und Ihr Ziel synchronisiert sein. Sie können überprüfen, ob sie synchron sind, indem Sie einen `count()` Vorgang für Ihre Sammlungen ausführen, um zu überprüfen, ob alle Änderungsereignisse migriert wurden.
## Schritt 8: Ändern des Anwendungsendpunkts auf den Amazon DocumentDB DocumentDB-Zielcluster
Nachdem der vollständige Ladevorgang abgeschlossen ist und der CDC-Prozess kontinuierlich repliziert wird, können Sie den Datenbankverbindungsendpunkt Ihrer Anwendung von Ihrem Amazon DocumentDB DocumentDB-Quellcluster auf Ihren Amazon DocumentDB DocumentDB-Zielcluster ändern.