Migrera MongoDB till Azure DocumentDB online med Azure DocumentDB-migreringstillägget (offentlig förhandsversion)

I den här självstudien använder du Azure DocumentDB Migration Extension i Visual Studio Code för att skapa och hantera migreringsjobb från en lokal eller molninstans av MongoDB till Azure DocumentDB. Det här tillägget tillhandahåller ett utvecklarvänligt gränssnitt för att utföra migreringar utan avbrott i tjänsten. Tillägget eliminerar behovet av ytterligare infrastruktur och erbjuder säker anslutning, nollkostnadsanvändning och detaljerad kontroll över vilka databaser och samlingar som ska migreras.

Fokus i den här artikeln ligger på att använda tilläggets integrerade arbetsflöde för att förenkla migreringsstegen direkt i Visual Studio Code. Den här metoden är perfekt för scenarier där du vill ha en strömlinjeformad, hanterad upplevelse med minimal komplexitet och maximal tillförlitlighet.

Förutsättningar

• En prenumeration på Azure

  • Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto

• Ett befintligt Azure DocumentDB-kluster

  • Om du inte har något kluster skapar du ett nytt kluster

• Installera Azure DocumentDB Migration Extension på datorn. Detta installerar automatiskt dess förutsättning, tillägget DocumentDB för Visual Studio Code.

Innan du påbörjar migreringen förbereder du ditt Azure DocumentDB-konto och din befintliga MongoDB-instans för migrering.

MongoDB-instans (källa)

• Fullfölj utvärderingen före migreringen för att avgöra om det finns inkompatibiliteter och varningar mellan din källinstans och målkonto.
• Lägg till en användare med readAnyDatabase och clusterMonitor behörigheter, såvida det inte redan finns någon. Du använder den här autentiseringsuppgiften när du skapar migreringsjobb i tillägget.

Azure DocumentDB (target)

• Samla in autentiseringsuppgifterna för Azure DocumentDB-kontot.
• Se till att användaren har createCollectionbehörigheterna , dropCollection, createIndex, insertoch listCollections .

Viktigt!

Microsoft Entra ID-autentisering stöds för närvarande inte i migreringsjobb. Använd intern DocumentDB-autentisering.

Utföra migreringen

Ansluta till källan

1. Öppna tillägget DocumentDB för VS Code .
2. Lägg till den MongoDB-server som du vill migrera till listan Med dokumentdatabasanslutningar .
3. Välj Lägg till ny anslutning.
4. I navigeringsfältet väljer du Anslutningssträng.
5. Klistra in anslutningssträngen: mongodb://<YOUR_USERNAME>:<YOUR_PASSWORD>@localhost:10260/?tls=true&tlsAllowInvalidCertificates=true&authMechanism=SCRAM-SHA-256
6. Från DocumentDB-anslutningarna väljer du anslutningen och expanderar den för att ansluta.

Anropa migreringstillägget

Du kan anropa migreringstillägget från DocumentDB-anslutningarna.

1. Högerklicka på en expanderad (ansluten) anslutning.

2. Välj Datamigrering på snabbmenyn.

   

3. Välj Migrera till Azure DocumentDB från kommandopaletten.

   

4. En migreringsguide vägleder dig genom processen.

Skapa ett migreringsjobb

Ett migreringsjobb används för att migrera en grupp samlingar från källan till målet Azure DocumentDB. Guiden skapa migreringsjobb har sex steg.

Steg 1: Skapa jobb

I det här steget anger du grundläggande information för jobbet.

• Jobbnamn: Ange ett användarvänligt namn för att identifiera migreringsjobbet.

• Migreringsläge: Välj det migreringsläge som passar bäst för ditt användningsfall.

  • Onlinemigrering kopierar insamlingsdata, vilket säkerställer att uppdateringar också replikeras under processen. Den här metoden är fördelaktig med minimal stilleståndstid, vilket möjliggör kontinuerliga åtgärder för affärskontinuitet. Använd det här alternativet när pågående åtgärder är avgörande, och att minska stilleståndstiden är en prioritet.
  • Offlinemigrering fångar en ögonblicksbild av databasen i början och erbjuder en enklare och förutsägbar metod. Det fungerar bra när du använder en statisk kopia av databasen och realtidsuppdateringar är inte nödvändiga.

  Viktigt!

  För att säkerställa lyckade onlinemigreringar från MongoDB måste ChangeStream vara aktiverat på MongoDB-källservern. Utan ChangeStream registreras inga ändringar som gjorts i data efter den första migreringen. Använd därför endast onlinemigreringsläget om ChangeStream är aktiverat på din MongoDB-källserver.

• Anslutning: Beroende på organisationens säkerhetsmandat och nätverkskonfiguration väljer du från Offentlig och Privat.

  • Använd Offentlig när käll- och målservrarna är tillgängliga via Internet via offentliga IP-adresser. Det möjliggör stöd för tjänster som kräver extern tillgänglighet.
  • Använd Privat när antingen käll- eller målservrarna är tillgängliga exklusivt via privata IP-adresser i ett virtuellt nätverk. Det förbättrar säkerheten genom att eliminera exponering för det offentliga Internet.

Klicka på Nästa när du vill fortsätta.

Steg 2: Välj mål

I det här steget väljer du ett befintligt Azure DocumentDB-konto och anger dess anslutningssträng.

1. Välj prenumerationen, resursgruppen och Azure DocumentDB-kontot i listrutorna.

2. Ange anslutningssträngen till Azure DocumentDB-kontot.

3. Kontrollera att IP-adressen som anges på skärmen är tillåten i Azure DocumentDB-brandväggen.

4. Klicka på Nästa när du vill fortsätta.

Steg 3: Välj Database Migration Service (DMS)

Azure Database Migration Service är en tjänst som migrerar data till och från Azure-dataplattformar med hjälp av molninfrastruktur för dataöverföring, i stället för att förlita sig på lokala resurser. Välj en befintlig Azure Database Migration Service-instans i listrutan eller välj Skapa DMS för att skapa en ny migreringstjänst.

Viktigt!

Kontrollera att resursprovidern Microsoft.DataMigration är registrerad i din prenumeration. Du behöver bara göra det en gång per prenumeration.

Klicka på Nästa när du vill fortsätta.

Steg 4: Konfigurera anslutning

Den här skärmen beror på vilket anslutningsläge du valde i steg 1.

Offentlig anslutning

Vid allmän uppkoppling ansluter migreringsjobbet till källan och målet med hjälp av det offentliga internet. För att aktivera kommunikation måste du uppdatera käll- och målbrandväggarna. Om du vill aktivera kommunikation från DMS-servrarna lägger du till IP-adresserna som anges på skärmen i käll- och målbrandväggarna. Mer information finns i konfigurera Azure DocumentDB-klusterbrandväggen .

Privat anslutning

I privat anslutning körs migreringsjobbet i det virtuella nätverket. För att kommunicera säkert med ditt virtuella nätverk använder vi peering för virtuella nätverk.

1. Välj prenumeration, resursgrupp och virtuellt nätverk i listrutorna.

2. Kör PowerShell-skriptet som finns på skärmen för att aktivera integrering av virtuella nätverk.

3. Klicka på Nästa när du vill fortsätta.

Steg 5: Välj samlingar

I det här steget väljer du de samlingar som ska ingå i migreringsjobbet. Välj i listan över samlingar med hjälp av sökalternativen. Samlingar som redan finns i målet markeras automatiskt Som Ja i kolumnen Finns i mål .

Tips/Råd

Se till att markera alla samlingar som du vill inkludera eftersom samlingslistan inte kan läggas till när migreringsjobbet har skapats.

Klicka på Nästa när du vill fortsätta.

Steg 6: Bekräfta och starta

Granska information om migreringsjobbet innan du väljer Starta migrering. Om informationen behöver uppdateras använder du knappen Redigera information .

När migreringsjobbet har skapats omdirigeras du automatiskt till sidan Visa befintliga jobb

Tips/Råd

Datamigreringsuppgifterna körs i Azure Database Migration Service. Därför behöver du inte vara ansluten till käll- och målmiljöerna under datamigreringen. Statusen uppdateras på instrumentpanelen med jämna mellanrum.

Övervaka befintliga migreringsjobb

Använd fliken Visa befintliga jobb för att övervaka migreringsstatusen för initierade jobb. Jobben visas baserat på den valda DMS. Använd knappen Ändra DMS för att ändra ditt val.

Statusen uppdateras automatiskt med jämna mellanrum. Offlinejobb slutförs automatiskt när de valda samlingsögonblicksbilderna kopieras till målet. Onlinemigreringarna måste dock skäras ned manuellt.

Om du vill visa samlingsvis status väljer du en rad i tabellen.

Övervaka onlinemigreringar

Onlinemigreringar, till skillnad från offlinemigreringar, slutförs inte automatiskt. I stället körs de kontinuerligt tills de har slutförts manuellt genom att välja Cutover.

Följ dessa steg i den angivna ordningen för att slutföra onlinemigreringen:

1. Övergångsknappen aktiveras när den första dataöverföringen har slutförts för alla samlingar. I det här skedet är jobbet i replikeringsfasen och kopierar kontinuerligt uppdateringar från källinstansen till målinstansen för att hålla det up-to-date med de senaste ändringarna.

2. När du är redo att utföra snabbmigreringen stoppar du alla inkommande transaktioner till källsamlingarna som migreras.

3. Replikeringsgapet visar tidsgapet mellan den senaste uppdateringen och den aktuella tiden.

4. Övervaka replikeringsändringarna i tabellen och vänta tills måttet Spelade replikeringsändringar stabiliseras. Ett stabilt mått för replikeringsändringar som spelas upp anger att alla uppdateringar från källan har kopierats till målet.

5. Välj Övergång när replikeringsgapet är minimalt för alla samlingar och parametern Utförda replikeringsändringar är stabil.

6. Verifiera manuellt att radantalet är detsamma mellan käll- och målsamlingarna.

Anmärkning

Om du utför övergången utan att verifiera att källan och målet är synkroniserade kan det resultera i dataförlust.

Registrera Microsoft.DataMigration-resursprovidern i din prenumeration

För att säkerställa att resursprovidern Microsoft.DataMigration är registrerad i din prenumeration kan du följa dessa steg:

Azure-portalen

1. Gå till Azure Portal och gå till din prenumeration.

2. I den vänstra menyn väljer du Resursprovidrar under Inställningar.

3. Sök efter Microsoft.DataMigration i sökrutan högst upp.

4. Om den inte är registrerad väljer du den och väljer knappen Registrera .

Azure CLI (kommandoradsgränssnittet för Azure)

1. Öppna Azure Cloud Shell eller din lokala terminal.

2. Registrera resursprovidern genom att köra följande kommando:

   az provider register --namespace Microsoft.DataMigration
   

PowerShell

1. Öppna Azure Cloud Shell eller din lokala PowerShell.

2. Registrera resursprovidern genom att köra följande kommando:

   Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"
   

Vanliga frågor

Varför saknas vyer i skärmsteget välj samling när Azure DocumentDB stöder vyer?

Azure DocumentDB stöder skapandet av nya vyer. Migreringstillägget stöder dock inte migrering av befintliga vyer.

När migreringen är klar kan du alltid återskapa vyerna.

Vilka samlingar och databaser utelämnas vid migrering från MongoDB till Azure DocumentDB?

Följande databaser och samlingar anses vara interna för MongoDB:

Kategori	Description
Databaser	administratör, lokal, systemkonfiguration
samlingar	Alla samlingar med prefix system.

Körs migreringsjobben lokalt på min dator?

Databaserna och samlingarna visas direkt i guidens användargränssnitt med kommandon som körs från den lokala VS Code-klienten. Den här funktionen kräver nätverksanslutning mellan datorn som kör VS Code och både käll- och målmiljöerna.

Datamigreringsuppgifter utförs av Azure Database Migration Service (DMS). DMS är en Azure-värdbaserad tjänst som samordnar och hanterar dataförflyttningsaktiviteter. När migreringsuppgifterna har skapats behöver du inte längre upprätthålla anslutningen till käll- och målmiljöerna.

Kan jag byta namn på databaser och samlingar under migreringen?

Tillägget stöder inte databas- och samlingsbyte under migreringen.

Hur ska jag konfigurera mina källserverbrandväggar för att undvika anslutningsproblem?

Vilken nätverkskonfiguration som krävs beror på det valda anslutningsläget:

• Offentligt läge: Du måste tillåta att IP-adresserna som visas i guiden på både käll- och målbrandväggarna aktiverar kommunikation.
• Privat läge: Du måste aktivera integrering av virtuella nätverk så att DMS-servrarna på ett säkert sätt kan kommunicera med käll- och målslutpunkterna i det virtuella nätverket.

Se även VS Code-anslutning

Hur många databaser och samlingar kan jag migrera i en enda migrering?

Du kan inkludera upp till 25 samlingar i en enda migrering. Du kan dock skapa och köra flera migreringsjobb för att migrera andra samlingar.

Hur många migreringsjobb kan jag köra samtidigt?

Du kan köra flera migreringsjobb när du använder offentlig åtkomst. Men när du använder privat åtkomst kan ett enda virtuellt nätverk endast ha stöd för ett aktivt jobb i taget. Om du vill köra flera jobb med privat åtkomst måste du använda olika virtuella nätverk för varje jobb.

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

Nästa steg

Skapa en Node.js webbapp