Estensione di migrazione vCore di Azure Cosmos DB per MongoDB per Azure Data Studio (anteprima)

Articolo
04/19/2024

L'estensione per la migrazione di Azure Cosmos DB per MongoDB consente di eseguire la migrazione dei carichi di lavoro MongoDB ad Azure Cosmos DB. È possibile usare questa estensione per:

Eseguire una valutazione end-to-end sul carico di lavoro e scoprire le azioni necessarie da eseguire per eseguire la migrazione dei carichi di lavoro ad Azure Cosmos DB per MongoDB vCore.
Eseguire l'operazione di migrazione con database e raccolte selezionati in Azure Cosmos DB per MongoDB vCore.

Importante

Attualmente questa estensione non supporta gli scenari seguenti:

Migrazione online per Azure Cosmos DB per MongoDB vCore.
Migrazioni online/offline per Azure Cosmos DB per MongoDB UR.

Per altre informazioni sulle soluzioni alternative per l'API per mongoDB vCore, vedere Opzioni di migrazione.

Prerequisiti

Un account vCore di Azure Cosmos DB per MongoDB esistente.
- Se non si ha un abbonamento ad Azure, creare un account gratuitamente.
Versione più recente di Azure Data Studio.
MongoDB che esegue la versione 3.2 o successiva.

Preparazione

Prima di avviare la migrazione, eseguire la pianificazione iniziale e il processo decisionale sulla migrazione prima di spostare effettivamente i dati.

Per altre informazioni sulla pianificazione delle premigration per l'API per MongoDB vCore, vedere Passaggi di premigration per Azure Cosmos DB per MongoDB vCore,
Per altre informazioni sulla pianificazione della premigration per l'API per MongoDB UR, vedere Passaggi di premigration per Azure Cosmos DB per MongoDB UR

Installare l'estensione

Installare l'estensione di migrazione di Azure Cosmos DB per MongoDB in Azure Data Studio prima di iniziare la migrazione.

Aprire Gestione estensioni in Azure Data Studio. Selezionare l'icona delle estensioni o selezionare Estensioni nel menu Visualizza.
Inserire Cosmos nella barra di ricerca.
Selezionare l'estensione Migrazione Azure Cosmos DB per Mongo DB e visualizzarne i dettagli.
Selezionare Installa.

Configurare le impostazioni dell'estensione

È possibile configurare alcune impostazioni di estensione dopo l'installazione dell'estensione. Questo passaggio è facoltativo. Se non sono configurate impostazioni in modo esplicito, l'estensione usa le impostazioni predefinite.

Passare alle estensioni e selezionare Azure Cosmos DB Migration per Mongo DB, selezionare l'icona gestisci impostazioni e quindi selezionare le impostazioni di estensione.
In Impostazioni di estensione per questa estensione specificare per Assessment path modificare il percorso in cui sono archiviati i metadati di valutazione. Se lasciato vuoto, viene usata la posizione predefinita.

Connessione all'origine MongoDB

Usare l'estensione per la prima volta per connettersi all'istanza "source" di MongoDB esistente. Assicurarsi di avere le credenziali di connessione per l'origine pronte prima di iniziare questa sezione.

Individuare l'icona connessioni nella barra dei menu e selezionare Nuovo Connessione ion.

Nel riquadro Connessione ion compilare i campi seguenti:

	Valore
Tipo di connessione	`Azure Cosmos DB for MongoDB`
stringa/parametri di Connessione ion	Usare il stringa di connessione o i parametri per l'istanza di MongoDB di origine esistente.
Gruppo server	`Default`
Nome (facoltativo)	Specificare un nome univoco per questa connessione.

Selezionare Connetti.
Aprire il menu di scelta rapida per la nuova connessione nel riquadro Connessione ions. Selezionare quindi Gestisci.
Selezionare Migrazione di Azure Cosmos DB.

Eseguire una valutazione

La valutazione esamina il patrimonio di dati e l'utilizzo correnti di MongoDB. La funzionalità di valutazione genera quindi un report completo che consente di identificare le azioni necessarie da intraprendere prima di eseguire la migrazione dei carichi di lavoro ad Azure Cosmos DB per MongoDB.

Individuare e passare alla scheda Dashboard . Selezionare quindi Valuta ed esegui la migrazione di database.
Completare la procedura guidata per fornire i dettagli all'estensione in modo che possa eseguire una valutazione.
1. Nel campo Nome valutazione immettere un titolo.
2. Selezionare l'account Azure Cosmos DB di destinazione per MongoDB dall'elenco a discesa Offerta .
3. Specificare il percorso dei log di MongoDB.
  
  Suggerimento
  
  Si tratta di un campo facoltativo, che fornisce al percorso dei log informazioni più dettagliate a livello di raccolta. Quando la cartella di log non viene specificata, lo strumento si basa sulle informazioni del serverStatus comando per la valutazione. Tenere presente che il comando "serverStatus" segnala l'utilizzo delle funzionalità solo dopo l'ultimo riavvio del server. Per ottenere una valutazione che rifletta accuratamente il carico di lavoro effettivo, assicurarsi che sia trascorso tempo sufficiente dopo il riavvio del server più recente.
4. Specificare il percorso dei log di valutazione dei dati.
  
  Suggerimento
  
  Anche se questo campo rimane facoltativo, inclusi i log di valutazione dei dati, può offrire informazioni più complete sul carico di lavoro. Questi log vengono acquisiti analizzando i dati ed esaminando i log dettagliati. La valutazione dei dati viene eseguita in modo indipendente come interfaccia della riga di comando (CLI) prima di avviare la valutazione della migrazione e il codice JSON risultante viene successivamente fornito qui. Scaricare l'interfaccia della riga di comando per la valutazione dei dati qui.
5. Selezionare Esegui convalida per convalidare gli input di valutazione.
Al termine della convalida, selezionare Avvia valutazione per eseguire la valutazione.
A seconda delle dimensioni del server di origine, la valutazione richiede alcuni minuti. Attendere il completamento della valutazione prima di continuare.
Al termine della valutazione, si dovrebbe disporre di un report di valutazione.
Nel report di valutazione selezionare il nome dell'istanza per esaminare un elenco di problemi a livello di server. Selezionare un database specifico per visualizzare i problemi applicabili solo al database selezionato.
Selezionare Scarica report per ottenere un report scaricabile consolidato.
Esaminare il report di valutazione per identificare le azioni da intraprendere per una migrazione senza problemi dei carichi di lavoro in Azure Cosmos DB per MongoDB. Prima di passare al passaggio successivo, assicurarsi che vengano gestiti tutti i problemi di blocco segnalati nella valutazione. Se si verificano problemi non risolti, è possibile uscire dal processo e gestirli in un secondo momento. Dopo aver risolto i problemi, è possibile tornare e riavviare il processo di valutazione e migrazione.

Eseguire una migrazione offline

Usare ora il report di valutazione per eseguire una migrazione offline dei dati dall'istanza di MongoDB di origine all'account vCore di Azure Cosmos DB per MongoDB di destinazione.

Nella schermata del report di valutazione selezionare tutti i database di cui si intende eseguire la migrazione. Quindi seleziona Avanti.
Restringere gli elenchi per selezionare l'account Azure Cosmos DB di destinazione per MongoDB filtrando in base alla sottoscrizione e quindi al gruppo di risorse. Specificare quindi tutte le credenziali di connessione necessarie per connettersi all'account.
Selezionare Test connessione per convalidare le credenziali per l'account Azure Cosmos DB per MongoDB. Selezionare Avanti per passare al mapping delle raccolte dall'origine alla destinazione.
Importante

Attualmente l'estensione non supporta l'origine abilitata per l'endpoint privato o le istanze di MongoDB di destinazione.
- Configurare l'istanza di MongoDB di origine per consentire le connessioni dai data center globali di Azure.
- Aggiungere eccezioni del firewall all'account di destinazione vCore di Azure Cosmos DB per MongoDB per consentire le connessioni dai data center di Azure globali.
- Per individuare le informazioni pertinenti sull'intervallo IP, scaricare JSON dagli intervalli di indirizzi IP di Azure globali e cercare "AzureCloud.{ Specificare l'area dell'account Cosmos DB}" all'interno del file JSON.
Scegliere Ignora o Esegui migrazione per ogni raccolta nell'elenco dei mapping. Le raccolte già presenti nella destinazione vengono contrassegnate automaticamente con un'icona e impostate su Ignora per impostazione predefinita. Selezionare Avanti per configurare il Servizio Migrazione del database di Azure (SERVIZIO Migrazione del database).

Avviso

Il consenso esplicito alla migrazione di una raccolta esistente sovrascriverà l'intera raccolta, causando una perdita irreversibile di dati. Prestare attenzione quando si sceglie questa opzione.
Scegliere un'istanza di Servizio Migrazione del database di Azure esistente dall'elenco a discesa oppure selezionare Crea nuovo per creare un nuovo servizio di migrazione. Servizio Migrazione del database di Azure è un servizio che esegue la migrazione dei dati da e verso piattaforme dati di Azure usando l'infrastruttura cloud per il trasferimento dei dati, invece di basarsi sulle risorse locali.

Importante

Se si usa Servizio Migrazione del database per la prima volta, assicurarsi che il provider di risorse Microsoft.DataMigration sia registrato nella sottoscrizione.
Selezionare Avanti per visualizzare il riepilogo della migrazione. Dopo aver esaminato e confermato i dettagli, selezionare Crea schema per creare risorse nell'account di destinazione.
Selezionare Avvia migrazione per avviare il trasferimento dei dati usando il servizio di migrazione selezionato.
Visualizzare lo stato della migrazione nella pagina del dashboard dopo l'inizializzazione dei processi.
Selezionare una migrazione specifica dall'elenco delle migrazioni per visualizzare altri dettagli. Attendere il completamento della migrazione prima di continuare.

Nota

Non è necessario rimanere connessi al servizio di migrazione o ad Azure Data Studio mentre i processi di migrazione vengono eseguiti in modalità remota e asincrona. I processi di migrazione vengono eseguiti nel servizio di migrazione e lo stato verrà aggiornato nel dashboard a intervalli frequenti.

Se sono state selezionate più di 50 raccolte di cui eseguire la migrazione, il processo di migrazione verrà inserito in batch in più processi nel servizio di migrazione, ognuno contenente un massimo di 50 raccolte.
Al termine del processo, lo stato della migrazione indica l'esito positivo.

Visualizzare le migrazioni e le valutazioni precedenti

Spesso è utile esaminare le valutazioni e le migrazioni precedenti. L'estensione fornisce un'interfaccia per esaminare i riepiloghi delle valutazioni e delle migrazioni precedenti. L'estensione offre anche la possibilità di esaminare report di valutazione cronologici dettagliati.

Per visualizzare le migrazioni passate, selezionare la scheda Migrazioni sulla barra degli strumenti. L'elenco delle migrazioni contiene tutte le migrazioni avviate nel computer corrente. È possibile selezionare una migrazione specifica nell'elenco per ottenere altri dettagli.
Per visualizzare le valutazioni precedenti, selezionare la scheda Valutazioni sulla barra degli strumenti. L'elenco delle valutazioni contiene tutte le valutazioni avviate nel computer corrente.