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

Artículo
04/17/2023

SE APLICA A: NoSQL MongoDB Gremlin Table

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, PowerShell o las plantillas de Resource Manager. La migración del modo periódico al modo continuo es una migración unidireccional y no es reversible. Después de migrar del modo periódico al modo continuo, puede aplicar las ventajas de este último.

Estos son los principales motivos para migrar al modo continuo:

La capacidad de realizar un autoservicio de restauración mediante Azure Portal, la CLI o PowerShell.
La capacidad de restaurar con una granularidad de tiempo de un segundo dentro de los últimos 30 o 7 días.
La capacidad de asegurarse de que la copia de seguridad es coherente entre particiones o intervalos de claves de partición dentro de un período.
La capacidad de restaurar el contenedor, la base de datos o la cuenta completa cuando se elimina o modifica.
La capacidad de elegir los eventos en el contenedor, la base de datos o la cuenta y decidir cuándo iniciar la restauración.

Nota

La funcionalidad de migración es un solo sentido y es una acción irreversible. Lo que significa que, una vez migrado del modo periódico al modo continuo, no puede volver al modo periódico.

Puede migrar una cuenta al modo de copia de seguridad continua solo si se cumplen las siguientes condiciones. Consulte también las limitaciones de la restauración a un momento dado antes de migrar la cuenta:

Si la cuenta es de tipo API para NoSQL,API para Table, Gremlin o API para MongoDB.
Si la cuenta tiene una sola región de escritura.
Si la cuenta no está habilitada con el almacén analítico.

Si la cuenta usa claves administradas por el cliente, se debe declarar una identidad administrada (asignada por el sistema o por el usuario) en la directiva de acceso de Key Vault y se debe establecer como la identidad predeterminada en la cuenta.

Permisos

Para realizar la migración, necesita permiso Microsoft.DocumentDB/databaseAccounts/write para la cuenta que se está migrando.

Precios después de la migración

Después de migrar la cuenta al modo de copia de seguridad continua, los costos pueden cambiar en comparación con el modo de copia de seguridad periódica. La elección del nivel de 30 días frente al de siete días también tendrá una influencia en el costo de la copia de seguridad. Para más información, consulte los precios del modo de copia de seguridad continua.

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:

Inicie sesión en Azure Portal.
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.
Cuando la migración está en curso, el elemento emergente muestra la configuración de directiva de Actualización de copia de seguridad. Si selecciona esa notificación, es posible que vea Actualización en el nivel de cuenta y Migración para la directiva de copia de seguridad en la información general de la cuenta. Una vez completada, la directiva de copia de seguridad cambiará al nivel que se haya elegido del modo Continuo. El tiempo de migración depende del tamaño de los datos de su cuenta.

Migrar mediante PowerShell

Instale la versión más reciente de Azure PowerShell o cualquier versión posterior a la 6.2.0.
Para utilizar el modo Continous7Days de aprovisionamiento o migración, tendrá que usar la versión preliminar de la extensión cosmosdb. Use Install-Module -Name Az.CosmosDB -AllowPrerelease
Después, ejecute los pasos siguientes:
1. Conexión a la cuenta de Azure:
```
Connect-AzAccount
```
2. Migre su cuenta del modo de copia de seguridad periódica al modo de copia de seguridad continua con el nivel continuous30days o los días continuous7days. Si no se proporciona un valor de nivel, se da por supuesto que es continuous30days:
```
Update-AzCosmosDBAccount ` 
   -ResourceGroupName "myrg" ` 
   -Name "myAccount" `
   -BackupPolicyType "Continuous"
```
```
   Update-AzCosmosDBAccount ` 
   -ResourceGroupName "myrg" ` 
   -Name "myAccount" `
   -BackupPolicyType "Continuous" `
   -ContinuousTier "Continuous7Days"
```

Migración mediante la CLI

Instale la versión más reciente de la CLI de Azure:

Si no ha instalado aún la CLI de Azure, consulte Instalación de la CLI de Azure. Como alternativa, también puede usar Azure Cloud Shell de Azure Portal.

Inicie sesión en su cuenta de Azure y ejecute el comando siguiente para migrar la cuenta al modo continuo:
```
az login
```

Migre la cuenta al nivel continuous30days o continuous7days. Si no se proporciona un valor de nivel, se da por supuesto que es 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"

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

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

Comprobación del estado de la migración

Ejecute el siguiente comando y compruebe las propiedades status y targetType del objeto backupPolicy. El estado se muestra en curso después de que se inicie la migración:

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

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

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

Migración del modo periódico al modo continuo mediante la plantilla de Resource Manager

Para migrar al modo de copia de seguridad continua mediante la plantilla de ARM, busque la sección backupPolicy de la plantilla y actualice la propiedad type. Por ejemplo, si la plantilla existente tiene una directiva de copia de seguridad como el siguiente objeto JSON:

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

Reemplácelo por el objeto JSON código que verá a continuación:

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

A continuación, 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 -g <ResourceGroup> --template-file <ProvisionTemplateFilePath>

Cambio de los niveles de modo continuo

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

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

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

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

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

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

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

Nota

Al cambiar de un nivel de 30 a 7 días, la capacidad de restaurar más de 7 días en el historial es inviable de inmediato. Al cambiar de un nivel de 7 a 30 días, no podrá restaurar más de 7 días de inmediato. La hora más temprana de restauración se puede extraer de los metadatos de la cuenta disponibles mediante Azure PowerShell o la CLI de Azure. El impacto del precio de cambiar entre los niveles de 7 y 30 días también sería visible de inmediato.

¿Qué espera durante y después de la migración?

Al migrar del modo periódico al modo continuo, no puede ejecutar ninguna operación del plano de control que realice actualizaciones o eliminaciones de nivel de cuenta. Por ejemplo, no se pueden ejecutar operaciones como las siguientes mientras la migración está en curso: incorporación o eliminación de regiones, conmutación por error de cuenta, actualización de la directiva de copia de seguridad, etc. El tiempo de migración depende del tamaño de los datos y del número de regiones de la cuenta. La acción de restauración de las cuentas migradas solo se realiza correctamente desde el momento en que la migración se completa correctamente.

Puede restaurar la cuenta una vez completada la migración. Si la migración se completa a las 13:00 PST, puede realizar una restauración a un momento dado a partir de las 13:00 PST.

Preguntas más frecuentes

¿La migración solo se realiza en el nivel de cuenta?

Sí.

¿Qué cuentas se pueden dirigir a la migración de copia de seguridad?

Actualmente, la API para NoSQL, la API para tablas, la API de Gremlin y la API para cuentas de MongoDB con una sola región de escritura que tienen un rendimiento compartido, aprovisionado o aprovisionado de escala automática admiten la migración.

Las cuentas habilitadas con almacenamiento analítico y regiones de varias escrituras no se admiten para la migración.

¿La migración tarda tiempo? ¿Cuál es el tiempo típico?

La migración tarda una cantidad de tiempo variable que depende en gran medida del tamaño de los datos y del número de regiones de la cuenta. Puede obtener el estado de migración mediante la CLI de Azure o comandos de PowerShell. En el caso de cuentas grandes con decenas de terabytes de datos, la migración puede tardar hasta unos días en completarse.

¿Provoca la migración algún impacto en la disponibilidad o tiempo de inactividad?

No, la operación de migración tiene lugar en segundo plano. Por lo tanto, las solicitudes de cliente no se verán afectadas. Sin embargo, es necesario realizar algunas operaciones de back-end durante la migración, y puede tardar más tiempo si la cuenta está sometida a una gran carga.

¿Qué ocurre si la migración falla? ¿Seguiré obteniendo las copias de seguridad periódicas o las copias de seguridad continuas?

Una vez iniciado el proceso de migración, la cuenta se habilitará en modo continuo. Si se produce un error en la migración, debe iniciarla de nuevo hasta que se realice correctamente.

Cómo realizar una restauración a una marca de tiempo antes, durante o después de la migración?

Supongamos que haya iniciado la migración en t1 y la haya finalizado en t5, no puede usar una marca de tiempo de restauración entre t1 y t5.

Suponga también que la cuenta esté ahora en modo continuo. Para restaurar a un momento posterior a t5, ejecute la restauración mediante Azure Portal, la CLI o PowerShell, tal como lo haría con una cuenta continua. Esta solicitud de autoservicio de restauración solo se puede realizar una vez completada la migración.

Para restaurar a un momento anterior a t1, puede abrir una incidencia de soporte técnico tal como lo haría con una cuenta de copia de seguridad periódica. Después de la migración, tiene hasta 30 días para realizar la restauración periódica. Durante estos 30 días, puede restaurar en función de la retención o el intervalo de copia de seguridad de la cuenta antes de la migración. Por ejemplo, si la copia de seguridad estaba configurada para conservar 24 copias a intervalos de 1 hora, puede restaurar a cualquier momento entre (t1 – 24 hours) y t1.

¿Qué operaciones del plano de control de nivel de cuenta se bloquean durante la migración?

Las operaciones como agregar o quitar región, conmutación por error, cambiar la directiva de copia de seguridad y cualquier cambio de rendimiento que produzca movimiento de datos se bloquean durante la migración.

Si se produce un error en la migración por algún problema subyacente, ¿seguiría bloqueando la operación del plano de control hasta que se reintente y se complete correctamente?

La migración con error no bloqueará ninguna operación del plano de control. Si se produce un error en la migración, se recomienda reintentar hasta que se realice correctamente antes de realizar cualquier otra operación del plano de control.

¿Es posible cancelar la migración?

No es posible cancelar la migración porque no es una operación reversible.

¿Hay una herramienta que pueda ayudar a calcular el tiempo de migración en función del uso de datos y el número de regiones?

No hay ninguna herramienta para calcular el tiempo. Nuestras pruebas y ejecuciones de escalado indican que una única cuenta de región con 1 TB de datos tarda aproximadamente 90 minutos.

Para las cuentas de varias regiones, calcule el tamaño total de los datos como Number_of_regions * Data_in_single_region.

Se recomienda probar la característica del modo de copia de seguridad continua para ver que funciona según lo previsto antes de migrar las cuentas de producción. La migración es una operación unidireccional y no es reversible.

Pasos siguientes

Para obtener más información sobre el modo de copia de seguridad continua, vea los siguientes artículos:

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.
Restaure una cuenta mediante Azure Portal, PowerShell, la CLI o Azure Resource Manager.