Utvärdera en MongoDB-installation och planera för migrering till Azure Cosmos DB för MongoDB vCore

Utför planeringsaktiviteter i förväg och fatta viktiga beslut innan du migrerar dina data till Azure Cosmos DB för MongoDB vCore. De här besluten gör att migreringsprocessen går smidigt.

Förutsättningar

• Ett befintligt Azure Cosmos DB för MongoDB vCore-kluster.
  • Om du inte har en Azure-prenumeration skapar du ett konto kostnadsfritt.
  • Om du har en befintlig Azure-prenumeration skapar du ett nytt Azure Cosmos DB för MongoDB vCore-kluster.
• En befintlig MongoDB-installation.

Utvärdera kompatibiliteten och beredskapen för dina resurser för migrering

Innan du planerar migreringen bör du utvärdera tillståndet för dina befintliga MongoDB-resurser för att planera migreringen. Använd Azure Cosmos DB-migreringstillägget i VS Code för att utvärdera kompatibiliteten och beredskapen för dina arbetsbelastningar när du planerar migreringen från MongoDB till Azure Cosmos DB för MongoDB vCore. Utvärderingen från slutpunkt till slutpunkt och ta reda på vilka åtgärder du behöver vidta för att smidigt köra dina arbetsbelastningar i Azure Cosmos DB. Utvärderingsrapporten visar resultat på konto-, databas- och insamlingsnivå, var och en markerad som Kritisk, Varning eller Informationsbaserad baserat på allvarlighetsgrad för prioritering av stöd. Rapporten innehåller:

• Funktioner och syntax som inte stöds: Det flaggar mongoDB-funktioner, kommandon, frågesyntax och indextyper som inte stöds, med användningsfrekvens för att prioritera korrigeringar.

• Resource-Specific Rekommendationer: Varje sökning innehåller det berörda resursnamnet, åtgärdsrekommendationer och relevant teknisk information för reparation.

• Miljööversikt: Sammanfattar viktiga aspekter av MongoDB-källmiljön, till exempel version, licens, instanstyp och statistik för databaser och samlingar.

• Kompatibilitets- och plattformsbegränsningar: Information om Cosmos DB-specifika kvoter, gränser och potentiella inkompatibiliteter för shardnycklar för fragmenterade arbetsbelastningar.

Köra en utvärdering

1. Kom igång genom att installera Azure Cosmos DB-migreringstillägget i VS Code. Detta installerar automatiskt dess förutsättning, tillägget DocumentDB för VS Code.

2. Öppna tillägget DocumentDB för VS Code .

3. Lägg till den MongoDB-server som du vill utvärdera för migrering till listan Över dokumentdatabasanslutningar .

4. Expandera den valda anslutningen och högerklicka och välj Datamigrering....

5. På kommandopaletten väljer du Utvärdering före migrering för Azure Cosmos DB för MongoDB.

6. Utvärderingsguiden vägleder dig genom tre steg. I steget Starta validering väljer du Kör validering för att verifiera autentiseringsuppgifter, krav och anslutning innan du fortsätter.

   Viktigt!

   För att kunna utföra en utvärdering måste den anslutna MongoDB-användaren ha rollerna readAnyDatabase och clusterMonitor tilldelade på källinstansen.

7. I steget Fyll i utvärderingsinformation anger du nödvändiga indata:

   • Ange en rubrik i fältet Utvärderingsnamn .
   • Välj vCore i listrutan erbjudande.
   • Ange sökvägen till MongoDB-loggar.

   Dricks

   Även om det är valfritt kan du ange loggsökvägen för mer detaljerade resultat på samlingsnivå. Om det utelämnas förlitar sig verktyget på data från serverStatus kommandot, vilket endast återspeglar funktionsanvändningen sedan den senaste omstarten. Tillåt tillräckligt med tid för att passera efter den senaste serveromstarten för en korrekt arbetsbelastningsbedömning.

   • Ange sökvägen till datautvärderingsloggar.

   Dricks

   Även om det är valfritt, förbättrar tillhandahållande av datautvärderingsloggar arbetsbelastningsinsikter. Dessa loggar genereras genom genomsökning av data och läsning av utförliga loggar. Datautvärderingen körs oberoende av CLI innan migreringsutvärderingen initieras, och den resulterande JSON används här. Ladda ned CLI för datautvärdering här.

8. Välj Starta utvärdering för att påbörja utvärderingsprocessen.

9. I steget Hämta din rapport väntar du tills utvärderingen har slutförts. Varaktigheten beror på källserverns storlek.

10. När utvärderingen är klar väljer du Ladda ned rapport för att hämta HTML-rapporten.

Visa tidigare utvärderingar

Det kan vara värdefullt att granska tidigare utvärderingar. Använd fliken Visa tidigare utvärderingar för att få åtkomst till detaljerade historiska rapporter. Utvärderingslistan innehåller alla utvärderingar som initierats på den aktuella datorn för den valda anslutningen.

Vanliga frågor

Hur fortsätter jag om steget "Kör validering" misslyckas?

Kontrollera felmeddelandet som visas i tillägget för att fastställa orsaken till verifieringsfelet. Vanliga problem är att det inte går att ansluta till MongoDB-slutpunkten eller otillräcklig användarbehörighet på den anslutna servern.

Om du vill köra en utvärdering kontrollerar du att den anslutna MongoDB-användaren har tilldelats readAnyDatabase rollerna och clusterMonitor på källinstansen.

Använd grantRolesToUser för att tilldela nödvändiga roller till den aktuella användaren.

Hur visar jag samlings- och databasnamn i utvärderingar om funktionskompatibilitet?

Kommandot serverStatus används för funktionskompatibilitetsbedömningar. Det här kommandot tillhandahåller dock inte databas- eller samlingsnamn, vilket hindrar tillägget från att rapportera dem.

Om du vill ha mer detaljerade utvärderingsresultat kör du utvärderingen igen och anger mappen som innehåller MongoDB-loggar i fältet Sökväg till loggmapp .

Hur konfigurerar jag min källserverbrandvägg för att förhindra anslutningsproblem?

Kontrollera att MongoDB-källinstansen tillåter inkommande anslutningar från datorn.

Hur många utvärderingar kan jag köra samtidigt?

Det finns ingen gräns för hur många utvärderingar du kan köra samtidigt. Men om du kör flera utvärderingar parallellt belastas beräkningsresurserna på både datorn och källservern, vilket kan påverka prestandan.

Vilken information ingår i en utvärderingsrapport?

Rapporten börjar med viktig information om utvärderingen, inklusive en sammanfattning av MongoDB-källmiljön. Det här avsnittet beskriver mongoDB-källans version, licenstyp och instanstyp. Den innehåller också en lista över de utvärderade databaserna och samlingarna, tillsammans med deras utvärderingssammanfattningar och migreringsberedskap.

Resultaten kategoriseras i Kritisk, Varning och Information, vilket hjälper dig att prioritera dem baserat på prioritet.

Utvärderingen omfattar kontroller av:

Vilken typ av loggar genererar tillägget?

Tillägget registrerar fel, varningar och andra diagnostikloggar i standardloggkatalogen:

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

Kapacitetsplanering

Klusternivå

Börja med en klusternivå som överensstämmer med dina källdatabaskonfigurationer. Utför belastnings- och prestandatester för att fastställa den optimala balansen mellan kostnad och prestanda.

Lagringsnivå

Se till att målkontot har tilldelats tillräcklig lagring för att möta dina datakrav under och efter migreringen. Börja med att migrera en liten datamängd för att utvärdera lagringsförbrukningen och skala sedan uppskattningen baserat på den totala datastorleken för att fastställa den nödvändiga lagringsallokeringen. Reservera extra utrymme för inkommande data och framtida tillväxt.

Gå vidare