Teilen über

Migrationserweiterung für Azure Cosmos DB for MongoDB auf Basis virtueller Kerne für Azure Data Studio (Vorschau)

  • Artikel

Die Migrationserweiterung von Azure Cosmos DB for MongoDB hilft Ihnen bei der Migration Ihrer MongoDB-Workloads zu Azure Cosmos DB. Sie können diese Erweiterung für folgende Aufgaben verwenden:

  • Ausführen einer End-to-End-Bewertung Ihrer Workload und Ermitteln der erforderlichen Aktionen zum Migrieren der Workloads zu Azure Cosmos DB for MongoDB auf Basis virtueller Kerne.
  • Durchführen der Migration mit ausgewählten Datenbanken und Sammlungen zu Azure Cosmos DB for MongoDB auf Basis virtueller Kerne.

Wichtig

Folgende Szenarien werden dieser Erweiterung derzeit nicht unterstützt:

  • Migration, bei der das Quell- oder Zielkonto für private Endpunkte aktiviert ist.
  • Online-/Offlinemigrationen für Azure Cosmos DB for MongoDB auf RU-Basis.

Weitere Informationen zu alternativen Lösungen für die API für MongoDB vCore finden Sie unter Migrationsoptionen.

Voraussetzungen

  • Ein vorhandenes Konto für Azure Cosmos DB for MongoDB auf Basis virtueller Kerne.
  • Die aktuelle Version von Azure Data Studio.
  • MongoDB mit Version 3.2 oder höher.
  • Fügen Sie Firewallausnahmen zum Quellkonto von MongoDB und zum Zielkonto von Azure Cosmos DB for MongoDB auf Basis virtueller Kerne hinzu, um Verbindungen von globalen Azure-Rechenzentren zu akzeptieren.
  • Wenn Sie Database Migration Service zum ersten Mal verwenden, vergewissern Sie sich, dass der Microsoft.DataMigration-Ressourcenanbieter in Ihrem Abonnement registriert ist.

Vorbereiten

Vor der Migration sollten Sie im Vorfeld planen und Entscheidungen über die Migration treffen, ehe Sie mit der eigentlichen Datenübertragung beginnen.

Registrieren des Ressourcenanbieters „Microsoft.DataMigration“ in Ihrem Abonnement

Nach den folgenden Schritten können Sie sicherstellen, dass der Ressourcenanbieter „Microsoft.DataMigration“ in Ihrem Abonnement registriert ist:

Azure-Portal:

  1. Gehen 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 oben im Suchfeld nach Microsoft.DataMigration.
  4. Wählen Sie es, falls noch nicht registriert, aus und klicken Sie auf die Schaltfläche „Registrieren“.

Azure CLI:

  1. Öffnen Sie die 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 die 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"

Installieren der Erweiterung

Installieren Sie die Erweiterung der Migration von Azure Cosmos DB for MongoDB in Azure Data Studio, bevor Sie mit der Migration beginnen.

  1. Öffnen Sie den Erweiterungs-Manager in Azure Data Studio. Klicken Sie entweder auf das Erweiterungssymbol oder im Menü „Ansicht“ auf Erweiterungen.

  2. Geben Sie Cosmos in das Suchfeld ein.

  3. Wählen Sie die Erweiterung für die Azure Cosmos DB-Migration für MongoDB aus, und zeigen Sie die Details an.

    Screenshot der Schaltfläche „Installieren“ für die Erweiterung der Migration für Azure Cosmos DB for MongoDB.

  4. Wählen Sie Installieren aus.

Konfigurieren der Erweiterungseinstellungen

Sie können nach dem Installieren der Erweiterung verschiedene Erweiterungseinstellungen konfigurieren. Dieser Schritt ist optional. Wenn keine Einstellungen explizit konfiguriert sind, verwendet die Erweiterung die Standardeinstellungen.

  1. Navigieren Sie zu den Erweiterungen, und wählen Sie Azure Cosmos DB-Migration für MongoDB aus. Wählen Sie das Symbol zum Verwalten der Einstellungen und dann die Erweiterungseinstellungen aus.

    Screenshot der Erweiterungseinstellungen.

  2. Geben Sie unter Erweiterungseinstellungen für diese Erweiterung das Feld Assessment path an, um den Speicherort für die Bewertungsmetadaten zu ändern. Wenn das Feld leer bleibt, wird der Standardstandort verwendet.

Verbinden mit der MongoDB-Quelle

Verwenden Sie die Erweiterung erstmals zum Herstellen einer Verbindung mit der vorhandenen MongoDB-Quellinstanz. Stellen Sie sicher, dass Ihnen die Anmeldeinformationen zur Verbindung mit der Quelle vorliegen, bevor Sie mit diesem Abschnitt beginnen.

  1. Suchen Sie das Verbindungssymbol in der Menüleiste und wählen Sie Neue Verbindung aus.

    Screenshot der Menüleiste für Verbindungen in der Erweiterung.

  2. Füllen Sie im Bereich Verbindung die folgenden Felder aus:

    Wert
    Verbindungstyp Azure Cosmos DB for MongoDB
    Verbindungszeichenfolge/Parameter Verwenden Sie die Verbindungszeichenfolge oder die Parameter für Ihre vorhandene MongoDB-Quellinstanz.
    Servergruppe Default
    Name (optional) Geben Sie einen eindeutigen Namen für diese Verbindung an.

  3. Wählen Sie Verbinden.

  4. Öffnen Sie das Kontextmenü für die neue Verbindung im Bereich Verbinden. Wählen Sie dann Verwalten aus.

    Screenshot der Anzeige „Datenbank verwalten“

  5. Wählen Sie Azure Cosmos DB-Migration aus.

    Screenshot des Bildschirms „Database Migration Assessment“

Durchführen einer Bewertung

Die Bewertung untersucht den Bestand und die Nutzung Ihrer aktuellen MongoDB-Daten. Das Bewertungs-Feature generiert dann einen umfassenden Bericht, mit dessen Hilfe Sie die erforderlichen Aktionen ermitteln können, bevor Sie Ihre Workloads zu Azure Cosmos DB for MongoDB migrieren.

  1. Gehen Sie zur Registerkarte Dashboard. Wählen Sie dann Datenbank(en) bewerten und migrieren aus.

    Screenshot der Registerkarte „Dashboard“ innerhalb des Migrationsfeatures der Erweiterung.

  2. Schließen Sie den Assistenten ab, um Details für die Erweiterung bereitzustellen, damit sie eine Bewertung durchführen kann.

    Screenshot der Bewertungsdetails, bevor Anmeldedaten überprüft werden.

    1. Geben Sie einen Titel im Feld Bewertungsname ein.

    2. Wählen Sie das Zielkonto für Azure Cosmos DB for MongoDB aus der Dropdownliste Angebot aus.

    3. Geben Sie den Pfad zu den MongoDB-Protokollen an.

      Tipp

      Dies ist ein optionales Feld. Die Angabe des Protokollpfads führt jedoch zu präziseren Ergebnissen auf Sammlungsebene. Wenn der Protokollordner nicht angegeben wird, verwendet das Tool Details aus dem serverStatus-Befehl, um die Bewertung durchzuführen.

      Der serverStatus-Befehl gibt die Feature-Nutzung nur seit dem letzten Neustart zurück. Stellen Sie daher sicher, dass seit dem letzten Serverneustart genügend Zeit vergangen ist, um eine Bewertung bereitzustellen, die Ihre aktuelle Workload genau widerspiegelt.

    4. Geben Sie den Pfad zu Datenbewertungsprotokollen an.

      Tipp

      Wenngleich dieses Feld optional ist, kann die Bereitstellung von Datenbewertungsprotokollen ausführlichere Erkenntnisse über die Workload liefern. Diese Protokolle werden durch das Scannen von Daten und das Lesen ausführlicher Protokolle abgerufen. Die Datenbewertung wird unabhängig als CLI ausgeführt, bevor die Migrationsbewertung eingeleitet wird, und das resultierende JSON wird anschließend hier bereitgestellt. Laden Sie die CLI für die Datenbewertung hier herunter.

    5. Wählen Sie Validierung ausführen aus, um die Bewertungseingaben zu überprüfen.

  3. Wählen Sie bei erfolgreicher Validierung die Option Bewertung starten aus, um die Bewertung auszuführen.

    Screenshot der Bewertungsdetails, nachdem Anmeldedaten überprüft werden.

  4. Je nach Größe Ihres Quellservers dauert die Bewertung einige Minuten. Warten Sie, bis die Bewertung abgeschlossen wurde, bevor Sie fortfahren.

    Screenshot einer neuen Bewertung in Arbeit.

  5. Wenn die Bewertung abgeschlossen ist, sollten Sie jetzt über einen Bewertungsbericht verfügen.

    Screenshot des neuen Bewertungsberichts für die MongoDB-Quellinstanz.

  6. Wählen Sie im Bewertungsbericht den Namen der Instanz aus, um eine Liste der serverweiten Probleme zu überprüfen. Wählen Sie eine bestimmte Datenbank aus, um Probleme anzuzeigen, die nur für die ausgewählte Datenbank gelten.

    Screenshot des neuen Bewertungsberichts für die ausgewählte Datenbank in der MongoDB-Quellinstanz.

  7. Wählen Sie Bericht herunterladen aus, um einen konsolidierten herunterladbaren Bericht zu erhalten.

  8. Studieren Sie den Bewertungsbericht und ermitteln Sie alle für eine nahtlose Migration Ihrer Workloads zu Azure Cosmos DB for MongoDB erforderlichen Aktionen. Bevor Sie zum nächsten Schritt übergehen, müssen Sie sicherstellen, dass alle in der Bewertung gemeldeten Blockierungsprobleme behoben wurden. Wenn es unbehobene Probleme gibt, können Sie den Prozess beenden und sie später beheben. Sobald die Probleme behoben sind, können Sie zurückkehren und den Bewertungs- und Migrationsprozess neu starten.

Durchführen einer Migration

Führen Sie jetzt anhand des Bewertungsberichts eine Offlinemigration der Daten von der MongoDB-Quellinstanz zum Zielkonto von Azure Cosmos DB for MongoDB auf Basis virtueller Kerne durch.

  1. Wählen Sie im Bildschirm mit dem Bewertungsbericht alle Datenbanken aus, die Sie migrieren möchten. Wählen Sie anschließend Weiter aus.

    Screenshot der Auswahl der Datenbank für die Migration

  2. Grenzen Sie die Listen ein, um das Zielkonto für Azure Cosmos DB for MongoDB auszuwählen, indem Sie nach Abonnement und dann nach Ressourcengruppe filtern. Geben Sie dann die Anmeldedaten ein, die zum Herstellen einer Verbindung mit dem Konto erforderlich sind.

    Screenshot der Auswahl eines Zielkontos für Azure Cosmos DB for MongoDB.

  3. Wählen Sie Verbindung testen aus, um die Anmeldeinformationen für das Azure Cosmos DB for MongoDB-Konto zu validieren. Wählen Sie Weiter aus, um zur Zuordnung von Sammlungen von der Quelle zum Ziel zu navigieren.

  4. Wählen Sie entweder Überspringen oder Migrieren für jede Sammlung in der Liste der Zuordnungen aus. Sammlungen, die bereits im Ziel vorhanden sind, werden automatisch mit einem Symbol gekennzeichnet und standardmäßig auf Überspringen gesetzt. Wählen Sie die Option Weiter aus, um den Azure Database Migration Service (DMS) zu konfigurieren.

    Screenshot der Zuordnung von Sammlungen von der Quelle zum Ziel.

    Warnung

    Wenn Sie Migrieren einer vorhandenen Sammlung auswählen, wird die gesamte Sammlung überschrieben, was zu unwiederbringlichen Datenverlusten führt. Seien Sie vorsichtig bei der Auswahl dieser Option.

  5. Wählen Sie eine vorhandene Azure Database Migration Service-Instanz aus der Dropdownliste aus, oder wählen Sie Neu erstellen aus, um einen neuen Migrationsdienst zu erstellen. Azure Database Migration Service ist ein Dienst, der Daten zu und von Azure-Datenplattformen mithilfe der Cloudinfrastruktur für die Datenübertragung migriert, statt sich auf lokale Ressourcen zu stützen.

    Screenshot der Option zum Auswählen eines Migrationsdiensts.

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

    • Bei der Onlinemigration werden Sammlungsdaten kopiert, damit Updates während des Prozesses ebenfalls 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, was eine einfachere und vorhersehbare Vorgehensweise bietet. Sie funktioniert gut, wenn eine statische Kopie der Datenbank zum Einsatz kommt und Echtzeitaktualisierungen nicht unerlässlich sind.

  7. Wählen Sie Weiter aus, um die Migrationszusammenfassung anzuzeigen. Nachdem Sie die Details überprüft und bestätigt haben, wählen Sie Schema erstellen aus, um Ressourcen für das Zielkonto zu erstellen.

    Screenshot der Option zum Anzeigen der Migrationszusammenfassung.

  8. Wählen Sie Migration starten aus, um die Datenübertragung mithilfe des ausgewählten Migrationsdiensts zu initiieren.

    Screenshot der Option zum Starten einer Migration mithilfe des Migrationsdiensts.

  9. Vergewissern Sie sich im Popup-Fenster „Einstellungen bestätigen“, dass die Firewalleinstellungen den Anforderungen entsprechen. Wählen Sie zum Bestätigen OK aus.

    Screenshot des Popup-Fensters „Einstellungen bestätigen“ zur Überprüfung der Firewalleinstellungen.

Die Aufgaben der Datenmigration werden im Azure Database Migration Service ausgeführt. Daher müssen Sie während der Datenmigration nicht mit der Quell- und Zielumgebung verbunden sein. Der Status wird im Dashboard in regelmäßigen Abständen aktualisiert.

Hinweis

Wenn Sie mehr als 50 zu migrierende Sammlungen ausgewählt haben, wird der Migrationsauftrag im Migrationsdienst zu mehreren Aufträgen zusammengefasst, die jeweils maximal 50 Sammlungen enthalten.

  1. Überwachen Sie den Migrationsstatus auf der Dashboard-Seite, sobald die Aufträge initialisiert sind.

    Screenshot des Dashboards mit Migrationsstatus.

  2. Wählen Sie in der Liste der Migrationen eine bestimmte Migration aus, um weitere Details anzuzeigen.

Überwachen von Offlinemigrationen

Der Status wird automatisch aktualisiert, sobald alle Aufgaben der Datenmigration abgeschlossen sind.

Screenshot von Sammlungen mit Migrationsstatus.

Sobald die Daten erfolgreich aus der Quelle in das Ziel kopiert wurden, wird per Status der Offlinemigration der Erfolg angezeigt.

Screenshot des Erfolgs im Migrationsstatus.

  • Ändern Sie die Verbindungszeichenfolge in den Anwendungen so, dass sie auf das Zielkonto verweist.

Ü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.

Screenshot des Status der Onlinemigration.

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

  1. Die Schaltfläche Cutover wird aktiviert, sobald der anfängliche Datenladevorgang für alle Sammlungen abgeschlossen ist. Die Migration befindet sich derzeit in der Replikationsphase. Dabei werden kontinuierlich Updates von der Quell- in die Zielinstanz kopiert, um sie anhand der neuesten Änderungen auf dem neuesten Stand zu halten.

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

  3. Überwachen Sie die Replikationsänderungen in der Tabelle, und warten Sie, bis sich die Metrik „Replikationsänderungen eingespielt“ stabilisiert. Eine stabile Metrik „Replikationsänderungen eingespielt“ gibt an, dass alle Updates aus der Quelle erfolgreich in das Ziel kopiert wurden.

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

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

  6. Wählen Sie im Popup-Fenster Cutover abschließen aus.
    Screenshot des Popup-Fensters „Cutover“ der Onlinemigration.

    Hinweis

    Das Ausführen des Cutover-Vorgangs ohne Überprüfung, dass die Quelle und das Ziel synchronisiert sind, kann zu Datenverlusten führen.

  7. Warten Sie, bis sich der Status in Erfolgreich ändert.

  8. Aktualisieren Sie die Verbindungszeichenfolge in den Anwendungen so, dass sie auf das Zielkonto verweist.

Anzeigen früherer Migrationen und Bewertungen

Es ist oft hilfreich, sich frühere Bewertungen und Migrationen anzusehen. Die Erweiterung verfügt über eine Schnittstelle zur Ansicht von Zusammenfassungen früherer Bewertungen und Migrationen. Die Erweiterung bietet auch die Möglichkeit, detaillierte historische Bewertungsberichte anzusehen.

  1. Wählen Sie zum Anzeigen früherer Migrationen auf der Symbolleiste die Registerkarte Migrationen aus. Die Migrationsliste enthält alle Migrationen, die auf dem aktuellen Computer initiiert wurden. Sie können eine bestimmte Migration in der Liste auswählen, um weitere Details zu erhalten.

    Screenshot der Liste aller Migrationen, die mit der Erweiterung erstellt wurden.

  2. Wählen Sie zum Anzeigen früherer Bewertungen auf der Symbolleiste die Registerkarte Bewertungen aus. Die Bewertungsliste enthält alle Bewertungen, die auf dem aktuellen Computer initiiert wurden.

    Screenshot der Liste aller Bewertungen, die mit der Erweiterung ausgeführt wurden.

Nächster Schritt

Sehen Sie sich die häufig gestellten Fragen zur Migrationserweiterung für Azure Cosmos DB for MongoDB an