Condividi tramite

Eseguire la migrazione da Azure Cosmos DB per MongoDB ad Azure DocumentDB

  • Si applica a: MongoDB

In questa guida si esegue la migrazione di una raccolta esistente da Azure Cosmos DB per MongoDB ad Azure DocumentDB usando gli strumenti predefiniti per il servizio e il portale di Azure.

Prerequisiti

Configurare Azure Key Vault

Prima di tutto, è necessario configurare l'account Azure Cosmos DB di origine per MongoDB per memorizzare le credenziali di autenticazione nativa del cluster di destinazione di Azure Cosmos DB nel Key Vault esistente.

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

  2. Vai al tuo account Azure Cosmos DB di origine per MongoDB.

  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 della pagina Impostazioni identità del portale di Azure che mostra le opzioni di configurazione dell'identità gestita assegnata dal sistema.

    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:

    Description
    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 Incolla le credenziali di autenticazione native per il cluster di destinazione Azure Cosmos DB per MongoDB qui.

  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 Azure Cosmos DB per MongoDB.

  3. Nella pagina account selezionare Migrate to DocumentDB (Esegui migrazione a DocumentDB ) dal menu delle risorse.

    Screenshot della home page nel flusso di migrazione a DocumentDB.

  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:

    Description
    Offline 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

    Il backup continuo è 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 DocumentDB di destinazione. 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 DocumentDB 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 DocumentDB di destinazione 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. Vai all'account Azure Cosmos DB di origine per MongoDB.

  2. Nella pagina account selezionare Migrate to DocumentDB (Esegui migrazione a DocumentDB ) dal menu delle risorse.

  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 Description
    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, è consigliabile aggiornare le credenziali nell'applicazione client in modo che corrisponda al nuovo cluster Azure DocumentDB.

  • Last updated on