Migrieren von MongoDB zu Azure DocumentDB online mithilfe Azure DocumentDB-Migrationserweiterung (öffentliche Vorschau)

In diesem Lernprogramm verwenden Sie die Azure DocumentDB-Migrationserweiterung in Visual Studio Code zum Erstellen und Verwalten von Migrationsaufträgen aus einer lokalen oder Cloudinstanz von MongoDB zum Azure DocumentDB. Diese Erweiterung bietet eine entwicklerfreundliche Schnittstelle zum Ausführen von Migrationen ohne Dienstunterbrechungen. Die Erweiterung beseitigt die Notwendigkeit zusätzlicher Infrastruktur und bietet sichere Konnektivität, nullkostenfreie Nutzung und präzise Kontrolle darüber, welche Datenbanken und Sammlungen migriert werden sollen.

Der Schwerpunkt dieses Artikels liegt auf der Verwendung des integrierten Workflows der Erweiterung, um Migrationsschritte direkt in Visual Studio Code zu vereinfachen. Dieser Ansatz eignet sich ideal für Szenarien, in denen Sie eine optimierte, verwaltete Erfahrung mit minimaler Komplexität und maximaler Zuverlässigkeit wünschen.

Voraussetzungen

• Ein Azure-Abonnement

  • Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein free-Konto

• Ein vorhandener Azure DocumentDB-Cluster

  • Wenn Sie keinen Cluster haben, erstellen Sie einen neuen Cluster.

• Installieren Sie die Azure DocumentDB-Migrationserweiterung auf Ihrem Computer. Dadurch wird automatisch die erforderliche Erweiterung DocumentDB für Visual Studio Code installiert.

Bereiten Sie vor Beginn der Migration Ihr Azure DocumentDB-Konto und Ihre vorhandene MongoDB-Instanz für die Migration vor.

MongoDB-Instanz (Quelle)

• Führen Sie die Vormigrationsbewertung aus, um festzustellen, ob zwischen Ihrer Quellinstanz und Ihrem Zielkonto Inkompatibilitäten und Warnungen vorliegen.
• Fügen Sie einen Benutzer mit readAnyDatabase und clusterMonitor Berechtigungen hinzu, es sei denn, ein Benutzer ist bereits vorhanden. Sie verwenden diese Anmeldeinformationen beim Erstellen von Migrationsaufträgen in der Erweiterung.

Azure DocumentDB (Target)

• Sammeln Sie die Anmeldeinformationen des Azure DocumentDB Accounts.
• Stellen Sie sicher, dass der Benutzer über createCollection, dropCollection, createIndex, insert und listCollections Berechtigungen verfügt.

Erforderliche Mindestberechtigungen

Verwenden Sie die folgenden Mindestrollen zum Erstellen und Ausführen von Migrationsaufträgen.

Details zur Anbieterregistrierung finden Sie unter Register Microsoft.DataMigration-Ressourcen-Provider in Ihrem Abonnement.

Durchführen der Migration

IPlanungshinweise zu Migrationsgröße, -geschwindigkeit und Umstellung finden Sie unter Bewährte Methoden für die Migration.

Herstellen einer Verbindung mit der Quelle

1. Öffnen Sie die DocumentDB-Erweiterung für VS Code .
2. Fügen Sie den MongoDB-Server hinzu, den Sie zur Liste "Document DB Connections " migrieren möchten.
3. Wählen Sie "Neue Verbindung hinzufügen" aus.
4. Wählen Sie auf der Navigationsleiste die Option "Verbindungszeichenfolge" aus.
5. Fügen Sie Ihre Verbindungszeichenfolge ein: mongodb://<YOUR_USERNAME>:<YOUR_PASSWORD>@localhost:10260/?tls=true&tlsAllowInvalidCertificates=true&authMechanism=SCRAM-SHA-256
6. Wählen Sie in den DocumentDB-Verbindungen die Verbindung aus, und erweitern Sie sie, um eine Verbindung herzustellen.

Migrationserweiterung aufrufen

Sie können die Migrationserweiterung aus den DocumentDB Connections aufrufen.

1. Klicken Sie mit der rechten Maustaste auf eine erweiterte (verbundene) Verbindung.

2. Wählen Sie " Datenmigration " aus dem Kontextmenü aus.

   

3. Wählen Sie in der Befehlspalette Migration in Azure DocumentDB aus.

4. Wählen Sie dann Migrate to Azure DocumentDB aus.

5. Ein Migrationsassistent führt Sie durch den Prozess.

Erstellen eines Migrationsauftrags

Ein Migrationsauftrag wird verwendet, um eine Gruppe von Sammlungen aus der Quelle zum Ziel Azure DocumentDB zu migrieren. Der Assistent zum Erstellen von Migrationsaufträgen umfasst sechs Schritte.

Schritt 1: Auftrag erstellen

In diesem Schritt geben Sie die grundlegenden Details für den Auftrag an.

• Auftragsname: Geben Sie einen benutzerfreundlichen Namen an, um den Migrationsauftrag zu identifizieren.

• Migrationsmodus: Wählen Sie den Migrationsmodus aus, der für Ihren Anwendungsfall am besten geeignet ist.

  • Bei der Onlinemigration werden Sammlungsdaten kopiert, um sicherzustellen, dass Updates auch während des Prozesses repliziert werden. Diese Methode ist wegen der minimalen Ausfallzeiten vorteilhaft und ermöglicht einen kontinuierlichen Betrieb zwecks Geschäftskontinuität. Nutzen Sie diese Option, wenn es auf den kontinuierlichen Betrieb ankommt und die Reduzierung von Ausfallzeiten Priorität hat.
  • Bei der Offlinemigration wird zu Beginn eine Momentaufnahme der Datenbank erfasst, die einen einfacheren und vorhersehbaren Ansatz bietet. Sie funktioniert gut, wenn eine statische Kopie der Datenbank zum Einsatz kommt und Echtzeitaktualisierungen nicht unerlässlich sind.

  Von Bedeutung

  Um eine erfolgreiche Onlinemigrationen von MongoDB sicherzustellen, muss ChangeStream auf dem MongoDB-Quellserver aktiviert sein. Ohne ChangeStream werden änderungen, die nach der ursprünglichen Migration an den Daten vorgenommen wurden, nicht erfasst. Verwenden Sie daher den Onlinemigrationsmodus nur, wenn ChangeStream auf Ihrem MongoDB Quell-Server aktiviert ist.

• Konnektivität: Wählen Sie je nach Sicherheitsmandat und Netzwerkeinrichtung Ihrer Organisation aus "Öffentlich" und "Privat" aus.

  • Verwenden Sie "Öffentlich ", wenn die Quell- und Zielserver über öffentliche IPs über das Internet zugänglich sind. Sie ermöglicht die Unterstützung für Dienste, die externe Barrierefreiheit erfordern.
  • Verwenden Sie "Privat ", wenn entweder die Quell- oder Zielserver ausschließlich über private IPs in einem virtuellen Netzwerk zugänglich sind. Es verbessert die Sicherheit, indem die Exponierung gegenüber dem öffentlichen Internet beseitigt wird.

Klicken Sie auf Weiter, um fortzufahren.

Schritt 2: Ziel auswählen

In diesem Schritt wählen Sie ein vorhandenes Azure DocumentDB-Konto aus und stellen dessen Verbindungszeichenfolge bereit.

1. Wählen Sie das Abonnement, die Ressourcengruppe und Azure DocumentDB-Konto aus den Dropdowns aus.

2. Stellen Sie den Verbindungszeichenfolge für das Azure DocumentDB-Konto bereit.

3. Stellen Sie sicher, dass die im Bildschirm aufgeführte IP in der Azure DocumentDB-Firewall zulässig ist.

4. Klicken Sie auf Weiter, um fortzufahren.

Schritt 3: Auswählen von Database Migration Service(DMS)

Azure Database Migration Service ist ein Dienst, der Daten zu und von Azure Datenplattformen mithilfe der Cloudinfrastruktur für die Datenübertragung migriert, anstatt auf lokale Ressourcen zu vertrauen. Wählen Sie eine vorhandene Azure Database Migration Service Instanz aus der Dropdownliste aus, oder wählen Sie Create DMS aus, um einen neuen Migrationsdienst zu erstellen.

Klicken Sie auf Weiter, um fortzufahren.

Schritt 4: Konfigurieren der Konnektivität

Dieser Bildschirm hängt vom Verbindungsmodus ab, den Sie in Schritt 1 ausgewählt haben.

Öffentliche Konnektivität

Bei öffentlicher Konnektivität verbindet der Migrationsauftrag Ihre Quelle und Ihr Ziel über das öffentliche Internet. Um die Kommunikation zu aktivieren, müssen Sie die Quell- und Zielfirewalls aktualisieren. Um die Kommunikation von den DMS-Servern zu ermöglichen, fügen Sie die im Bildschirm aufgeführten IP-Adressen zu den Quell- und Zielfirewalls hinzu. Weitere Informationen zum Netzwerkmodell finden Sie unter Public Connectivity. Anleitungen zur Firewallkonfiguration finden Sie unter configure Azure DocumentDB-Cluster Firewall.

Private Konnektivität

In der privaten Konnektivität wird der Migrationsauftrag innerhalb des virtuellen Netzwerks ausgeführt. Um sicher mit Ihren virtuellen Netzwerken zu kommunizieren, verwenden wir peering für virtuelle Netzwerke. Weitere Informationen zum Netzwerkmodell finden Sie unter Private Konnektivität.

1. Das Tool ermöglicht das Peering mit zwei virtuellen Netzwerken, eines für die Quelle und das andere für das Ziel. Wählen Sie je nach Netzwerkkonfiguration das Abonnement, die Ressourcengruppe und die virtuellen Netzwerke aus den Dropdownlisten aus.

2. Wählen Sie im Abschnitt "DMS-Konfiguration " einen CIDR-Bereich aus, der nicht mit Ihren virtuellen Netzwerken in Konflikt kommt.

3. Führen Sie die auf dem Bildschirm bereitgestellten PowerShell-Skripts aus, um die Integration des virtuellen Netzwerks zu ermöglichen.

4. Klicken Sie auf Weiter, um fortzufahren.

Schritt 5: Auswählen von Sammlungen

In diesem Schritt wählen Sie die Sammlungen aus, die in den Migrationsauftrag aufgenommen werden sollen. Wählen Sie aus der Liste der Sammlungen mithilfe der bereitgestellten Suchoptionen aus. Sammlungen, die bereits im Ziel vorhanden sind, werden in der Spalte Im Ziel vorhanden mit Ja automatisch markiert.

Klicken Sie auf Weiter, um fortzufahren.

Schritt 6: Bestätigen und Starten

Überprüfen Sie die Details des Migrationsauftrags, bevor Sie " Migration starten" auswählen. Wenn die Details aktualisiert werden müssen, verwenden Sie die Schaltfläche " Details bearbeiten ".

Nachdem der Migrationsauftrag erfolgreich erstellt wurde, werden Sie automatisch zur Seite "Vorhandene Aufträge anzeigen" umgeleitet.

Überwachen vorhandener Migrationsaufträge

Verwenden Sie die Registerkarte "Vorhandene Aufträge anzeigen ", um den Migrationsstatus von initialisierten Aufträgen zu überwachen. Die Aufträge werden basierend auf dem ausgewählten DMS aufgelistet. Verwenden Sie die Schaltfläche "DMS ändern", um Ihre Auswahl zu ändern.

Der Status wird in häufigen Intervallen automatisch aktualisiert. Offlineaufträge werden automatisch abgeschlossen, sobald die ausgewählten Momentaufnahmen der Sammlung in das Ziel kopiert werden. Die Onlinemigrationen müssen jedoch manuell überschnitten werden.

Um den Sammlungsstatus anzuzeigen, wählen Sie eine Zeile aus der Tabelle aus.

Überwachen von Onlinemigrationen

Onlinemigrationen werden anders als Offlinemigrationen nicht automatisch abgeschlossen. Stattdessen werden sie kontinuierlich ausgeführt, bis sie durch Auswahl von Cutover manuell abgeschlossen werden.

Führen Sie die folgenden Schritte in der angegebenen Reihenfolge aus, um die Onlinemigration abzuschließen:

1. Die Schaltfläche Cutover ist aktiviert, sobald der anfängliche Datenladevorgang für alle Sammlungen abgeschlossen ist. In dieser Phase befindet sich der Auftrag in der Replikationsphase und kopiert fortlaufend Updates von der Quellinstanz in die Zielinstanz, um sie mit den neuesten Änderungen aktuell zu halten.

2. Wenn Sie bereit sind, den Migrations-Cutover auszuführen, beenden Sie alle eingehenden Transaktionen zu den Quellsammlungen, die migriert werden.

3. Die Replikationslücke zeigt die Zeitlücke zwischen der letzten Aktualisierung und der aktuellen Uhrzeit an.

4. Überwachen Sie die Replikationsänderungen in der Tabelle und warten Sie, bis die Metrik Replication Changes Played stabilisiert ist. Eine stabile Metrik Replikationsänderungen wiedergegeben gibt an, dass alle Aktualisierungen aus der Quelle erfolgreich in das Ziel kopiert werden.

5. Wählen Sie Cutover aus, wenn die Replikationslücke für alle Sammlungen minimal ist und die Metrik Replikationsänderungen wiedergegeben stabil ist.

6. Überprüfen Sie manuell, ob die Zeilenanzahl von Quell- und Zielsammlungen identisch ist.

Migrationsszenarios

Die Azure DocumentDB-Migrationserweiterung unterstützt mehrere Quellumgebungen, einschließlich MongoDB-Instanzen, die in Azure, lokalen Rechenzentren und anderen Cloudanbietern ausgeführt werden. Die Erweiterung bietet flexible Konnektivitätsoptionen, um verschiedene Netzwerkkonfigurationen und Sicherheitsanforderungen zu erfüllen.

Unterstützte Quellumgebungen

In der folgenden Tabelle sind die unterstützten Migrationsquellen zusammengefasst:

Öffentliche Konnektivität

Im Modus für die öffentliche Konnektivität stellt der Azure Database Migration Service (DMS) eine Verbindung mit Ihren Quell- und Zielservern über das öffentliche Internet bereit. DMS stellt statische IP-Adressen bereit, die Sie der Firewall-Zulassungslisten sowohl auf den Quell- als auch auf den Zielservern hinzufügen. DMS verwendet ein freigegebenes öffentliches virtuelles Netzwerk für alle Migrationen innerhalb einer bestimmten Region. Obwohl dieses virtuelle Netzwerk von mehreren Kundinnen und Kunden gemeinsam genutzt wird, läuft jeder Migrationsauftrag auf einem eigenen, isolierten privaten Workerknoten, um eine Isolation auf Auftragsebene sicherzustellen.

Verwenden Sie öffentliche Konnektivität in folgenden Fällen:

• Auf Ihre Quell- und Zielserver kann über öffentliche IP-Adressen zugegriffen werden.
• Die Sicherheitsrichtlinien Ihrer Organisation ermöglichen Verbindungen über das öffentliche Internet.
• Sie benötigen eine einfachere Einrichtung ohne virtuelle Netzwerkkonfiguration.

So aktivieren Sie die öffentliche Konnektivität:

1. Wählen Sie im Migrations-Assistenten "Öffentlich " als Verbindungsmodus aus.

2. Beachten Sie die statischen IP-Adressen, die im Assistenten angezeigt werden.

3. Fügen Sie diese IP-Adressen der Liste der zugelassenen Firewalls auf Ihrem Quell-MongoDB-Server hinzu.

4. Fügen Sie diese IP-Adressen zur Azure DocumentDB-Firewall hinzu.

Private Konnektivität

Im Modus für private Konnektivität stellt DMS ein dediziertes privates virtuelles Netzwerk für jeden Migrationsauftrag bereit und verbindet es mit den Quell- und Zielnetzwerken. Dies bedeutet, dass jeder Auftrag sowohl über isolierte Arbeitsknoten als auch ein isoliertes Netzwerk verfügt, um sicherzustellen, dass kein Verkehr zwischen Aufträgen erfolgt und keine gemeinsamen Netzwerkpfade zwischen Kunden vorhanden sind.

Die Erweiterung unterstützt bis zu zwei virtuelle Netzwerke:

• Virtuelles Quellnetzwerk: Das virtuelle Netzwerk, in dem auf den Quell-MongoDB-Server zugegriffen werden kann.
• Target virtual network: Das virtuelle Netzwerk, in dem Auf den Azure DocumentDB-Cluster zugegriffen werden kann.

Private Konnektivität verwenden, wenn:

• Auf Ihre Quell- oder Zielserver kann nicht über das öffentliche Internet zugegriffen werden.
• Ihre Organisation erfordert, dass der gesamte Datenverkehr über private Netzwerke fließt.
• Sie müssen eine öffentliche Internetexposition vermeiden.

Von anderen Cloudanbietern oder lokal

Verwenden Sie Ihre bevorzugten VPN-Tools, um die Netzwerkkonnektivität zwischen Azure und Ihrer Quellumgebung in einer anderen Cloud oder lokal einzurichten.

Von einem privaten Endpunkt in Azure

Richten Sie private Endpunkte für die virtuellen Quell- und Zielnetzwerke ein.

Diagramm, das die Netzwerkarchitektur für private Konnektivität in Azure zeigt

So aktivieren Sie private Konnektivität:

1. Wählen Sie im Migrations-Assistenten "Privat" als Verbindungsmodus aus.

2. Wählen Sie das Abonnement, die Ressourcengruppe und das virtuelle Netzwerk für Ihre Quellumgebung aus.

3. Wählen Sie das Abonnement, die Ressourcengruppe und das virtuelle Netzwerk für Ihre Zielumgebung aus.

4. Wählen Sie im Abschnitt "DMS-Konfiguration " einen CIDR-Bereich aus, der nicht mit Ihren vorhandenen virtuellen Netzwerken in Konflikt kommt.

5. Führen Sie die im Assistenten bereitgestellten PowerShell-Skripts aus, um die Integration und Peering für virtuelle Netzwerke zu aktivieren.

Registrieren Sie den Ressourcenanbieter Microsoft.DataMigration in Ihrem Abonnement.

Um sicherzustellen, dass der Microsoft.DataMigration-Ressourcenanbieter in Ihrem Abonnement registriert ist, können Sie die folgenden Schritte ausführen:

Azure Portal

1. Wechseln Sie zum Azure Portal, und navigieren Sie zu Ihrem Abonnement.

2. Wählen Sie im linken Menü unter "Einstellungen"die Option "Ressourcenanbieter" aus.

3. Suchen Sie nach Microsoft. DataMigration im Suchfeld oben.

4. Wenn sie nicht registriert ist, wählen Sie sie aus, und wählen Sie die Schaltfläche "Registrieren " aus.

Azure CLI

1. Öffnen Sie das Azure Cloud Shell oder Ihr lokales Terminal.

2. Führen Sie den folgenden Befehl aus, um den Ressourcenanbieter zu registrieren:

   az provider register --namespace Microsoft.DataMigration
   

PowerShell

1. Öffnen Sie das Azure Cloud Shell oder Ihre lokale PowerShell.

2. Führen Sie den folgenden Befehl aus, um den Ressourcenanbieter zu registrieren:

   Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"
   

Häufig gestellte Fragen

Warum fehlen Ansichten im Schritt des Auswahlsammlungsbildschirms, wenn Azure DocumentDB Ansichten unterstützt?

Azure DocumentDB unterstützt die Erstellung neuer Ansichten. Die Migrationserweiterung bietet jedoch keine Unterstützung für die Migration vorhandener Ansichten.

Nach Abschluss der Migration können Sie die Ansichten immer neu erstellen.

Welche Sammlungen und Datenbanken werden beim Migrieren von MongoDB zu Azure DocumentDB übersprungen?

Die folgenden Datenbanken und Sammlungen gelten als intern für MongoDB:

Werden die Migrationsaufträge lokal auf meinem Computer ausgeführt?

Der Migrations-Assistent in VS Code erfordert Netzwerkkonnektivität von Ihrem lokalen Computer an die Quell- und Zielumgebungen. Diese Konnektivität wird zum Aufzählen von Datenbanken und Sammlungen und zum Übermitteln des Migrationsauftrags verwendet. Nachdem der Auftrag übermittelt wurde, können Sie VS Code schließen oder die Verbindung mit den Quell- und Zielumgebungen trennen.

Die Datenmigration wird vollständig von Azure Database Migration Service (DMS) ausgeführt, einem Azure gehosteten Dienst, der alle Datenbewegungen verwaltet. DMS basiert nicht auf Ihrem lokalen Computer oder VS Code für die Auftragsausführung, sodass die lokale Konnektivität nach der Auftragsübermittlung nicht erforderlich ist.

Kann ich Datenbanken und Sammlungen während der Migration umbenennen?

Die Erweiterung unterstützt während der Migration keine Datenbank- und Sammlungsbenennung.

Wie sollte ich meine Quellserverfirewalls konfigurieren, um Konnektivitätsprobleme zu vermeiden?

Die erforderliche Netzwerkkonfiguration hängt vom ausgewählten Verbindungsmodus ab:

• Öffentlicher Modus: Sie müssen zulassen, dass die im Assistenten angezeigten IP-Adressen sowohl in der Quell- als auch in der Zielfirewall die Kommunikation ermöglichen.
• Privater Modus: Sie müssen die Integration des virtuellen Netzwerks aktivieren, damit die DMS-Server sicher mit den Quell- und Zielendpunkten innerhalb des virtuellen Netzwerks kommunizieren können.

Weitere Informationen finden Sie unter VS Code-Konnektivität

Wie viele Datenbanken und Sammlungen kann ich in einer einzigen Migration migrieren?

Sie können eine unbegrenzte Anzahl von Sammlungen in einer einzigen Migration einschließen.

Wie viele Migrationsaufträge kann ich gleichzeitig ausführen?

Sie können mehrere Migrationsaufträge ausführen, wenn Sie den öffentlichen Zugriff verwenden. Bei Verwendung des privaten Zugriffs kann ein einzelnes virtuelles Netzwerk jedoch jeweils nur einen aktiven Auftrag unterstützen. Um mehrere Aufträge mit privatem Zugriff auszuführen, müssen Sie für jeden Auftrag ein anderes virtuelles Netzwerk verwenden.

Welche Art von Protokollen generiert die Erweiterung?

Die Erweiterung zeichnet Fehler, Warnungen und andere Diagnoseprotokolle im Standardprotokollverzeichnis auf:

• Windows - C:\Users\<username>\.dmamongo\logs\
• Linux - ~/.dmamongo/logs
• Macos - /Users/<username>/.dmamongo/logs

Nächste Schritte