Migración de una cuenta de Azure Cosmos DB del modo periódico al modo de copia de seguridad continua

Las cuentas de Azure Cosmos DB con la directiva de copia de seguridad en modo periódico se pueden migrar al modo continuo mediante Azure Portal, la CLI de Azure, Azure PowerShell o las plantillas de Bicep. La migración del modo periódico al modo continuo es unidireccional y no es reversible. Después de migrar del modo periódico al modo continuo, obtendrá las ventajas del modo continuo.

Razones clave para migrar al modo continuo:

• Restaure los datos usted mismo mediante Azure Portal, la CLI o PowerShell.
• Restaure a un segundo específico dentro de la última ventana de 30 días o 7 días.
• Asegúrese de que las copias de seguridad sean coherentes entre particiones o intervalos de claves de partición.
• Restaure un contenedor, una base de datos o la cuenta completa después de la eliminación o los cambios.
• Seleccione eventos en el contenedor, la base de datos o la cuenta y elija cuándo iniciar la restauración.

Nota

La migración es unidireccional y no se puede revertir. Una vez migrado del modo periódico al modo continuo, no se puede volver a cambiar.

Puede migrar una cuenta al modo de copia de seguridad continua solo si estas condiciones son verdaderas. Además, compruebe las limitaciones de restauración a un momento dado antes de migrar:

• La cuenta es API para NoSQL, Table, Gremlin o MongoDB.
• La cuenta nunca había deshabilitado Azure Synapse Link para un contenedor.

Si la cuenta usa claves administradas por el cliente, declare una identidad administrada (asignada por el sistema o asignada por el usuario) en la directiva de acceso de Key Vault y establézcala como identidad predeterminada en la cuenta.

Importante

Después de migrar la cuenta al modo de copia de seguridad continua, el costo puede cambiar en comparación con el modo de copia de seguridad periódico. La elección entre 30 días y siete días también afecta al costo de copia de seguridad. Para más información, consulte precios del modo de copia de seguridad continua.

Prerrequisitos

• Una cuenta de Azure Cosmos DB
• Permiso Microsoft.DocumentDB/databaseAccounts/write de control de acceso basado en rol para la cuenta que se va a migrar
• Versión más reciente de la CLI de Azure o Azure PowerShell

Migración mediante el portal

Siga estos pasos para migrar la cuenta del modo de copia de seguridad periódica al modo de copia de seguridad continua:

Azure CLI

1. Inicie sesión en la CLI de Azure.

   az login
   

2. Migre la cuenta al nivel continuous30days o continuous7days.

   az cosmosdb update \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --backup-policy-type "Continuous"
   

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

   Nota

   Si no proporciona un valor de nivel, el valor predeterminado es continuous30days.

3. Una vez completada correctamente la migración, la salida muestra el objeto backupPolicy, que incluye la propiedad type con un valor de Continuous.

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

Azure Portal

1. Inicie sesión en Azure Portal.

2. Vaya a la cuenta de Azure Cosmos DB y abra el panel Copia de seguridad y restauración. Seleccione la pestaña Directivas de copia de seguridad y seleccione cambiar. Una vez que elija el modo continuo de destino, seleccione Guardar.

1. Cuando la migración está en curso, la ventana emergente muestra la actualización de la configuración de la política de copia de seguridad. Si selecciona esa notificación, es posible que consulte Actualizar en el nivel de cuenta y Migrar para la directiva de copia de seguridad sobre la información general de la cuenta. Cuando se completa la migración, la directiva de copia de seguridad cambia al nivel elegido del modo continuo . El tiempo de migración depende del tamaño de los datos de su cuenta.

Azure PowerShell

1. Inicie sesión en Azure PowerShell.

   Connect-AzAccount
   

2. Migre su cuenta del modo de copia de seguridad periódica al modo de copia de seguridad continua, eligiendo entre el nivel continuous30days o el periodo de continuous7days días.

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       Name = "<account-name>"
       BackupPolicyType = "Continuous"
   }
   Update-AzCosmosDBAccount @parameters
   

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       Name = "<account-name>"
       BackupPolicyType = "Continuous"
       ContinuousTier = "Continuous7Days"
   }
   Update-AzCosmosDBAccount @parameters
   

   Nota

   Si no proporciona un valor de nivel, el valor predeterminado es continuous30days.

Comprobación del estado de la migración

Use la CLI de Azure para comprobar el estado de una migración existente.

Azure CLI

1. Ejecute el siguiente comando para obtener las propiedades de la cuenta de Azure Cosmos DB.

   az cosmosdb show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
   

2. Compruebe las status propiedades y targetType del backupPolicy objeto . El estado debe ser InProgress después de que se inicie la migración.

   {
     ...
     "backupPolicy": {
       ...
       "migrationState": {
         "status": "InProgress",
         "targetType": "Continuous"
       },
       "type": "Periodic"
     },
     ...
   }
   

3. Una vez completada la migración, el tipo de copia de seguridad cambia a Continuous e incluye el nivel elegido. Si no se ha proporcionado un nivel, el nivel se establecerá en Continuous30Days. Vuelva a ejecutar el mismo az cosmosdb show comando para comprobar el estado.

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

Azure Portal

No disponible

Azure PowerShell

1. Ejecute el siguiente comando para obtener las propiedades de la cuenta de Azure Cosmos DB.

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       Name = "<account-name>"
   }
   Get-AzCosmosDBAccount @parameters
   

2. Compruebe las status propiedades y targetType del backupPolicy objeto . El estado debe ser InProgress después de que se inicie la migración.

   {
     ...
     "backupPolicy": {
       ...
       "migrationState": {
         "status": "InProgress",
         "targetType": "Continuous"
       },
       "type": "Periodic"
     },
     ...
   }
   

3. Una vez completada la migración, el tipo de copia de seguridad cambia a Continuous e incluye el nivel elegido. Si no se ha proporcionado un nivel, el nivel se establecerá en Continuous30Days. Vuelva a ejecutar el mismo Get-AzCosmosDBAccount comando para comprobar el estado.

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

Cambiar los niveles de modo continuo

Puede cambiar entre Continuous30Days y Continous7Days en Azure PowerShell, la CLI de Azure o Azure Portal.

Azure CLI

El siguiente comando de la CLI de Azure muestra cómo cambiar una cuenta existente a Continous7Days:

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

Azure Portal

En el portal de la cuenta de Azure Cosmos DB determinada, elija panel Restauración a un momento dado, seleccione el vínculo Cambiar junto al modo de directiva de copia de seguridad para mostrar la opción De continuo (30 días) o Continuo (7 días). Elija el destino necesario y seleccione Guardar.

Azure PowerShell

El siguiente comando de Azure PowerShell muestra cómo cambiar una cuenta existente a Continous7Days:

$parameters = @{
    ResourceGroupName = "<resource-group-name>"
    Name = "<account-name>"
    BackupPolicyType = "Continuous"
    ContinuousTier = "Continuous7Days"
}
Update-AzCosmosDBAccount @parameters

También puede usar una plantilla de ARM en un método similar al uso de la CLI de Azure y Azure PowerShell.

Nota

Cuando cambia del nivel de 30 días al nivel de 7 días, pierde inmediatamente la capacidad de restaurar datos anteriores a siete días. Al cambiar del nivel de 7 días al nivel de 30 días, solo puede restaurar los datos de los últimos siete días hasta que se acumulan nuevas copias de seguridad. Puede comprobar el tiempo de restauración más antiguo disponible mediante Azure PowerShell o la CLI de Azure. Cualquier cambio de precio de los niveles de cambio surte efecto inmediatamente.

Migración a una copia de seguridad continua mediante Bicep

Para migrar al modo de copia de seguridad continua mediante una plantilla de Bicep y Azure Resource Manager, busque la sección backupPolicy de la plantilla y actualice la type propiedad.

1. Considere esta plantilla de ejemplo que tiene una Periodic directiva de copia de seguridad:

   resource azureCosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2025-04-15' = {
     name: '<account-name>'
     properties: {
       // Other required properties omitted for brevity
       backupPolicy: {
         type: 'Periodic'
         periodicModeProperties: {
           backupIntervalInMinutes: 240 // 4 hours
           backupRetentionIntervalInHours: 48 // 2 days
         }
       }
     }
   }
   

2. Actualice la plantilla de ejemplo para usar Continuous el modo de copia de seguridad en el nivel de 7 días :

   resource azureCosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2025-04-15' = {
     name: '<account-name>'
     properties: {
       // Other required properties omitted for brevity
       backupPolicy: {
         type: 'Continuous'
         continuousModeProperties: {
           tier: 'Continuous7Days'
         }
       }
     }
   }
   

3. Implemente la plantilla mediante Azure PowerShell o la CLI. En el ejemplo siguiente se muestra cómo implementar la plantilla con un comando de la CLI:

   az deployment group create \
       --resource-group "<resource-group-name>" \
       --template-file "<template-file-path>"
   

Contenido relacionado

• Preguntas más frecuentes sobre la migración continua de copias de seguridad
• Introducción al modo de copia de seguridad continua con restauración a un momento dado.
• Modelo de recursos del modo de copia de seguridad continua.
• Restauración de una cuenta desde una copia de seguridad