Eseguire la migrazione di un account di Azure Cosmos DB dal backup periodico alla modalità di backup continuo

SI APPLICA A: NoSQL MongoDB Gremlin Tabella

Gli account Azure Cosmos DB con criteri di backup in modalità periodica possono essere migrati in modalità continua usando il portale di Azure, l'interfaccia della riga di comando, PowerShell o i modelli di Resource Manager. La migrazione dalla modalità periodica alla modalità continua è unidirezionale e non è reversibile. Dopo la migrazione dalla modalità periodica alla modalità continua, è possibile applicare i vantaggi della modalità continua.

Di seguito sono riportati i motivi principali per eseguire la migrazione alla modalità continua:

• Possibilità di eseguire un ripristino self-service mediante il portale di Azure, l'interfaccia della riga di comando o PowerShell.
• Possibilità di ripristinare con granularità temporale di un secondo entro l'ultima finestra di 30 giorni o 7 giorni.
• Possibilità di assicurarsi che il backup sia coerente tra partizioni o intervalli di chiavi di partizione entro un periodo specifico.
• Possibilità di ripristinare il contenitore, il database o l'account completo quando viene eliminato o modificato.
• Possibilità di scegliere gli eventi nel contenitore, nel database o nell'account e di decidere quando avviare il ripristino.

• Se Collegamento a Synapse per un contenitore non è mai stato disabilitato nell'account.

Se l'account usa chiavi gestite dal cliente, è necessario dichiarare un'identità gestita (assegnata dal sistema o assegnata dall'utente) nei criteri di accesso di Key Vault e deve essere impostata come identità predefinita nell'account.

Autorizzazioni

Per eseguire la migrazione, è necessaria Microsoft.DocumentDB/databaseAccounts/write l'autorizzazione per l'account di cui viene eseguita la migrazione.

Prezzi dopo la migrazione

Dopo aver migrato l'account in modalità di backup continuo, il costo può cambiare rispetto alla modalità di backup periodica. Anche la scelta del livello di 30 giorni rispetto a sette giorni avrà un'influenza sul costo del backup. Per altre informazioni, vedere Prezzi della modalità di backup continuo.

Eseguire la migrazione tramite il portale

Usare la procedura seguente per eseguire la migrazione dell'account dal backup periodico alla modalità di backup continuo:

1. Accedere al portale di Azure.

2. Passare all'account Azure Cosmos DB e aprire il riquadro Backup e ripristino. Selezionare la scheda Criteri di Backup e selezionare modifica. Dopo aver scelto la modalità continua di destinazione, selezionare Salva.

   

3. Quando la migrazione è in corso, il popup mostra l'aggiornamento delle impostazioni dei criteri di backup. Se si seleziona tale notifica, è possibile visualizzare Aggiornamento a livello di account e Migrazione dei criteri di backup in panoramica dell'account. Al termine del processo, la politica di backup si sarebbe commutata al livello scelto della modalità continua. Il tempo di migrazione dipende dalle dimensioni dei dati nell'account.

   

Eseguire la migrazione con PowerShell

1. Installare la versione più recente di Azure PowerShell o qualsiasi versione successiva alla versione 6.2.0.

2. Eseguire quindi i passaggi seguenti:

   1. Connettersi all'account di Azure:

      Connect-AzAccount
      

   2. Eseguire la migrazione dell'account dalla modalità di backup periodico alla modalità di backup continuo con il livello continuous30days o continuous7days giorni. Se non viene specificato un valore di livello, si presuppone che sia continuous30days:

      Update-AzCosmosDBAccount ` 
         -ResourceGroupName "myrg" ` 
         -Name "myAccount" `
         -BackupPolicyType "Continuous"
      

         Update-AzCosmosDBAccount ` 
         -ResourceGroupName "myrg" ` 
         -Name "myAccount" `
         -BackupPolicyType "Continuous" `
         -ContinuousTier "Continuous7Days"
      

Eseguire la migrazione tramite l'interfaccia della riga di comando

1. Installare la versione più recente dell'interfaccia della riga di comando di Azure:

• Se l'interfaccia della riga di comando di Azure non è già installata, vedere Installare l'interfaccia della riga di comando di Azure. In alternativa, è anche possibile usare Azure Cloud Shell dal portale di Azure.

2. Accedere all'account Azure ed eseguire il comando seguente per eseguire la migrazione dell'account alla modalità continua:

   az login
   

3. Eseguire la migrazione dell'account al continuous30days livello o continuous7days . Se il valore del livello non viene specificato, si presuppone che sia continuous30days:

   az cosmosdb update -n <myaccount> -g <myresourcegroup> --backup-policy-type continuous
   

   az cosmosdb update -g "my-rg" -n "my-continuous-backup-account" --backup-policy-type "Continuous" --continuous-tier "Continuous7Days"
   

4. Al termine della migrazione, l'output mostra l'oggetto backupPolicy, che include la proprietà type con un valore di Continuous.

    {
      "apiProperties": null,
      "backupPolicy": {
           "continuousModeProperties": {
                   "tier": "Continuous7Days"
           },
           "migrationState": null,
           "type": "Continuous"
      },
         …
    }
   

Controllare lo stato della migrazione

Eseguire il comando seguente e controllare le proprietà stato e targetType dell'oggetto backupPolicy. Lo stato viene visualizzato in corso dopo l'avvio della migrazione:

az cosmosdb show -n "myAccount" -g "myrg"

Al termine della migrazione, il tipo di backup passa a Continuo e mostra il livello scelto. Se non è stato specificato un livello, il livello verrà impostato su Continuous30Days. Eseguire di nuovo lo stesso comando per controllare lo stato:

az cosmosdb show -n "myAccount" -g "myrg"

Eseguire la migrazione dalla modalità periodica alla modalità continua usando il modello di Resource Manager

Per eseguire la migrazione alla modalità di backup continuo utilizzando il template ARM, trova la sezione backupPolicy del tuo template e aggiorna la proprietà type. Ad esempio, se il modello esistente dispone di criteri di backup come l'oggetto JSON seguente:

"backupPolicy": {
   "type": "Periodic",
   "periodicModeProperties": {
   "backupIntervalInMinutes": 240,
   "backupRetentionIntervalInHours": 8
   }
}

Sostituirlo con l'oggetto JSON seguente:

"backupPolicy": { 
   "type": "Continuous", 
   "continuousModeProperties": { 
      "tier": "Continuous7Days" 
    } 
} 

Distribuire quindi il modello usando Azure PowerShell o CLI. L'esempio seguente illustra come distribuire il modello con un comando dell'interfaccia della riga di comando:

az deployment group create -g <ResourceGroup> --template-file <ProvisionTemplateFilePath>

Modificare i livelli in modalità continua

È possibile passare da Continuous30Days e Continous7Days in Azure PowerShell, nell'interfaccia della riga di comando di Azure o nella portale di Azure.

Nel portale per l'account Azure Cosmos DB specificato, scegliere il riquadro Ripristino a un momento specifico, selezionare il collegamento modifica accanto alla modalità dei criteri di backup per visualizzare le opzioni Continua (30 giorni) o Continua (7 giorni). Scegliere la destinazione richiesta e selezionare Salva.

Il seguente comando di Azure CLI mostra come cambiare un account esistente a Continous7Days:

az cosmosdb update \ 
    --resource-group "my-rg" \ 
    --name "my-continuous-backup-account" \ 
    --backup-policy-type "Continuous" \ 
    --continuous-tier "Continuous7Days" 

Il comando di Azure PowerShell seguente illustra il passaggio di un account esistente a Continous7Days:

Update-AzCosmosDBAccount ` 
    -ResourceGroupName "myrg" ` 
    -Name "myAccount" `
    -BackupPolicyType Continuous `
    -ContinuousTier Continuous7Days

È anche possibile usare un modello ARM in modo simile all'uso dell'interfaccia della riga di comando di Azure e di Azure PowerShell.

Cosa aspettarsi durante e dopo la migrazione?

Quando si esegue la migrazione dalla modalità periodica alla modalità continua, non è possibile eseguire operazioni del piano di controllo che eseguono aggiornamenti o eliminazioni a livello di account. Ad esempio, non è possibile eseguire operazioni come l'aggiunta o la rimozione di aree, il failover dell'account, l'aggiornamento dei criteri di backup ecc. mentre la migrazione è in corso. Il tempo per la migrazione dipende dalle dimensioni dei dati e dal numero di aree nell'account. L'azione di ripristino negli account migrati ha esito positivo solo dal momento in cui la migrazione viene completata correttamente.

È possibile ripristinare l'account al termine della migrazione. Se la migrazione viene completata alle 13:00 PST, è possibile eseguire il ripristino temporizzato a partire dalle 13:00 PST.

Domande frequenti

La migrazione avviene solo a livello di account?

Sì.

Quali account possono essere destinati alla migrazione del backup per il backup continuo?

Attualmente sono supportate l'API per NoSQL, l'API per Table, l'API Gremlin e l'API per account MongoDB dove la velocità effettiva con provisioning condivisa o con provisioning a scalabilità automatica supporta la migrazione.

Gli account con Collegamento a Synapse abilitato o con Collegamento a Synapse disabilitato per una o più raccolte non possono eseguire la migrazione al backup continuo.

La migrazione richiede tempo? Qual è l'ora tipica?

La migrazione richiede una quantità di tempo variabile che dipende in gran parte dalle dimensioni dei dati e dal numero di aree nell'account. È possibile ottenere lo stato della migrazione usando l'interfaccia della riga di comando di Azure o i comandi di PowerShell. Per gli account di grandi dimensioni con decine di terabyte di dati, il completamento della migrazione può richiedere fino a pochi giorni.

La migrazione per l'account write(mrw) in più aree con backup periodico della scrittura in più aree a backup continuo richiede tempo?

Sì, questa migrazione richiede tempo che dipende in gran parte dalla necessità di attendere che tutte le scritture provvisorie precedenti vengano svuotate durante la migrazione continua del backup. È possibile ottenere lo stato della migrazione usando l'interfaccia della riga di comando di Azure o i comandi di PowerShell. Per gli account di grandi dimensioni con decine di terabyte di dati, il completamento della migrazione può richiedere fino a pochi giorni.

La migrazione causa un impatto o un tempo di inattività sulla disponibilità?

No, l'operazione di migrazione viene eseguita in background. Pertanto, le richieste dei clienti non sono influenzate. Tuttavia, è necessario eseguire alcune operazioni back-end durante la migrazione e potrebbe richiedere tempo aggiuntivo se l'account è sottoposto a un carico elevato.

Cosa accade se la migrazione non riesce? Si otterranno comunque i backup periodici o si otterranno i backup continui?

Dopo l'avvio del processo di migrazione, l'account verrà abilitato in modalità continua. Se la migrazione non riesce, è necessario avviare di nuovo la migrazione finché non ha successo.

Come eseguo un ripristino a un timestamp prima, durante o dopo la migrazione?

Si supponga di aver avviato la migrazione in t1 e che sia stata completata in t5, non è possibile usare un timestamp di ripristino tra t1 e t5.

Supponi anche che il tuo account sia ora in modalità continua. Per eseguire il ripristino a un'ora successiva a t5, eseguire il ripristino usando il portale di Azure, la CLI, o PowerShell come di norma con un account continuo. Questa richiesta di ripristino self-service può essere eseguita solo dopo il completamento della migrazione.

Per ripristinare una data antecedente a t1, è possibile aprire un ticket di supporto come si farebbe normalmente con un account di backup periodico. Dopo la migrazione, sono disponibili fino a 30 giorni per eseguire il ripristino periodico. Durante questi 30 giorni, è possibile eseguire il ripristino in base al periodo di conservazione/intervallo di backup dell'account prima della migrazione. Ad esempio, se il backup è stato configurato per conservare 24 copie a intervalli di 1 ora, è possibile eseguire il ripristino in qualsiasi momento tra (t1 – 24 hours) e t1.

Quali operazioni del piano di controllo a livello di account vengono bloccate durante la migrazione?

Le operazioni come l'aggiunta/rimozione di un'area, il failover, la modifica dei criteri di backup e le eventuali modifiche alla velocità effettiva che causano lo spostamento dei dati vengono bloccate durante la migrazione.

Se la migrazione non riesce a causa di un problema sottostante, l'operazione del piano di controllo viene comunque bloccata finché non si tenta nuovamente e si completa con successo?

La migrazione non riuscita non blocca alcuna operazione del piano di controllo. Se la migrazione non riesce, è consigliabile riprovare fino a quando non riesce prima di eseguire altre operazioni del piano di controllo.

È possibile annullare la migrazione?

Non è possibile annullare la migrazione perché le migrazioni non sono un'operazione reversibile. In risposta a una chiamata di supporto, il team può annullare temporaneamente la migrazione e consentire alle operazioni di continuare offline. Ma non è possibile tornare allo stato di backup periodico.

È disponibile uno strumento che consente di stimare il tempo di migrazione in base all'utilizzo dei dati e al numero di aree?

Non esiste uno strumento per stimare il tempo. Le esecuzioni di test e scalabilità indicano che un account con 1 TB di dati richiede circa 90 minuti.

Per gli account in più aree, calcolare le dimensioni totali dei dati come Number_of_regions * Data_in_single_region.

Poiché la modalità di backup continua è ora disponibile a livello generale, è comunque consigliabile ripristinare una copia dell'account? È consigliabile provare a eseguire la migrazione nella copia prima di decidere di eseguire la migrazione dell'account di produzione?

È consigliabile testare la funzionalità modalità di backup continuo per visualizzare il funzionamento previsto prima della migrazione degli account di produzione. La migrazione è un'operazione unidirezionale e non è reversibile.

Passaggi successivi

Per altre informazioni sulla modalità di backup continuo, vedere gli articoli seguenti:

• Introduzione alla modalità di backup continuo con il ripristino temporizzato.

• Modello di risorse per la modalità di backup continuo.

• Ripristinare un account usando il portale di Azure, PowerShell, l'interfaccia della riga di comando o Azure Resource Manager.