Leitfaden für die Migration: MongoDB zu Amazon DocumentDB

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.

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.

Dieses Migrationsplaybook bietet Ihnen Ressourcen und Schritte, die Sie bei der Migration von einer MongoDB-Datenbank zu Amazon DocumentDB unterstützen.

Migrationsprozess

Im Folgenden sind die wichtigsten Schritte aufgeführt, die normalerweise bei der Migration Ihrer Daten von einer MongoDB-Datenbank zu Amazon DocumentDB erforderlich sind.

Schritt 1: Kompatibilität und funktionale Unterschiede

Amazon DocumentDB interagiert mit der Apache 2.0-Open-Source-Version MongoDB 3.6, 4.0 und 5.0. APIs Daher können Sie dieselben MongoDB-Treiber, -Anwendungen und -Tools mit Amazon DocumentDB verwenden, wobei nur geringe oder keine Änderungen erforderlich sind.

Der erste Schritt besteht darin, die Kompatibilität zwischen den Operatoren und Indizes, die Ihre Anwendung in Ihrer MongoDB-Datenbank verwendet, und deren Verfügbarkeit in Amazon DocumentDB zu überprüfen und die funktionalen Unterschiede zwischen ihnen zu verstehen.

Kompatibilität der Betreiber

Verwenden Sie das Amazon DocumentDB DocumentDB-Kompatibilitätstool *, um auf einfache Weise herauszufinden, ob Ihre Anwendung Operatoren verwendet, die in ihren Abfragen nicht unterstützt werden. Dieses Tool kann Ihre MongoDB-Datenbankserver-Protokolldateien oder Ihren Anwendungsquellcode scannen, um einen Bericht über nicht unterstützte Operatoren bereitzustellen. Wenn Sie feststellen, dass nicht unterstützte Operatoren verwendet werden, müssen Sie Ihre Anwendung ändern, um nicht unterstützte Operatoren zu umgehen.

Um die Kompatibilität zwischen den in Ihrem Setup verwendeten MongoDB-Operatoren und den unterstützten Amazon DocumentDB DocumentDB-Operatoren zu überprüfen, führen Sie Folgendes aus:

git clone https://github.com/awslabs/amazon-documentdb-tools.git
cd amazon-documentdb-tools/compat-tool/
python3 compat.py --version <Amazon DocumentDB version> --directory <mongodb logfiles/source code>

Weitere Informationen finden Sie unter Unterstützte MongoDB APIs, Operationen und Datentypen in Amazon DocumentDB.

^{* Nicht offiziell unterstützt von. AWS}

Kompatibilität der Indizes

Sie können das Amazon DocumentDB-Indextool* verwenden, um herauszufinden, ob Sie Indextypen verwenden, die in Amazon DocumentDB nicht unterstützt werden. Dieses Tool benötigt eine Verbindung zu Ihrer Quelldatenbank, um Indexdefinitionen lesen zu können.

Dazu müssen Sie zunächst die Indexdefinitionen mithilfe der --dump-indexes Option in ein Verzeichnis speichern. Führen Sie dann das Tool mit der --show-issues Option aus und geben Sie das Verzeichnis an, in dem inkompatible Indizes gefunden werden können.

Indizes exportieren:

git clone https://github.com/awslabs/amazon-documentdb-tools.git
sudo pip install -r amazon-documentdb-tools/index-tool/requirements.txt
mkdir <directory to dump index definitions>
python3 migrationtools/documentdb_index_tool.py --dump-indexes --dir <directory> --uri <source-mongodb-uri>

Suchen Sie nach inkompatiblen Indizes:

python3 migrationtools/documentdb_index_tool.py --show-issues --dir <dumped-index-definitions-directory>

Wenn Sie feststellen, dass Indextypen verwendet werden, die nicht unterstützt werden, müssen Sie Ihre Anwendung oder Ihr Datenmodell ändern, um das Problem zu umgehen oder ohne die inkompatiblen Indizes fortzufahren.

Weitere Informationen zu den unterstützten Indextypen und Eigenschaften in Amazon DocumentDB finden Sie unter Indizes und Indexeigenschaften und So indexieren Sie in Amazon DocumentDB.

^{* Nicht offiziell unterstützt von. AWS}

Funktionelle Unterschiede

Lesen Sie Funktionale Unterschiede zu MongoDB weiter, um sich mit den Unterschieden vertraut zu machen.

Schritt 2: Machbarkeitsnachweis

Führen Sie einen Machbarkeitsnachweis durch, indem Sie Ihre Anwendung oder Ihre reguläre Testsuite auf Amazon DocumentDB ausführen, um Funktionalität und Leistung zu testen. Möglicherweise müssen Sie Ihren Amazon DocumentDB-Cluster mit Daten füllen, um die Tests durchzuführen. Sie können beispielsweise die mongorestore Tools mongodump und verwenden, um Daten aus Ihrer MongoDB-Quelle zu kopieren.

Funktionstests

Erstellen Sie einen Amazon DocumentDB-Cluster (sieheEinen Amazon DocumentDB-Cluster erstellen) und führen Sie Ihre Anwendung oder Ihre Funktionstestsuite aus, um zu überprüfen, ob alle Anwendungsworkflows weiterhin reibungslos in Amazon DocumentDB funktionieren.

Leistungstests

Führen Sie Leistungstests für Ihre Anwendung oder Leistungstestsuite aus, die auf Amazon DocumentDB ausgeführt wird, mit einer Arbeitslast, die Ihrer Produktions-Workload ähnelt, um festzustellen, ob das Setup Ihre Latenzanforderungen erfüllt. Passen Sie Ihre Arbeitslast an die Leistung an oder skalieren Sie Ihren Amazon DocumentDB-Cluster nach Bedarf. Weitere Informationen erhalten Sie unter Leistung und Ressourcennutzung und Skalierung von Amazon DocumentDB-Clustern.

Es ist wichtig, dass Sie Ihren Amazon DocumentDB-Cluster mit den richtigen Instance-Typen dimensionieren, um eine optimale Leistung zu erzielen. Weitere Informationen finden Sie unter Bewährte Methoden fürDimensionierung der Instanzen.

Sie können den Amazon DocumentDB-Größenrechner* verwenden, um Sie bei der Schätzung der Größe Ihres Amazon DocumentDB-Clusters zu unterstützen.

^{* Nicht offiziell unterstützt von. AWS}

Failover-Tests

Möglicherweise möchten Sie beobachten, wie Ihre Anwendung auf einen Neustart des Amazon DocumentDB-Primärknotens, einen primären Knoten-Failover oder eine Löschung des primären Knotens in einem Cluster mit mehreren Knoten reagiert und wenn Replikatknoten neu gestartet oder entfernt werden. Auf diese Weise können Sie überprüfen, ob Ihre Anwendung diesen Ereignissen standhält. Weitere Informationen finden Sie unter Testen eines Failovers.

Informationen zu den Ausnahmen, die eine Anwendung tolerieren sollte, und zu deren effizientem Umgang finden Sie unter Erstellen robuster Anwendungen mit Amazon DocumentDB.

Schritt 3: Migrieren Sie die Daten

Migrieren Sie Ihre Daten nach einem erfolgreichen Machbarkeitsnachweis zu Amazon DocumentDB. Die meisten unserer Kunden verwenden Online- oder Offline-Migrationsansätze, um ihre Daten zu migrieren.

Online-Migration

Mithilfe der Online-Migrationsmethode können Sie Daten aus Ihrer Quelldatenbank, die von einigen Gigabyte bis zu mehreren Terabyte reichen, nahezu ohne Ausfallzeiten zu Amazon DocumentDB migrieren. Weitere Informationen finden Sie unter ().AWS Database Migration ServiceAWS DMS

Wenn Sie aus einer MongoDB-Datenbank migrieren, können Sie sie verwenden, AWS DMS um eine Volllast durchzuführen und laufende Änderungen zu replizieren.

Ein step-by-step Verfahren finden Sie unter Migration zu Amazon DocumentDB mit der Online-Methode.

Weitere Informationen finden Sie im AWS Database Migration Service Abschnitt Amazon DocumentDB als Ziel verwenden im AWS Database Migration Service Benutzerhandbuch.

Zu beachtende Punkte bei AWS DMS:

Offline-Migration

Die Offline-Migration ist der einfachste Ansatz, um Datenbanken zu Amazon DocumentDB zu verschieben. Dieser Ansatz wird hauptsächlich für POCs und für Workloads verwendet, bei denen es während der Migration zu Schreibausfällen kommen kann.

Einen step-by-step Prozess finden Sie unter Migrieren von MongoDB zu Amazon DocumentDB mithilfe der Offline-Methode.

Schritt 4: Datenvalidierung

Sobald die Daten erfolgreich migriert wurden, überprüfen Sie die Daten auf ihre Richtigkeit, um Vertrauen zu gewinnen. In der Konsole für AWS DMS Migrationsaufgaben finden Sie die Metriken für migrierte Daten. Weitere Informationen finden Sie unter Überprüfen der migrierten Daten.

Sie können auch das Amazon DocumentDB DataDiffer Tool * verwenden, um die Datenkonsistenz zwischen den Quell- und Zielsammlungen zu überprüfen.

^{* Nicht offiziell unterstützt von AWS.}

Schritt 5: Umstellung der Anwendung

Dazu müssen Sie die Datenbankverbindungszeichenfolge Ihrer Anwendung ändern, um Ihren Amazon DocumentDB-Cluster zu verwenden.

Weitere Informationen zur Verbindung mit Amazon DocumentDB finden Sie unterAls Replikatsatz eine Verbindung zu Amazon DocumentDB herstellen.

Online-Migration

Wenn das vollständige Laden der Daten abgeschlossen ist, repliziert AWS DMS weiterhin laufende Änderungen von Ihrer Quelle nach Amazon DocumentDB. Nachdem die Änderungen erfasst wurden und Ihre Datenvalidierungsprüfungen abgeschlossen sind, können Sie eine Umstellung auf Amazon DocumentDB durchführen.

Offline-Migration

Sobald Sie die vollständigen Datenlade- und Datenvalidierungsprüfungen abgeschlossen haben, können Sie die Umstellung auf Amazon DocumentDB durchführen.

Weitere Ressourcen

Hier sind einige zusätzliche Ressourcen, die Ihnen bei der Migration helfen könnten:

^{* Nicht offiziell unterstützt von AWS.}