Condividi tramite

Eseguire la migrazione da Azure Cosmos DB per MongoDB (UR) ad Azure Cosmos DB per MongoDB (vCore)

  • Si applica a: MongoDB (RU)

In questa guida viene eseguita una raccolta esistente e ne viene eseguita la migrazione da Azure Cosmos DB per MongoDB (UR) ad Azure Cosmos DB per MongoDB (vCore) usando gli strumenti predefiniti per il servizio e il portale di Azure.

Prerequisiti

Configurare il Key Vault

Prima di tutto, è necessario configurare l'account Azure Cosmos DB di origine per MongoDB (RU) per archiviare le credenziali di autenticazione nativa del cluster Azure Cosmos DB per MongoDB (vCore) nel tuo insieme di chiavi esistente.

  1. Accedere al portale di Azure (https://portal.azure.com).

  2. Passare all'account di Azure Cosmos DB for Mongo DB (UR) di origine.

  3. Nell'account di origine passare a Impostazioni > Identità.

  4. Attivare l'identità gestita assegnata dal sistema per l'account di origine impostando l'opzione Statosu Sì. Prendere nota del valore dell'ID oggetto (principale) da usare più avanti in questa guida.

    Screenshot che mostra l'impostazione dell'identità gestita assegnata dal sistema o assegnata dall'utente.

    Suggerimento

    Se invece si usa un'identità gestita assegnata dall'utente, assicurarsi che almeno un'identità gestita assegnata dall'utente sia assegnata all'account di origine.

  5. Passare all'insieme di credenziali delle chiavi esistente.

  6. Se l'insieme di credenziali delle chiavi usa il modello di autorizzazioni Controllo degli accessi in base al ruolo (RBAC), selezionare l'opzione Controllo di accesso (IAM) nel menu delle risorse e assegnare il ruolo Utente segreto dell'insieme di credenziali delle chiavi all'ID entità (ID oggetto) dell'identità gestita usata per l'account di origine. In caso contrario, usare l'opzione Criteri di accesso nel menu della risorsa per creare un criterio di accesso con le autorizzazioni Recupera ed Elenca segreto , quindi assegnarlo all'ID entità (ID oggetto).

  7. Eseguire il comando per aggiornare l'account di origine per usare il meccanismo di identità preferito come identità predefinita.

    az cosmosdb update \
    --resource-group "<resource-group-name>" \
    --name "<source-account-name>" \
    --default-identity "SystemAssignedIdentity"

    Suggerimento

    Se invece si usa un'identità gestita assegnata dall'utente, eseguire questo comando:

    az cosmosdb update \
    --resource-group "<resource-group-name>" \
    --name "<source-account-name>" \
    --default-identity "UserAssignedIdentity=<fully-qualified-resource-id-of-user-assigned-managed-identity>"

  8. Tornare al Key Vault e passare a Oggetti > Segreti.

  9. Selezionare quindi Genera/Importa per creare un nuovo segreto. Usare questi valori per il segreto criptografico:

    Descrizione
    Nome I nomi dei segreti vengono usati per identificare il segreto e possono contenere solo caratteri alfanumerici e trattini. Questo valore viene infine usato nel campo Nome segreto del processo di migrazione.
    Valore del segreto Incollare qui le credenziali di autenticazione native per il cluster di destinazione Azure Cosmos DB per Mongo DB (vCore).

  10. Nel segreto appena creato, raccogliere il valore dell'URI dell'insieme di credenziali. Questo valore viene infine usato nel campo URI del Vault del processo di migrazione.

Creare un'attività di migrazione

Creare prima di tutto un processo di migrazione con la configurazione necessaria per avviare la migrazione dei dati al cluster di destinazione.

  1. Accedere al portale di Azure (https://portal.azure.com).

  2. Passare di nuovo all'account di Azure Cosmos DB for Mongo DB (UR).

  3. Nella pagina account selezionare Migrate to vCore (Esegui migrazione a vCore ) dal menu della risorsa.

    Screenshot della pagina iniziale del processo di migrazione al flusso di lavoro vCore.

  4. Selezionare Avvia un nuovo processo di migrazione.

Selezionare la modalità di migrazione

La sezione Seleziona modalità di migrazione viene usata per fornire la modalità di migrazione più appropriata per le esigenze di migrazione.

  1. Selezionare la modalità appropriata da queste opzioni:

    Descrizione
    Off-line La migrazione offline acquisisce uno snapshot della raccolta all'inizio, offrendo un approccio più semplice e prevedibile. Funziona bene quando è accettabile usare una copia statica della raccolta e gli aggiornamenti in tempo reale non sono essenziali. Usare questa opzione per le migrazioni non di produzione.
    In linea La migrazione online copia i dati della raccolta, garantendo che gli aggiornamenti vengano replicati anche durante il processo. Questo metodo è vantaggioso con tempi di inattività minimi, consentendo operazioni continue per la continuità aziendale. Usare questa opzione quando le operazioni in corso sono cruciali e la riduzione del tempo di inattività è una priorità.

    Screenshot che mostra le opzioni di selezione della modalità per un processo di migrazione.

    Annotazioni

    La migrazione online è attualmente in anteprima limitata. Registrarsi per la funzionalità di anteprima OnlineRuToVcoreMigration per la sottoscrizione di Azure. La prenotazione può richiedere un periodo di tempo prolungato. Si riceve una conferma tramite posta elettronica dopo la registrazione della funzionalità per la sottoscrizione.

    Il backup continuo è anche un prerequisito per le migrazioni online. Per altre informazioni, vedere Backup continuo.

  2. Seleziona Avanti.

Configurare le credenziali di migrazione di destinazione

La sezione Seleziona account di destinazione viene usata per fornire i dettagli di connessione al cluster Azure Cosmos DB di destinazione per Mongo DB (vCore). Come procedura consigliata per la sicurezza, è consigliabile archiviare le credenziali di autenticazione native in Azure Key Vault.

Annotazioni

Le stringhe di connessione che usano l'autenticazione MICROSOFT Entra ID non sono attualmente supportate.

  1. Impostare i campi URI dell'insieme di credenziali e Nome segreto sui valori registrati in precedenza in questa guida.

    Screenshot che mostra la sezione in cui selezionare la destinazione.

  2. Seleziona Avanti.

Aggiornare il firewall di destinazione

La sezione Aggiorna firewall di destinazione viene usata per assicurarsi che il firewall del cluster Azure Cosmos DB per Mongo DB (vCore) di destinazione non blocchi le richieste del processo di migrazione.

  1. Osservare l'indirizzo IP in questo passaggio.

    Screenshot della sezione di controllo del firewall di destinazione e dell'indirizzo IP dell'account di origine.

  2. Passare al cluster Azure Cosmos DB di destinazione per MongoDB (vCore) usando un'altra finestra o scheda del browser.

  3. Selezionare Rete nella sezione Impostazioni del menu delle risorse.

  4. Aggiungere una regola per consentire l'accesso all'indirizzo IP del processo di migrazione. Per altre informazioni, vedere Gestire le regole del firewall a livello di cluster.

  5. Tornare alla finestra o alla scheda del browser con i passaggi di configurazione del processo di migrazione.

  6. Seleziona Avanti.

Annotazioni

Se la sicurezza di rete è abilitata nel Azure Key Vault, assicurati che lo stesso indirizzo IP venga aggiunto anche al firewall di Azure Key Vault.

Configurare e avviare il processo

Usare le sezioni Seleziona raccolte e Conferma e Invia per finalizzare la configurazione del processo.

  1. Selezionare le raccolte di cui si intende eseguire la migrazione nella sezione Seleziona raccolte .

    Screenshot che mostra la sezione in cui selezionare le raccolte di cui eseguire la migrazione.

  2. Seleziona Avanti.

  3. Esaminare la configurazione del processo e specificare un nome di processo univoco.

    Importante

    1. Il processo di migrazione non trasferisce gli indici alle raccolte di destinazione. Prima di procedere, usare questo script di migrazione di esempio per creare gli indici nelle raccolte di destinazione. Quando gli indici sono pronti, selezionare la casella di controllo.
    2. Il processo di migrazione non supporta la modifica della chiave di partizione. Se è necessaria una chiave di partizione diversa, eseguire la migrazione dei dati come raccolta non partizionata. Al termine della migrazione, partizionare la raccolta nella destinazione usando la chiave di partizione desiderata.

  4. Selezionare Invia per creare e avviare il processo.

Monitorare i processi di migrazione

Una volta inviato un lavoro, è possibile tenere traccia dello stato del lavoro appena creato insieme ad altri lavori in sospeso o completati.

  1. Passare all'account di Azure Cosmos DB for MongoDB (UR) di origine.

  2. Nella pagina account selezionare Migrate to vCore (Esegui migrazione a vCore ) dal menu della risorsa.

  3. Selezionare Monitora processi di migrazione esistenti.

    Screenshot della pagina in cui è possibile monitorare o modificare i processi di migrazione esistenti.

  4. Vengono elencati tutti i processi di migrazione creati per l'account di origine corrente.

  5. Facoltativamente, per modificare lo stato di un processo, selezionare il menu di scelta rapida (..) corrispondente al processo specifico. Le opzioni includono:

    Opzione Descrizione
    pausa Sospendere temporaneamente un processo attualmente in esecuzione
    Riprendi Riprendere un processo sospeso
    Annulla Annullare definitivamente un processo attualmente in esecuzione
    Cutover Finalizzare la migrazione quando l'origine e la destinazione vengono sincronizzate

    Annotazioni

    L'opzione cutover è applicabile solo alle migrazioni online. Al termine del cutover, la sincronizzazione tra l'account di origine e il cluster di destinazione viene terminata. Dopo aver eseguito un cutover, è necessario aggiornare le credenziali nell'applicazione client per specificare come destinazione il nuovo cluster vCore di Azure Cosmos DB per MongoDB.

  • Last updated on