Migreringstillägg för Azure Cosmos DB för MongoDB i Azure Data Studio (förhandsversion)

Azure Cosmos DB for MongoDB-migreringstillägget hjälper dig att migrera dina MongoDB-arbetsbelastningar till Azure Cosmos DB. Du kan använda det här tillägget för att:

• Kör en utvärdering från slutpunkt till slutpunkt för din arbetsbelastning och ta reda på vilka åtgärder du behöver vidta för att migrera dina arbetsbelastningar till vCore-baserade Azure Cosmos DB för MongoDB.
• Utför migreringsåtgärden med valda databaser och samlingar till vCore-baserade Azure Cosmos DB for MongoDB.

Förutsättningar

• Ett befintligt vCore-baserat Azure Cosmos DB för MongoDB-konto.
  • Om du inte har en Azure-prenumeration skapar du ett konto kostnadsfritt.
• Senaste versionen av Azure Data Studio.
• .NET 8.0-körning installerad på klientdatorn.
• MongoDB som kör version 3.2 eller senare.
• Lägg till brandväggsundantag för källan MongoDB och det vCore-baserade Azure Cosmos DB for MongoDB-målkontot för att acceptera anslutningar från globala Azure-datacenter.
• Om du använder Database Migration Service för första gången kontrollerar du att resursprovidern Microsoft.DataMigration är registrerad i din prenumeration.
• För att köra en utvärdering ska användaren som är ansluten till MongoDB ha readAnyDatabase och clusterMonitor roller tilldelade på källinstansen.

Förbereda

Innan du påbörjar migreringen bör du planera och fatta beslut om migreringen innan du faktiskt flyttar data.

• Mer information om planering inför migrering för API:et för vCore för MongoDB finns i migreringssteg för vCore-baserade Azure Cosmos DB för MongoDB,
• För mer information om förberedelser inför migrering för MongoDB RU API, se steg för förflyttning för RU-baserade Azure Cosmos DB för MongoDB

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 Portal:

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 klickar på knappen Registrera.

Azure CLI:

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"

Installera tillägget

Installera Azure Cosmos DB for MongoDB-migreringstillägget i Azure Data Studio innan du påbörjar migreringen.

1. Öppna tilläggshanteraren i Azure Data Studio. Välj antingen tilläggsikonen eller välj Tillägg på menyn Visa.

2. Ange Cosmos i sökfältet.

3. Välj Azure Cosmos DB Migration for MongoDB-tillägget och visa dess information.

   

4. Välj Installera.

Konfigurera tilläggsinställningar

Du kan konfigurera vissa tilläggsinställningar när du har installerat tillägget. Steget är valfritt. Om inga inställningar har konfigurerats uttryckligen använder tillägget standardinställningar.

1. Gå till tillägg och välj Azure Cosmos DB-migrering för MongoDB, välj Hantera inställningar-ikonen, och välj sedan tilläggsinställningar.

   

2. Under tilläggsinställningar för det här tillägget anger du Assessment path för att ändra platsen där utvärderingsmetadata lagras. Om den lämnas tom används standardplatsen.

Ansluta till MongoDB-källan

Använd tillägget för första gången för att ansluta till den befintliga MongoDB-källinstansen. Kontrollera att du har autentiseringsuppgifterna för anslutningen för källan redo innan du startar det här avsnittet.

1. Leta upp anslutningsikonen i menyraden och välj Ny anslutning.

   

2. Fyll i följande fält i fönstret Anslutning :

   	Värde
   Anslutningstyp	Azure Cosmos DB for MongoDB
   Anslutningssträng/parametrar	Använd anslutningssträng eller parametrar för din befintliga MongoDB-källinstans.
   Servergrupp	Default
   Namn (valfritt)	Ange ett unikt namn för den här anslutningen.

3. Välj Anslut.

4. Öppna snabbmenyn för den nya anslutningen i fönstret Anslutningar. Välj sedan Hantera.

   

5. Välj Azure Cosmos DB-migrering.

   

Kör en utvärdering

Utvärderingen undersöker din aktuella MongoDB-dataegendom och användning. Utvärderingsfunktionen genererar sedan en omfattande rapport som hjälper dig att identifiera nödvändiga åtgärder innan du migrerar dina arbetsbelastningar till Azure Cosmos DB för MongoDB.

1. Leta upp och navigera till fliken Instrumentpanel . Välj sedan Utvärdera och migrera databaser.

   

2. Slutför guiden för att ange information om tillägget så att det kan utföra en utvärdering.

   

   1. I fältet Utvärderingsnamn anger du en rubrik.

   2. Välj Azure Cosmos DB-målkontot för MongoDB i listrutan Erbjudande .

   3. Ange sökvägen till MongoDB-loggar.

      Tips

      Det här är ett valfritt fält, men om du anger loggsökvägen resulterar det i mer detaljerade resultat på samlingsnivå. När loggmappen inte har angetts använder verktyget information från serverStatus kommandot för att utföra utvärderingen.

      Kommandot serverStatus returnerar endast funktionsanvändning sedan den senaste omstarten, så du måste se till att tillräckligt med tid har gått sedan den senaste serveromstarten för att få en utvärdering som korrekt återspeglar din faktiska arbetsbelastning.

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

      Tips

      Även om det här fältet är valfritt kan tillhandahållande av datautvärderingsloggar ge mer detaljerade insikter om arbetsbelastningen. Dessa loggar hämtas genom att genomsöka data och läsa utförliga loggar. Datautvärderingen körs oberoende som en CLI innan migreringsbedömningen påbörjas, och det resulterande JSON-resultatet tillhandahålls sedan här. Ladda ned CLI för datautvärdering här.

   5. Välj Kör validering för att verifiera utvärderingsindata.

3. När valideringen har slutförts väljer du Starta utvärdering för att köra utvärderingen.

   

4. Beroende på källserverns storlek tar utvärderingen några minuter. Vänta tills utvärderingen har slutförts innan du fortsätter.

   

5. När utvärderingen är klar bör du nu ha en utvärderingsrapport.

   

6. I utvärderingsrapporten väljer du instansnamnet för att granska en lista över serveromfattande problem. Välj en specifik databas för att visa problem som endast gäller för den valda databasen.

   

7. Välj Ladda ned rapport för att hämta en konsoliderad nedladdningsbar rapport.

8. Studera utvärderingsrapporten för att identifiera de åtgärder du behöver vidta för en sömlös migrering av dina arbetsbelastningar i Azure Cosmos DB för MongoDB. Innan du går vidare till nästa steg ska du se till att alla blockeringsproblem som rapporteras i utvärderingen hanteras. Om det finns några olösta problem kan du avsluta processen och hantera dem senare. När problemen har lösts kan du komma tillbaka och starta om utvärderings- och migreringsprocessen.

Utföra en migrering

Använd nu utvärderingsrapporten för att utföra en migrering av dina data från din MongoDB-källinstans till ditt målbaserade Azure Cosmos DB för MongoDB-konto.

1. På utvärderingsrapportskärmen väljer du alla databaser som du planerar att migrera. Välj sedan Nästa.

   

2. Begränsa listorna till Välj azure Cosmos DB för MongoDB-målkonto genom att filtrera efter prenumeration och sedan resursgrupp. Ange sedan de autentiseringsuppgifter som krävs för att ansluta till kontot.

   

3. Välj Testa anslutning för att verifiera autentiseringsuppgifterna för Azure Cosmos DB för MongoDB-kontot. Välj Nästa för att navigera till mappningen av samlingar från källan till målet.

4. Välj Antingen Hoppa över eller Migrera för varje samling i listan över mappningar. Samlingar som redan finns i målet markeras automatiskt med en ikon och anges till Hoppa över som standard. Välj Nästa för att konfigurera Azure Database Migration Service (DMS).

   

   Varning

   Om du väljer Att migrera en befintlig samling skrivs hela samlingen över, vilket resulterar i oåterkallelig dataförlust. Var försiktig när du väljer det här alternativet.

5. Välj en befintlig Azure Database Migration Service-instans i listrutan eller välj Skapa ny för att skapa en ny migreringstjänst. 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.

   

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

1. Välj Nästa för att visa migreringssammanfattningen. När du har granskat och bekräftat informationen väljer du Skapa schema för att skapa resurser på målkontot.

   

2. Välj Starta migrering för att initiera dataöverföringen med den valda migreringstjänsten.

   

3. I popup-fönstret Bekräfta inställningar kontrollerar du att brandväggsinställningarna uppfyller kraven. Välj OK för att bekräfta.

   

Datamigreringsuppgifterna körs på 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

1. Övervaka migreringsstatusen på instrumentpanelens sida när jobben har initierats.

   

2. Om du vill visa mer information väljer du en specifik migrering i listan över migreringar.

Övervaka offlinemigreringar

Statusen uppdateras automatiskt när alla datamigreringsuppgifter har slutförts.

När data har kopierats från källan till målet indikerar status för offlinemigreringar att det lyckades.

• Ändra anslutningssträng i dina program så att de pekar på målkontot.

Ö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. Knappen Cutover aktiveras när den inledande datainläsningen har slutförts för alla samlingar. Migreringen är för närvarande i replikeringsfasen och kopierar kontinuerligt uppdateringar från källinstansen till målinstansen för att hålla den uppdaterad 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. Övervaka replikeringsändringarna i tabellen och vänta tills mätvärdet "Replikeringsändringar tillämpade" stabiliseras. Ett stabilt "Replication Changes Played"-mått indikerar att alla uppdateringar från källan har kopierats framgångsrikt till målet.

4. Välj Cutover när replikeringsgapet är minimalt för alla samlingar och måttet 'Replikeringsändringar spelade' är stabilt.

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

6. I popup-dialogrutan. Välj Fullständig övergång.
   

   Anteckning

   Om du utför övergångsoperationen utan att verifiera att källan och målet är synkroniserade kan det leda till dataförlust.

7. Vänta tills statusen har ändrats till Lyckades.

8. Uppdatera anslutningssträng i dina program så att de pekar på målkontot.

Visa tidigare migreringar och utvärderingar

Det är ofta användbart att granska tidigare utvärderingar och migreringar. Tillägget innehåller ett gränssnitt för att granska sammanfattningar av tidigare utvärderingar och migreringar. Tillägget ger också möjlighet att granska detaljerade historiska utvärderingsrapporter.

1. Om du vill visa tidigare migreringar väljer du fliken Migreringar i verktygsfältet. Migreringslistan innehåller alla migreringar som initierades på den aktuella datorn. Du kan välja en specifik migrering i listan för att få mer information.

   

2. Om du vill visa tidigare utvärderingar väljer du fliken Utvärderingar i verktygsfältet. Listan med utvärderingar innehåller alla utvärderingar som initierades på den aktuella datorn.

   

Gå vidare