Een MongoDB-installatie evalueren en migratie naar Azure Cosmos DB voor MongoDB vCore plannen

Voer vooraf planningstaken uit en neem kritieke beslissingen voordat u uw gegevens migreert naar Azure Cosmos DB voor MongoDB vCore. Deze beslissingen zorgen ervoor dat uw migratieproces soepel verloopt.

Vereisten

• Een bestaand Azure Cosmos DB voor MongoDB vCore-cluster.
  • Als u geen Azure-abonnement hebt, maakt u gratis een account.
  • Als u een bestaand Azure-abonnement hebt, maakt u een nieuw Azure Cosmos DB voor MongoDB vCore-cluster.
• Een bestaande MongoDB-installatie.

De compatibiliteit en gereedheid van uw resources voor migratie beoordelen

Voordat u uw migratie plant, beoordeelt u de status van uw bestaande MongoDB-resources om de migratie te plannen. Gebruik de Azure Cosmos DB-migratie-extensie in VS Code om de compatibiliteit en gereedheid van uw workloads te beoordelen tijdens het plannen van de migratie van MongoDB naar Azure Cosmos DB voor MongoDB vCore. De end-to-end-evaluatie en ontdek de acties die u moet uitvoeren om uw workloads naadloos uit te voeren in Azure Cosmos DB. Het evaluatierapport bevat bevindingen op account-, database- en verzamelingsniveaus, gemarkeerd als Kritiek, Waarschuwing of Informatief op basis van zwaarte om prioriteiten vast te stellen. Het rapport bevat:

• Niet-ondersteunde functies en syntaxis: hiermee worden niet-ondersteunde MongoDB-functies, opdrachten, querysyntaxis en indextypen gevlagd, met gebruiksfrequentie om correcties te prioriteren.

• Resource-Specific aanbevelingen: elke bevindingen bevat de naam van de betrokken resource, bruikbare aanbevelingen en relevante technische details voor herstel.

• Overzicht van de omgeving: geeft een overzicht van de belangrijkste aspecten van de MongoDB-bronomgeving, zoals versie, licentie, exemplaartype en statistieken voor databases en verzamelingen.

• Compatibiliteits- en platformbeperkingen: details van Cosmos DB-specifieke quota's, limieten en mogelijke incompatibiliteiten van shardsleutels voor geshard workloads.

Een evaluatie uitvoeren

1. Installeer de Azure Cosmos DB-migratie-extensie in VS Code om aan de slag te gaan. Hiermee wordt automatisch de vereiste geïnstalleerd, de DocumentDB voor VS Code-extensie .

2. Open de DocumentDB voor VS Code-extensie .

3. Voeg de MongoDB-server toe die u wilt evalueren voor migratie naar de lijst met Document DB-verbindingen .

4. Vouw de geselecteerde verbinding uit en klik met de rechtermuisknop en kies Gegevensmigratie....

5. Selecteer In het opdrachtenpalet de optie Evaluatie vóór migratie voor Azure Cosmos DB voor MongoDB.

6. De evaluatiewizard begeleidt u door drie stappen. In de stap Validatie starten, selecteer de optie Validatie uitvoeren om referenties, vereisten en connectiviteit te controleren voordat u doorgaat.

   Belangrijk

   Als u een evaluatie wilt uitvoeren, moet de verbonden MongoDB-gebruiker beschikken over de rollen readAnyDatabase en clusterMonitor die zijn toegewezen aan het bronexemplaren.

7. Geef in de stap Details van de evaluatie invullen de benodigde invoer op:

   • Voer een titel in het veld Evaluatienaam in.
   • Selecteer vCore in de vervolgkeuzelijst Aanbieding .
   • Geef het pad naar MongoDB-logboeken op.

   Aanbeveling

   Hoewel dit optioneel is, biedt het opgeven van het logboekpad meer gedetailleerde resultaten op verzamelingsniveau. Als u dit weglaat, is het hulpprogramma afhankelijk van gegevens uit de serverStatus opdracht, die alleen het gebruik van functies weerspiegelt sinds de laatste herstart. Laat voldoende tijd verstrijken nadat de server voor het laatst opnieuw is opgestart voor een nauwkeurige beoordeling van de werklast.

   • Geef het pad naar de logboeken voor gegevensevaluatie op.

   Aanbeveling

   Hoewel dit optioneel is, worden workloadinzichten verbeterd door logboeken voor gegevensevaluaties op te geven. Deze logboeken worden gegenereerd door gegevens te scannen en uitgebreide logboeken te lezen. De gegevensevaluatie wordt onafhankelijk uitgevoerd als CLI voordat de migratie-evaluatie wordt gestart en de resulterende JSON wordt hier gebruikt. Download hier de CLI voor gegevensevaluatie.

8. Selecteer Evaluatie starten om het evaluatieproces te starten.

9. Wacht in de stap Uw rapport ophalen totdat de evaluatie is voltooid. De duur is afhankelijk van de grootte van uw bronserver.

10. Zodra de evaluatie is voltooid, selecteert u Rapport downloaden om het HTML-rapport op te halen.

Eerdere evaluaties weergeven

Het beoordelen van eerdere evaluaties kan waardevol zijn. Gebruik het tabblad Afgelopen evaluaties weergeven voor toegang tot gedetailleerde historische rapporten. De evaluatielijst bevat alle evaluaties die zijn geïnitieerd op de huidige computer voor de geselecteerde verbinding.

Veelgestelde vragen

Hoe ga ik verder als de stap Validatie uitvoeren mislukt?

Controleer het foutbericht dat wordt weergegeven in de extensie om de oorzaak van de validatiefout te bepalen. Veelvoorkomende problemen zijn een onmogelijkheid om verbinding te maken met het MongoDB-eindpunt of onvoldoende gebruikersbevoegdheden op de verbonden server.

Als u een evaluatie wilt uitvoeren, moet u ervoor zorgen dat de verbonden MongoDB-gebruiker de readAnyDatabase en clusterMonitor rollen heeft toegewezen aan het bronexemplaren.

Gebruik grantRolesToUser dit om de benodigde rollen toe te wijzen aan de huidige gebruiker.

Hoe kan ik verzamelings- en databasenamen weergeven in evaluaties voor functiecompatibiliteit?

De serverStatus opdracht wordt gebruikt voor functiecompatibiliteitsbeoordelingen. Deze opdracht biedt echter geen database- of verzamelingsnamen, waardoor de extensie deze niet kan rapporteren.

Voor gedetailleerdere evaluatieresultaten voert u de evaluatie opnieuw uit en geeft u de map op met MongoDB-logboeken in het veld Pad naar logboekmap .

Hoe configureer ik de firewall van mijn bronserver om verbindingsproblemen te voorkomen?

Zorg ervoor dat het MongoDB-bronexemplaren binnenkomende verbindingen vanaf uw computer toestaat.

Hoeveel evaluaties kan ik gelijktijdig uitvoeren?

Er is geen limiet voor het aantal evaluaties dat u tegelijkertijd kunt uitvoeren. Als u echter meerdere evaluaties parallel uitvoert, worden de rekenresources op uw computer en de bronserver parallel belast, wat mogelijk van invloed is op de prestaties.

Welke informatie is opgenomen in een evaluatierapport?

Het rapport begint met belangrijke details over de evaluatie, inclusief een samenvatting van de MongoDB-bronomgeving. In deze sectie wordt de MongoDB-bronversie, het licentietype en het exemplaartype beschreven. Ook worden de geëvalueerde databases en verzamelingen vermeld, samen met hun evaluatieoverzichten en migratiegereedheid.

Bevindingen worden gecategoriseerd in Kritiek, Waarschuwing en Informatief, zodat u prioriteit kunt geven aan deze resultaten op basis van urgentie.

De evaluatie omvat controles op:

Welk type logboeken genereert de extensie?

De extensie registreert fouten, waarschuwingen en andere diagnostische logboeken in de standaardlogboekmap:

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

Capaciteitsplanning

Clusterlaag

Begin met een clusterlaag die overeenkomt met de configuraties van de brondatabase. Voer belasting- en prestatietests uit om de optimale balans tussen kosten en prestaties te bepalen.

Opslaglaag

Zorg ervoor dat uw doelaccount is ingericht met voldoende opslag om te voldoen aan uw gegevensvereisten tijdens en na de migratie. Begin met het migreren van een kleine gegevensset om het opslagverbruik te beoordelen en schaal de schatting vervolgens op basis van de totale gegevensgrootte om de benodigde opslagtoewijzing te bepalen. Reserveer extra ruimte voor binnenkomende gegevens en toekomstige groei.

Volgende stap