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.

Migrations-Playbook: MongoDB zu Amazon DocumentDB

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

Migrationsprozess

Im Folgenden sind die allgemeinen Schritte aufgeführt, die in der Regel 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 den Apache-2.0-Open-Source-APIs MongoDB 3.6, 4.0 und 5.0 APIs. Daher können Sie dieselben MongoDB-Treiber, -Anwendungen und -Tools mit Amazon DocumentDB ohne oder ohne Änderungen verwenden.

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

Kompatibilität von Operatoren

Verwenden Sie das Kompatibilitätstool von Amazon DocumentDB *, um leicht zu erkennen, ob Ihre Anwendung in ihren Abfragen nicht unterstützte Operatoren verwendet. 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 so ändern, dass sie nicht unterstützte Operatoren umgeht.

Führen Sie die folgenden Schritte aus, um die Kompatibilität zwischen den in Ihrem Setup verwendeten MongoDB-Operatoren und den unterstützten Amazon DocumentDB-Operatoren zu überprüfen:

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 MongoDBAPIs, Operationen und Datentypen in Amazon DocumentDB.

^{* Wird nicht offiziell von unterstütztAWS.}

Kompatibilität von 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 zu lesen.

Dazu müssen Sie zunächst Indexdefinitionen mit der --dump-indexes Option in ein Verzeichnis ablegen. Führen Sie dann das Tool mit der --show-issues Option aus und stellen Sie das Verzeichnis bereit, in dem Sie inkompatible Indizes finden können.

Exportieren von Indizes:

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 nicht unterstützte Indextypen verwendet werden, müssen Sie Ihre Anwendung oder Ihr Datenmodell ändern, um ohne die inkompatiblen Indizes zu umgehen oder fortzufahren.

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

^{* Wird nicht offiziell von unterstütztAWS.}

Funktionsunterschiede

Lesen Sie Funktionale Unterschiede zu MongoDB, 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 die Funktionalität und Leistung zu testen. Möglicherweise müssen Sie Ihren Amazon DocumentDB-Cluster mit Daten füllen, um die Tests durchführen zu können. Sie können beispielsweise die mongorestore Tools mongodump und verwenden, um Daten aus Ihrer MongoDB-Quell- zu kopieren.

Funktionstests

Erstellen Sie einen Amazon DocumentDB-Cluster (siehe Einen Amazon DocumentDB-Cluster erstellen) und führen Sie Ihre Anwendung oder Ihre funktionale Testsuite aus, um zu überprüfen, ob alle Anwendungsworkflows weiterhin reibungslos auf Amazon DocumentDB funktionieren.

Leistungstests

Führen Sie Leistungstests für Ihre Anwendung oder Ihre Leistungstestsuite durch, die auf Amazon DocumentDB ausgeführt wird, mit einem Workload, der Ihrem Produktions-Workload ähnelt, um festzustellen, ob die Einrichtung Ihren Latenzanforderungen entspricht. Optimieren Sie Ihren Workload auf Leistung oder skalieren Sie Ihren Amazon DocumentDB-Cluster nach Bedarf. Weitere Informationen finden Sie unter Leistung und Ressourcenauslastung und Skalierung von Amazon DocumentDB-Clustern.

Es ist wichtig, die Größe Ihres Amazon DocumentDB-Clusters mit den richtigen Instance-Typen für eine optimale Leistung zu erhöhen. Weitere Informationen finden Sie unter Bewährte Methoden für Dimensionierung der Instanzen.

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

^{* Wird von nicht offiziell unterstütztAWS.}

Failover-Tests

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

Informationen zu den Ausnahmen, die eine Anwendung tolerieren sollte, und zu deren effizienter Handhabung finden Sie unter Erstellen ausfallsicherer Anwendungen mit Amazon DocumentDB.

Schritt 3: Migrieren der Daten

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

Online-Migration

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

Wenn Sie von einer MongoDB-Datenbank migrieren, können Sie verwendenAWS DMS, um einen vollständigen Ladevorgang durchzuführen und laufende Änderungen zu replizieren.

Einen step-by-step Prozess finden Sie unter Migrieren zu Amazon DocumentDB mit der Online-Methode .

Weitere Informationen finden Sie im Abschnitt Verwenden von Amazon DocumentDB als Ziel für AWS Database Migration Service im AWS Database Migration Service -Benutzerhandbuch.

Punkte, die Sie mit beachten solltenAWS 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, die während der Migration Schreibausfallzeiten verursachen können.

Einen step-by-step Prozess finden Sie unter Migrieren von MongoDB zu Amazon DocumentDB mit 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 der AWS DMS Migrationsaufgabe finden Sie migrierte Datenmetriken. Weitere Informationen finden Sie unter Überprüfen migrierter Daten.

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

^{* Offiziell nicht von unterstütztAWS.}

Schritt 5: Anwendungs-Cutover

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

Weitere Informationen zum Herstellen einer Verbindung mit Amazon DocumentDB finden Sie unter Als Replikatsatz eine Verbindung zu Amazon DocumentDB herstellen.

Online-Migration

Nachdem der vollständige Datenladevorgang abgeschlossen ist, repliziert AWS DMS weiterhin laufende Änderungen von Ihrer Quelle auf Amazon DocumentDB . Nachdem die Änderungen abgeschlossen sind und Ihre Datenvalidierungsprüfungen abgeschlossen sind, können Sie einen Cutover auf Amazon DocumentDB durchführen.

Offline-Migration

Nach Abschluss der vollständigen Datenlade- und Datenvalidierungsprüfungen können Sie den Cutover auf Amazon DocumentDB durchführen.

Weitere Ressourcen

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

^{* Offiziell nicht von unterstütztAWS.}