Migrationserweiterung von Azure Cosmos DB for MongoDB vCore für Azure Data Studio (Vorschau)

Artikel
04/23/2024

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:

Das Ausführen einer End-to-End-Bewertung Ihrer Workload und Ermitteln der erforderlichen Aktionen zum Migrieren Ihrer Workloads zu Azure Cosmos DB for MongoDB vCore.
Den Migrationsvorgang mit ausgewählten Datenbanken und Sammlungen zu Azure Cosmos DB für MongoDB vCore durchzuführen.

Wichtig

Folgende Szenarien werden dieser Erweiterung derzeit nicht unterstützt:

Online-Migration für Azure Cosmos DB for MongoDB vCore.
Online-/Offlinemigrationen für Azure Cosmos DB for MongoDB RU.

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 vCore.
- Falls Sie nicht über ein Azure-Abonnement verfügen, können Sie ein kostenloses Konto erstellen.
Die aktuelle Version von Azure Data Studio.
MongoDB mit Version 3.2 oder höher.

Vorbereiten

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

Weitere Informationen zur vorbereitenden Planung der Migration für die API für MongoDB vCore finden Sie unter Vorbereitende Schritte zur Migration für Azure Cosmos DB for MongoDB vCore.
Weitere Informationen zur vorbereitenden Planung der Migration für die API für MongoDB RU finden Sie unter Vorbereitende Schritte zur Migration für Azure Cosmos DB for MongoDB RU

Installieren Sie die -Erweiterung.

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

Öffnen Sie den Erweiterungs-Manager in Azure Data Studio. Klicken Sie entweder auf das Erweiterungssymbol oder im Menü „Ansicht“ auf Erweiterungen.
Geben Sie Cosmos in das Suchfeld ein.
Wählen Sie die Erweiterung für die Azure Cosmos DB-Migration für MongoDB aus, und zeigen Sie die Details an.
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.

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

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

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.

Wählen Sie Verbinden.
Öffnen Sie das Kontextmenü für die neue Verbindung im Bereich Verbinden. Wählen Sie dann Verwalten aus.
Wählen Sie Azure Cosmos DB-Migration aus.

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.

Gehen Sie zur Registerkarte Dashboard. Wählen Sie dann Datenbank(en) bewerten und migrieren aus.
Schließen Sie den Assistenten ab, um Details für die Erweiterung bereitzustellen, damit sie eine Bewertung durchführen kann.
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 ermöglicht detailliertere Einblicke auf der Ebene der Sammlung. Wenn der Protokollordner nicht angegeben wird, stützt sich das Tool bei der Bewertung auf Informationen aus demserverStatus-Befehl. Beachten Sie, dass der Befehl „serverStatus“ die Nutzung von Funktionen nur seit dem letzten Neustart des Servers meldet. Um eine Bewertung zu erhalten, die Ihren tatsächlichen Workload genau widerspiegelt, stellen Sie sicher, dass seit dem letzten Neustart des Servers genügend Zeit vergangen ist.
4. Geben Sie den Pfad zu Datenbewertungsprotokollen an.
  
  Tipp
  
  Auch wenn dieses Feld optional ist, kann die Einbeziehung von Datenbewertungsprotokollen einen umfassenderen Einblick in den Workload bieten. Diese Protokolle werden durch Scannen von Daten und Überprüfen detaillierter Protokolle erfasst. Die Datenbewertung wird unabhängig als Befehlszeilenschnittstelle (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.
Wählen Sie bei erfolgreicher Validierung die Option Bewertung starten aus, um die Bewertung auszuführen.
Je nach Größe Ihres Quellservers dauert die Bewertung einige Minuten. Warten Sie, bis die Bewertung abgeschlossen wurde, bevor Sie fortfahren.
Wenn die Bewertung abgeschlossen ist, sollten Sie jetzt über einen Bewertungsbericht verfügen.
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.
Wählen Sie Bericht herunterladen aus, um einen konsolidierten herunterladbaren Bericht zu erhalten.
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 Offlinemigration

Führen Sie jetzt anhand des Bewertungsberichts eine Offlinemigration Ihrer Daten von Ihrer MongoDB-Quellinstanz zu Ihrem Zielkonto für Azure Cosmos DB for MongoDB vCore durch.

Wählen Sie im Bildschirm mit dem Bewertungsbericht alle Datenbanken aus, die Sie migrieren möchten. Wählen Sie anschließend Weiter aus.
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 alle Anmeldeinformationen ein, die zum Herstellen einer Verbindung mit dem Konto erforderlich sind.
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.
Wichtig

Derzeit unterstützt die Erweiterung keine private Endpunkt-aktivierte Quell- oder Ziel-MongoDB-Instanzen.
- Konfigurieren Sie die MongoDB-Quellinstanz, um Verbindungen aus globalen Azure-Rechenzentren zuzulassen.
- Fügen Sie Firewall-Ausnahmen zum Azure Cosmos DB for MongoDB vCore-Zielkonto hinzu, um Verbindungen von globalen Azure-Rechenzentren zu erlauben.
- Um die relevanten IP-Bereichsinformationen zu finden, laden Sie JSON von globalen Azure-IP-Adressbereichen herunter und suchen Sie in der JSON-Datei nach „AzureCloud.{Target Cosmos DB Account Region}“.
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.

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

Wichtig

Wenn Sie Database Migration Service zum ersten Mal verwenden, vergewissern Sie sich, dass der Microsoft.DataMigration-Ressourcenanbieter in Ihrem Abonnement registriert ist.
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.
Wählen Sie Migration starten aus, um die Datenübertragung mithilfe des ausgewählten Migrationsdiensts zu initiieren.
Zeigen Sie den Migrationsstatus auf der Dashboard-Seite an, sobald die Aufträge initialisiert sind.
Wählen Sie eine bestimmte Migration aus der Liste der Migrationen aus, um weitere Details anzuzeigen. Warten Sie, bis die Migration abgeschlossen ist, bevor Sie fortfahren.

Hinweis

Sie müssen nicht mit dem Migrationsdienst oder Azure Data Studio verbunden bleiben, während die Migrationsaufträge remote und asynchron ausgeführt werden. Die Migrationsaufträge werden im Migrationsdienst ausgeführt, und der Status wird in regelmäßigen Abständen auf dem Dashboard aktualisiert.

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.
Sobald der Auftrag abgeschlossen ist, zeigt der Migrationsstatus den Erfolg an.

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.

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