Migreringstillägget azure Cosmos DB for MongoDB vCore för Azure Data Studio (förhandsversion)

Artikel
04/19/2024

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 Azure Cosmos DB för MongoDB vCore.
Utför migreringsåtgärden med valda databaser och samlingar till Azure Cosmos DB för MongoDB vCore.

Viktigt!

Det här tillägget stöder för närvarande inte följande scenarier:

Onlinemigrering för Azure Cosmos DB för MongoDB vCore.
Online-/offlinemigreringar för Azure Cosmos DB för MongoDB RU.

Mer information om alternativa lösningar för API:et för virtuella MongoDB-kärnor finns i migreringsalternativ.

Förutsättningar

Ett befintligt Azure Cosmos DB för MongoDB vCore-konto.
- Om du inte har en Azure-prenumeration skapar du ett konto kostnadsfritt.
Senaste versionen av Azure Data Studio.
MongoDB som kör version 3.2 eller senare.

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 före utvandring för API:et för virtuell MongoDB-kärna finns i steg för förflyttning för Azure Cosmos DB för MongoDB vCore,
Mer information om planering före utvandring för API:et för MongoDB RU finns i steg för förflyttning för Azure Cosmos DB för MongoDB RU

Installera tillägget

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

Öppna tilläggshanteraren i Azure Data Studio. Välj antingen tilläggsikonen eller välj Tillägg på menyn Visa.
Ange Cosmos i sökfältet.
Välj Azure Cosmos DB Migration for MongoDB-tillägget och visa dess information.
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.

Gå till tillägg och välj Azure Cosmos DB-migrering för MongoDB, välj ikonen Hantera inställningar och välj sedan tilläggsinställningar.
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.

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

Leta upp anslutningsikonen i menyraden och välj Ny Anslut ion.

I fönstret Anslut ion fyller du i följande fält:

	Värde
Anslutningstyp	`Azure Cosmos DB for MongoDB`
Anslut ionssträ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.

Välj Anslut.
Öppna snabbmenyn för den nya anslutningen i fönstret Anslut ions. Välj sedan Hantera.
Välj Azure Cosmos DB-migrering.

Köra 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.

Leta upp och navigera till fliken Instrumentpanel . Välj sedan Utvärdera och migrera databaser.
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.
  
  Dricks
  
  Det här är ett valfritt fält som ger loggsökvägen mer detaljerade insikter på samlingsnivå. När loggmappen inte har angetts förlitar sig verktyget på information från serverStatus kommandot för utvärderingen. Tänk på att kommandot "serverStatus" endast rapporterar funktionsanvändning sedan den senaste omstarten av servern. För att få en utvärdering som korrekt återspeglar din faktiska arbetsbelastning kontrollerar du att tillräckligt med tid har förflutit sedan den senaste serveromstarten.
4. Ange sökvägen till datautvärderingsloggar.
  
  Dricks
  
  Även om det här fältet fortfarande är valfritt, kan inklusive datautvärderingsloggar ge mer omfattande insikter om arbetsbelastningen. Dessa loggar hämtas genom att genomsöka data och granska detaljerade loggar. Datautvärderingen körs oberoende av varandra som ett kommandoradsgränssnitt (CLI) innan migreringsutvärderingen initieras, och den resulterande JSON:n tillhandahålls därefter här. Ladda ned CLI för datautvärdering här.
5. Välj Kör validering för att verifiera utvärderingsindata.
När valideringen har slutförts väljer du Starta utvärdering för att köra utvärderingen.
Beroende på källserverns storlek tar utvärderingen några minuter. Vänta tills utvärderingen har slutförts innan du fortsätter.
När utvärderingen är klar bör du nu ha en utvärderingsrapport.
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.
Välj Ladda ned rapport för att hämta en konsoliderad nedladdningsbar rapport.
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 offlinemigrering

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

På utvärderingsrapportskärmen väljer du alla databaser som du planerar att migrera. Välj sedan Nästa.
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.
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.
Viktigt!

Tillägget stöder för närvarande inte privata slutpunktsaktiverade käll- eller mål-MongoDB-instanser.
- Konfigurera MongoDB-källinstansen så att den tillåter anslutningar från globala Azure-datacenter.
- Lägg till brandväggsundantag till målkontot Azure Cosmos DB for MongoDB vCore för att tillåta anslutningar från globala Azure-datacenter.
- Om du vill hitta relevant IP-intervallinformation laddar du ned JSON från globala Azure IP-adressintervall och letar efter "AzureCloud.{ Mål cosmos DB-kontoregion}" i JSON-filen.
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.
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.

Viktigt!

Om du använder Database Migration Service för första gången kontrollerar du att resursprovidern Microsoft.DataMigration är registrerad i din prenumeration.
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.
Välj Starta migrering för att initiera dataöverföringen med den valda migreringstjänsten.
Visa migreringsstatusen på instrumentpanelens sida när jobben har initierats.
Välj en specifik migrering från listan över migreringar för att visa mer information. Vänta tills migreringen har slutförts innan du fortsätter.

Kommentar

Du behöver inte vara ansluten till migreringstjänsten eller Azure Data Studio medan migreringsjobben körs via fjärranslutning och asynkront. Migreringsjobben körs på migreringstjänsten och statusen uppdateras på instrumentpanelen med jämna mellanrum.

Om du har valt fler än 50 samlingar att migrera, batchas migreringsjobbet till flera jobb i migreringstjänsten, som var och en innehåller högst 50 samlingar.
När jobbet är klart anger migreringsstatusen att det lyckades.

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.

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