Freigeben über


Bewertung der MongoDB-Installation und Planung der Migration zu Azure Cosmos DB for MongoDB vCore

Führen Sie im Vorfeld Planungsaufgaben durch, und treffen Sie wichtige Entscheidungen, bevor Sie Ihre Daten zu Azure Cosmos DB for MongoDB vCore migrieren. Diese Entscheidungen tragen dazu bei, dass Ihr Migrationsprozess reibungslos verläuft.

Voraussetzungen

Bewerten Sie die Kompatibilität und Bereitschaft Ihrer Ressourcen für die Migration.

Bevor Sie Ihre Migration planen, bewerten Sie den Status Ihrer vorhandenen MongoDB-Ressourcen, um die Migration zu planen. Verwenden Sie die Azure Cosmos DB-Migrationserweiterung in VS Code, um die Kompatibilität und Bereitschaft Ihrer Workloads zu bewerten, während Sie die Migration von MongoDB zu Azure Cosmos DB für MongoDB vCore planen. Die End-to-End-Bewertung und erfahren Sie, welche Aktionen Sie ergreifen müssen, um Ihre Workloads nahtlos auf Azure Cosmos DB auszuführen. Der Bewertungsbericht stellt Ergebnisse auf Konto-, Datenbank- und Sammlungsebenen dar, die jeweils basierend auf dem Schweregrad als kritisch, Warnung oder Information gekennzeichnet sind, um die Priorisierung zu unterstützen. Der Bericht enthält Folgendes:

  • Nicht unterstützte Features und Syntax: Es kennzeichnet nicht unterstützte MongoDB-Features, Befehle, Abfragesyntax und Indextypen mit Verwendungshäufigkeit, um Korrekturen zu priorisieren.

  • Resource-Specific Empfehlungen: Jedes Ergebnis umfasst den Namen der betroffenen Ressource, umsetzbare Empfehlungen und relevante technische Details zur Behebung von Problemen.

  • Übersicht über die Umgebung: Fasst die wichtigsten Aspekte der MongoDB-Quellumgebung zusammen, z. B. Version, Lizenz, Instanztyp und Statistiken für Datenbanken und Sammlungen.

  • Kompatibilitäts- und Plattformeinschränkungen: Details zu Cosmos DB-spezifischen Kontingenten, Grenzwerten und potenzielle Shard-Schlüsselinkompatibilitäten bei partitionierten Workloads.

Ausführen einer Bewertung

  1. Installieren Sie zunächst die Azure Cosmos DB-Migrationserweiterung in VS Code. Dadurch wird die erforderliche Erweiterung, die DocumentDB-Erweiterung für VS Code, automatisch installiert.

  2. Öffnen Sie die DocumentDB-Erweiterung für VS Code .

  3. Fügen Sie den MongoDB-Server hinzu, den Sie für die Migration in die Liste "Document DB Connections " bewerten möchten.

  4. Erweitern Sie die ausgewählte Verbindung, klicken Sie dann mit der rechten Maustaste, und wählen Sie „Datenmigration...” aus. Screenshot des Kontextmenüs in Document DB-Verbindungen.

  5. Wählen Sie in der Befehlspalette die Option "Pre-Migration Assessment" für Azure Cosmos DB für MongoDB aus. Screenshot der Befehlspalette in Visual Studio Code.

  6. Der Bewertungsassistent führt Sie durch drei Schritte. Wählen Sie im Schritt " Überprüfung starten " die Option "Überprüfung ausführen " aus, um Anmeldeinformationen, Voraussetzungen und Konnektivität zu überprüfen, bevor Sie fortfahren. Screenshot des Schritts

    Wichtig

    Um eine Bewertung durchzuführen, muss der verbundene MongoDB-Benutzer die Rollen "readAnyDatabase " und "clusterMonitor " der Quellinstanz zugewiesen haben.

  7. Geben Sie im Schritt " Bewertungsdetails ausfüllen " die erforderlichen Eingaben an: Screenshot des Schritts

    • Geben Sie einen Titel in das Feld "Bewertungsname " ein.
    • Wählen Sie "vCore " aus der Dropdownliste "Angebot " aus.
    • Geben Sie den Pfad zu MongoDB-Protokollen an.

    Tipp

    Optional ermöglicht das Angeben des Protokollpfads detailliertere Ergebnisse auf Sammlungsebene. Wenn nicht angegeben, basiert das Tool auf Daten aus dem serverStatus Befehl, was nur die Featurenutzung seit dem letzten Neustart widerspiegelt. Lassen Sie nach dem letzten Serverneustart genügend Zeit verstreichen, um eine genaue Einschätzung der Arbeitslast zu ermöglichen.

    • Geben Sie den Pfad zu Datenbewertungsprotokollen an.

    Tipp

    Die Bereitstellung von Datenbewertungsprotokollen ist zwar optional, verbessert jedoch die Arbeitsauslastungserkenntnisse. Diese Protokolle werden durch das Überprüfen von Daten und das Lesen ausführlicher Protokolle generiert. Die Datenbewertung wird unabhängig als CLI ausgeführt, bevor die Migrationsbewertung initiiert wird, und der resultierende JSON-Code wird hier verwendet. Laden Sie die CLI für die Datenbewertung hier herunter.

  8. Wählen Sie "Bewertung starten" aus, um den Bewertungsprozess zu starten.

  9. Warten Sie im Schritt " Bericht abrufen ", bis die Bewertung abgeschlossen ist. Die Dauer hängt von der Größe des Quellservers ab. Screenshot des Schritts „Bericht abrufen“ im Bewertungs-Assistenten während einer Bewertung

  10. Nachdem die Bewertung abgeschlossen ist, wählen Sie "Bericht herunterladen " aus, um den HTML-Bericht abzurufen. Screenshot des Schritts „Bericht abrufen“ im Bewertungs-Assistenten nach Abschluss einer Bewertung

Anzeigen früherer Bewertungen

Die Überprüfung früherer Bewertungen kann hilfreich sein. Verwenden Sie die Registerkarte " Vergangene Bewertungen anzeigen ", um auf detaillierte historische Berichte zuzugreifen. Die Bewertungsliste enthält alle bewertungen, die auf dem aktuellen Computer für die ausgewählte Verbindung initiiert wurden.

Screenshot der Registerkarte

Häufig gestellte Fragen

Wie kann ich fortfahren, wenn der Schritt "Überprüfung ausführen" fehlschlägt?

Überprüfen Sie die in der Erweiterung angezeigte Fehlermeldung, um die Ursache des Überprüfungsfehlers zu ermitteln. Häufige Probleme sind die Unfähigkeit, eine Verbindung mit dem MongoDB-Endpunkt herzustellen, oder unzureichende Benutzerberechtigungen auf dem verbundenen Server.

Um eine Bewertung durchzuführen, stellen Sie sicher, dass der verbundene MongoDB-Benutzer die Rollen readAnyDatabase und clusterMonitor für die Quellinstanz zugewiesen sind.

Verwenden Sie grantRolesToUser, um dem aktuellen Benutzer die erforderlichen Rollen zuzuweisen.

Wie kann ich Sammlungs- und Datenbanknamen in "Featurekompatibilitätsbewertungen" anzeigen?

Der serverStatus Befehl wird für Featurekompatibilitätsbewertungen verwendet. Dieser Befehl stellt jedoch keine Datenbank- oder Sammlungsnamen bereit, wodurch verhindert wird, dass die Erweiterung sie meldet.

Um detailliertere Bewertungsergebnisse zu erzielen, führen Sie die Bewertung erneut aus, und geben Sie den Ordner mit MongoDB-Protokollen im Feld " Log Folder Path " an.

Wie kann ich meine Quellserverfirewall konfigurieren, um Konnektivitätsprobleme zu verhindern?

Stellen Sie sicher, dass die MongoDB-Quellinstanz eingehende Verbindungen von Ihrem Computer zulässt.

Wie viele Bewertungen kann ich gleichzeitig ausführen?

Es gibt keine Beschränkung auf die Anzahl der Bewertungen, die Sie gleichzeitig ausführen können. Wenn Sie jedoch mehrere Bewertungen parallel ausführen, belasten sie die Computeressourcen sowohl auf Ihrem Computer als auch auf dem Quellserver, was sich möglicherweise auf die Leistung auswirkt.

Welche Informationen sind in einem Bewertungsbericht enthalten?

Der Bericht beginnt mit wichtigen Details zur Bewertung, einschließlich einer Zusammenfassung der MongoDB-Quellumgebung. In diesem Abschnitt werden die MongoDB-Quellversion, der Lizenztyp und der Instanztyp behandelt. Außerdem werden die bewerteten Datenbanken und Sammlungen sowie deren Bewertungszusammenfassungen und Migrationsbereitschaft aufgelistet.

Ergebnisse werden in "Kritisch", " Warnung" und " Informational" kategorisiert und helfen Ihnen dabei, sie basierend auf der Wichtigkeit zu priorisieren.

Die Bewertung umfasst Überprüfungen auf:

Kategorie BESCHREIBUNG
Sammlungsoptionen Identifiziert nicht unterstützte Sammlungseinstellungen, z. B. Zeitreihenkonfigurationen und Sortierungen.
Funktionen Erkennt nicht unterstützte Datenbankbefehle, Abfragesyntax und Operatoren, einschließlich Aggregationspipelineabfragen. In der Zusätzlichen Detailspalte wird gezeigt, wie häufig jedes Feature in der Quellinstanz verwendet wurde.
Grenzwerte und Kontingente Hebt vCore-basierte Azure Cosmos DB für MongoDB-Kontingente und Einschränkungen hervor.
Indizes Markiert nicht unterstützte MongoDB-Indextypen und -eigenschaften.
Shard-Schlüssel Identifiziert nicht unterstützte Shardschlüsselkonfigurationen.

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

Hinweis

Für jeden Tag wird eine separate Protokolldatei erstellt. Standardmäßig speichert die Erweiterung die letzten sieben Protokolldateien.

Kapazitätsplanung

Clustertarif

Beginnen Sie mit einer Clusterebene, die mit den Quelldatenbankkonfigurationen übereinstimmt. Führen Sie Last- und Leistungstests durch, um das optimale Gleichgewicht zwischen Kosten und Leistung zu ermitteln.

Speicherebene

Stellen Sie sicher, dass Ihr Zielkonto mit ausreichendem Speicher bereitgestellt wird, um Ihre Datenanforderungen während und nach der Migration zu erfüllen. Beginnen Sie, indem Sie ein kleines Dataset migrieren, um den Speicherverbrauch zu bewerten, und skalieren Sie dann die Schätzung basierend auf der Gesamtdatengröße, um die erforderliche Speicherzuweisung zu ermitteln. Reservieren Sie zusätzlichen Speicherplatz, um eingehende Daten und zukünftiges Wachstum zu berücksichtigen.

Nächster Schritt