Migratie-extensie voor Azure Cosmos DB voor MongoDB vCore voor Azure Data Studio (preview)

Artikel
04/19/2024

De Migratie-extensie van Azure Cosmos DB voor MongoDB helpt u bij het migreren van uw MongoDB-workloads naar Azure Cosmos DB. U kunt deze extensie gebruiken om:

Voer een end-to-end evaluatie uit op uw workload en ontdek de benodigde acties die u moet ondernemen om uw workloads te migreren naar Azure Cosmos DB voor MongoDB vCore.
Voer de migratiebewerking uit met geselecteerde databases en verzamelingen naar Azure Cosmos DB voor MongoDB vCore.

Belangrijk

Momenteel biedt deze extensie geen ondersteuning voor de volgende scenario's:

Onlinemigratie voor Azure Cosmos DB voor MongoDB vCore.
Online-/offlinemigraties voor Azure Cosmos DB voor MongoDB RU.

Zie migratieopties voor meer informatie over alternatieve oplossingen voor de API voor MongoDB vCore.

Vereisten

Een bestaand Azure Cosmos DB voor MongoDB vCore-account.
- Als u geen Azure-abonnement hebt, maakt u gratis een account.
Nieuwste versie van Azure Data Studio.
MongoDB met versie 3.2 of hoger.

Voorbereiden

Voordat u de migratie start, moet u vooraf plannen en beslissingen nemen over uw migratie voordat u gegevens daadwerkelijk verplaatst.

Zie de premigratiestappen voor Azure Cosmos DB voor MongoDB vCore voor MongoDB voor meer informatie over de planning van premigratie voor de API voor MongoDB vCore.
Zie de premigratiestappen voor Azure Cosmos DB voor MongoDB RU voor meer informatie over de planning van premigratie voor de API voor MongoDB RU

De extensie installeren

Installeer de Azure Cosmos DB for MongoDB-migratie-extensie in Azure Data Studio voordat u met de migratie begint.

Open de uitbreidingsmanager in Azure Data Studio. Selecteer het uitbreidingspictogram of selecteer Extensies in het menu Beeld.
Voer Cosmos in de zoekbalk in.
Selecteer de Azure Cosmos DB-migratie voor MongoDB-extensie en bekijk de details.
Selecteer Installeren.

Extensie-instellingen configureren

U kunt enkele extensie-instellingen configureren nadat u de extensie hebt geïnstalleerd. Deze stap is optioneel. Als er geen instellingen expliciet zijn geconfigureerd, gebruikt de extensie standaardinstellingen.

Ga naar extensies en selecteer Azure Cosmos DB-migratie voor MongoDB, selecteer het pictogram Instellingen beheren en selecteer vervolgens extensie-instellingen.
Geef onder extensie-instellingen voor deze extensie de Assessment path locatie op waar de metagegevens van de evaluatie zijn opgeslagen. Als u niets opgeeft, wordt de standaardlocatie gebruikt.

Verbinding maken naar de MongoDB-bron

Gebruik de extensie voor de eerste keer om verbinding te maken met het bestaande MongoDB-bronexemplaren. Zorg ervoor dat u over de verbindingsreferenties voor de bron beschikt voordat u deze sectie start.

Zoek het verbindingspictogram in de menubalk en selecteer Nieuwe Verbinding maken ion.

Vul in het deelvenster Verbinding maken ion de volgende velden in:

	Weergegeven als
Verbindingstype	`Azure Cosmos DB for MongoDB`
tekenreeks/parameters voor Verbinding maken ion	Gebruik de verbindingsreeks of parameters voor uw bestaande MongoDB-bronexemplaren.
Servergroep	`Default`
Naam (optioneel)	Geef een unieke naam op voor deze verbinding.

Selecteer Verbinding maken.
Open het contextmenu voor de nieuwe verbinding in het deelvenster Verbinding maken ions. Selecteer Vervolgens Beheren.
Selecteer Azure Cosmos DB-migratie.

Een evaluatie uitvoeren

De evaluatie onderzoekt uw huidige MongoDB-gegevensdomein en -gebruik. De evaluatiefunctie genereert vervolgens een uitgebreid rapport waarmee u de benodigde acties kunt identificeren voordat u uw workloads migreert naar Azure Cosmos DB voor MongoDB.

Zoek en navigeer naar het tabblad Dashboard . Selecteer vervolgens Databases evalueren en migreren.
Voltooi de wizard om details op te geven voor de extensie, zodat deze een evaluatie kan uitvoeren.
1. Voer in het veld Evaluatienaam een titel in.
2. Selecteer het Azure Cosmos DB-doelaccount voor MongoDB in de vervolgkeuzelijst Aanbieding .
3. Geef het pad naar MongoDB-logboeken op.
  
  Tip
  
  Dit is een optioneel veld, zodat het logboekpad meer gedetailleerde inzichten oplevert op het niveau van de verzameling. Wanneer de logboekmap niet is opgegeven, is het hulpprogramma afhankelijk van informatie uit de serverStatus opdracht voor de evaluatie. Houd er rekening mee dat de opdracht 'serverStatus' alleen het gebruik van functies rapporteert sinds de laatste server opnieuw is opgestart. Als u een evaluatie wilt verkrijgen die uw werkelijke workload nauwkeurig weergeeft, moet u ervoor zorgen dat er voldoende tijd is verstreken sinds het opnieuw opstarten van de server.
4. Geef het pad op naar de logboeken voor gegevensevaluatie.
  
  Tip
  
  Hoewel dit veld optioneel blijft, kunnen gegevensevaluatielogboeken uitgebreidere inzichten bieden in de workload. Deze logboeken worden verkregen door gegevens te scannen en gedetailleerde logboeken te bekijken. De gegevensevaluatie wordt onafhankelijk uitgevoerd als een opdrachtregelinterface (CLI) voordat de migratie-evaluatie wordt gestart en de resulterende JSON wordt vervolgens hier gegeven. Download hier de CLI voor gegevensevaluatie.
5. Selecteer Validatie uitvoeren om de evaluatie-invoer te valideren.
Zodra de validatie is geslaagd, selecteert u Evaluatie starten om de evaluatie uit te voeren.
Afhankelijk van de grootte van uw bronserver duurt de evaluatie enkele minuten. Wacht totdat de evaluatie is voltooid voordat u doorgaat.
Nadat de evaluatie is voltooid, moet u nu een evaluatierapport hebben.
Selecteer in het evaluatierapport de naam van het exemplaar om een lijst met problemen op de server te bekijken. Selecteer een specifieke database om problemen weer te geven die alleen van toepassing zijn op de geselecteerde database.
Selecteer Rapport downloaden om een geconsolideerd downloadbaar rapport op te halen.
Onderzoek het evaluatierapport om te bepalen welke acties u moet uitvoeren voor een naadloze migratie van uw workloads in Azure Cosmos DB voor MongoDB. Voordat u naar de volgende stap gaat, moet u ervoor zorgen dat alle blokkeringsproblemen die in de evaluatie worden gerapporteerd, worden afgehandeld. Als er onopgeloste problemen zijn, kunt u het proces afsluiten en later afhandelen. Zodra de problemen zijn opgelost, kunt u terugkomen en de evaluatie en het migratieproces opnieuw starten.

Een offlinemigratie uitvoeren

Gebruik nu het evaluatierapport om een offlinemigratie van uw gegevens uit uw MongoDB-bronexemplaren uit te voeren naar uw Azure Cosmos DB voor MongoDB vCore-account.

Selecteer in het scherm evaluatierapport alle databases die u wilt migreren. Selecteer vervolgens Volgende.
Verfijn de lijsten om het Azure Cosmos DB-doelaccount voor MongoDB te selecteren door te filteren op abonnement en vervolgens op resourcegroep. Geef vervolgens de verbindingsreferenties op die nodig zijn om verbinding te maken met het account.
Selecteer Verbinding testen om de referenties voor het Azure Cosmos DB voor MongoDB-account te valideren. Selecteer Volgende om naar de toewijzing van verzamelingen van de bron naar het doel te navigeren.
Belangrijk

Momenteel biedt de extensie geen ondersteuning voor bron- of doelexemplaren voor privé-eindpunten.
- Configureer het MongoDB-bronexemplaren om verbindingen vanuit globale Azure-datacenters toe te staan.
- Voeg firewalluitzonderingen toe aan het Doelaccount van Azure Cosmos DB voor MongoDB vCore om verbindingen vanuit globale Azure-datacenters toe te laten.
- Als u de relevante IP-bereikgegevens wilt vinden, downloadt u JSON uit de globale Azure IP-adresbereiken en zoekt u naar 'AzureCloud.{ Doelregio cosmos DB-account} in het JSON-bestand.
Kies Overslaan of migreren voor elke verzameling in de lijst met toewijzingen. Verzamelingen die al in het doel aanwezig zijn, worden automatisch gemarkeerd met een pictogram en standaard ingesteld op Overslaan . Selecteer Volgende om de Azure Database Migration Service (DMS) te configureren.

Waarschuwing

Als u een bestaande verzameling migreert, wordt de hele verzameling overschreven, wat resulteert in onherstelbaar gegevensverlies. Wees voorzichtig bij het kiezen van deze optie.
Kies een bestaand Exemplaar van Azure Database Migration Service in de vervolgkeuzelijst of selecteer Nieuw maken om een nieuwe migratieservice te maken. Azure Database Migration Service is een service die gegevens naar en van Azure-gegevensplatforms migreert met behulp van de cloudinfrastructuur voor gegevensoverdracht, in plaats van te vertrouwen op lokale resources.

Belangrijk

Als u Database Migration Service voor de eerste keer gebruikt, moet u ervoor zorgen dat de Resourceprovider Microsoft.DataMigration is geregistreerd in uw abonnement.
Selecteer Volgende om het migratieoverzicht weer te geven. Nadat u de details hebt gecontroleerd en bevestigd, selecteert u Schema maken om resources te maken in het doelaccount.
Selecteer Migratie starten om de gegevensoverdracht te starten met behulp van de geselecteerde migratieservice.
Bekijk de migratiestatus op de dashboardpagina zodra de taken zijn geïnitialiseerd.
Selecteer een specifieke migratie in de lijst met migraties om meer details weer te geven. Wacht totdat de migratie is voltooid voordat u doorgaat.

Notitie

U hoeft niet verbonden te blijven met de migratieservice of Azure Data Studio terwijl de migratietaken op afstand en asynchroon worden uitgevoerd. De migratietaken worden uitgevoerd op de migratieservice en de status wordt regelmatig bijgewerkt op het dashboard.

Als u meer dan 50 verzamelingen hebt geselecteerd om te migreren, wordt de migratietaak gebatcheerd in meerdere taken in de migratieservice, elk met maximaal 50 verzamelingen.
Zodra de taak is voltooid, geeft de migratiestatus aan dat de taak is voltooid.

Vorige migraties en evaluaties weergeven

Het is vaak handig om eerdere evaluaties en migraties te bekijken. De extensie biedt een interface voor het controleren van samenvattingen van eerdere evaluatie en migraties. De extensie biedt ook de mogelijkheid om gedetailleerde historische evaluatierapporten te bekijken.

Als u eerdere migraties wilt weergeven, selecteert u het tabblad Migraties op de werkbalk. De lijst met migraties bevat alle migraties die zijn gestart op de huidige computer. U kunt een specifieke migratie in de lijst selecteren voor meer informatie.
Als u eerdere evaluaties wilt bekijken, selecteert u het tabblad Evaluaties op de werkbalk. De lijst met evaluaties bevat alle evaluaties die zijn geïnitieerd op de huidige computer.