Modificación del intervalo de copia de seguridad periódico y el período de retención en Azure Cosmos DB

Artículo
03/27/2023

SE APLICA A: NoSQL MongoDB Cassandra Gremlin Table

Azure Cosmos DB toma automáticamente una copia de seguridad completa de los datos cada 4 horas y en cualquier momento, pero se almacenan las últimas 2. Esta configuración es la opción predeterminada y se ofrece sin ningún costo adicional. Puede cambiar el intervalo de copias de seguridad y el período de retención predeterminados durante la creación de la cuenta de Azure Cosmos DB o con posterioridad. La configuración de copia de seguridad se establece en el nivel de cuenta de Azure Cosmos DB y debe ajustarla en cada cuenta. Después de configurar las opciones de copia de seguridad de una cuenta, se aplica a todos los contenedores dentro de esa cuenta. Puede modificar esta configuración mediante Azure Portal, Azure PowerShell o la CLI de Azure.

Requisitos previos

Una cuenta existente de Azure Cosmos DB.
- Si tiene una suscripción de Azure, cree una nueva cuenta.
- Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
- Como alternativa, puede probar Azure Cosmos DB gratis antes de confirmarlo.

Antes de comenzar

Si eliminó o dañó accidentalmente los datos, antes de crear una solicitud de soporte técnico para restaurar los datos, asegúrese de aumentar la retención de copias de seguridad de la cuenta al menos a siete días. Es mejor aumentar la retención en un plazo de 8 horas después de este evento. De esta manera, el equipo de Azure Cosmos DB tiene tiempo suficiente para restaurar la cuenta.

Modificación de las opciones de copia de seguridad de una cuenta existente

Siga estos pasos para cambiar las opciones de copia de seguridad predeterminadas para una cuenta de Azure Cosmos DB existente.

Inicie sesión en Azure Portal.
Vaya a la cuenta de Azure Cosmos DB y abra el panel Copia de seguridad y restauración. Actualice el intervalo de copia de seguridad y el período de retención de copia de seguridad según sea necesario.
- Intervalo de copia de seguridad: es el intervalo en el que Azure Cosmos DB intenta realizar una copia de seguridad de los datos. La copia de seguridad tarda una cantidad de tiempo distinta de cero y, en algunos casos, podría producir un error debido a las dependencias de nivel inferior. Azure Cosmos DB intenta realizar una copia de seguridad en el intervalo configurado; sin embargo, no garantiza que la copia de seguridad se complete dentro de ese intervalo de tiempo. Este valor se puede configurar en horas o minutos. El intervalo de copia de seguridad no puede ser menor que 1 hora ni mayor que 24 horas. Al cambiar este intervalo, el nuevo intervalo entra en vigor a partir de la hora en que se realizó la última copia de seguridad.
- Retención de copia de seguridad: representa el período en el que se conserva cada copia de seguridad. Puede configurarlo en horas o días. El período de retención mínimo no puede ser inferior a dos veces el intervalo de copia de seguridad (en horas) y no puede ser superior a 720 horas.
- Copias de los datos conservadas: de manera predeterminada, se ofrecen dos copias de seguridad de los datos de forma gratuita. Se aplica un cargo adicional si se necesitan más de dos copias. Vea la sección Almacenamiento consumido de la página de precios para saber el precio exacto de las copias adicionales.
- Redundancia del almacenamiento de copia de seguridad: elija la opción de redundancia de almacenamiento necesaria. Para más información, consulte Redundancia de almacenamiento de copia de seguridad. De forma predeterminada, las cuentas del modo de copia de seguridad periódica existente tienen almacenamiento con redundancia geográfica si la región donde se aprovisiona la cuenta lo admite. En caso contrario, la cuenta vuelve a la opción de mayor redundancia disponible. Puede elegir otro almacenamiento, como con redundancia local, para asegurarse de que la copia de seguridad no se replica en otra región. Los cambios realizados en una cuenta existente solo se aplican a las copias de seguridad futuras. Una vez actualizada la redundancia del almacenamiento de copia de seguridad de una cuenta existente, el intervalo de copia de seguridad puede tardar hasta el doble para que los cambios surtan efecto y se perderá el acceso para restaurar las copias de seguridad más antiguas inmediatamente.
Nota:

Debe tener asignado el rol de operador de Azure Cosmos DB en el nivel de suscripción para configurar la redundancia del almacenamiento de copia de seguridad.

Use el comando az cosmosdb update para actualizar las opciones de copia de seguridad periódicas de una cuenta existente.

az cosmosdb update \
    --resource-group <resource-group-name> \
    --name <account-name> \
    --backup-interval 480 \
    --backup-retention 24

Use el cmdlet Update-AzCosmosDBAccount para actualizar las opciones de copia de seguridad periódicas de una cuenta existente.

$parameters = @{
    ResourceGroupName = "<resource-group-name>"
    Name = "<account-name>"
    BackupIntervalInMinutes = 480
    BackupRetentionIntervalInHours = 24
}
Update-AzCosmosDBAccount @parameters

Use la siguiente plantilla JSON de Azure Resource Manager para actualizar las opciones de copia de seguridad periódicas de una cuenta existente.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "newAccountName": {
      "type": "string",
      "defaultValue": "[format('nosql-{0}', toLower(uniqueString(resourceGroup().id)))]",
      "metadata": {
        "description": "Name of the existing Azure Cosmos DB account."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for the Azure Cosmos DB account."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.DocumentDB/databaseAccounts",
      "apiVersion": "2022-05-15",
      "name": "[parameters('newAccountName')]",
      "location": "[parameters('location')]",
      "kind": "GlobalDocumentDB",
      "properties": {
        "databaseAccountOfferType": "Standard",
        "locations": [
          {
            "locationName": "[parameters('location')]"
          }
        ],
        "backupPolicy": {
            "type": "Periodic",
            "periodicModeProperties": {
                "backupIntervalInMinutes": 480,
                "backupRetentionIntervalInHours": 24,
                "backupStorageRedundancy": "Local"
            }
        }
      }
    }
  ]
}

Como alternativa, puede usar la variante de Bicep de la misma plantilla.

@description('Name of the existing Azure Cosmos DB account.')
param newAccountName string = 'nosql-${toLower(uniqueString(resourceGroup().id))}'

@description('Location for the Azure Cosmos DB account.')
param location string = resourceGroup().location

resource account 'Microsoft.DocumentDB/databaseAccounts@2022-05-15' = {
  name: newAccountName
  location: location
  kind: 'GlobalDocumentDB'
  properties: {
    databaseAccountOfferType: 'Standard'
    locations: [
      {
        locationName: location
      }
    ]
    backupPolicy:
      type: 'Periodic'
      periodicModeProperties:
        backupIntervalInMinutes: 480,
        backupRetentionIntervalInHours: 24,
        backupStorageRedundancy: 'Local'
  }
}

Configure las opciones de copia de seguridad de una nueva cuenta

Siga estos pasos para cambiar las opciones de copia de seguridad predeterminadas de una nueva cuenta de Azure Cosmos DB.

Nota:

Para fines ilustrativos, en estos ejemplos se supone que va a crear una cuenta de Azure Cosmos DB for NoSQL. Los pasos son muy similares para las cuentas que usan otras API.

Al aprovisionar una cuenta nueva, en la pestaña Directiva de copia de seguridad, seleccione la directiva de copia de seguridad Periodic (Periódica)*. La directiva periódica le permite configurar el intervalo y la retención de las copias de seguridad, así como la redundancia del almacenamiento de copia de seguridad. Por ejemplo, puede elegir las opciones de almacenamiento de copia de seguridad con redundancia local o de almacenamiento de copia de seguridad con redundancia de zona para evitar la replicación de datos de copia de seguridad fuera de la región.

Use el comando az cosmosdb create para crear una nueva cuenta con las opciones de copia de seguridad periódicas especificadas.

az cosmosdb create \
    --resource-group <resource-group-name> \
    --name <account-name> \
    --locations regionName=<azure-region> \
    --backup-interval 360 \
    --backup-retention 12

Use el cmdlet New-AzCosmosDBAccount para crear una nueva cuenta con las opciones de copia de seguridad periódicas especificadas.

$parameters = @{
    ResourceGroupName = "<resource-group-name>"
    Name = "<account-name>"
    Location = "<azure-region>"
    BackupPolicyType = "Periodic"
    BackupIntervalInMinutes = 360
    BackupRetentionIntervalInHours = 12
}
New-AzCosmosDBAccount @parameters

Use la siguiente plantilla JSON de Azure Resource Manager para actualizar las opciones de copia de seguridad periódicas de una cuenta existente.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "newAccountName": {
      "type": "string",
      "defaultValue": "[format('nosql-{0}', toLower(uniqueString(resourceGroup().id)))]",
      "metadata": {
        "description": "New Azure Cosmos DB account name. Max length is 44 characters."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for the new Azure Cosmos DB account."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.DocumentDB/databaseAccounts",
      "apiVersion": "2022-05-15",
      "name": "[parameters('newAccountName')]",
      "location": "[parameters('location')]",
      "kind": "GlobalDocumentDB",
      "properties": {
        "databaseAccountOfferType": "Standard",
        "locations": [
          {
            "locationName": "[parameters('location')]"
          }
        ],
        "backupPolicy": {
            "type": "Periodic",
            "periodicModeProperties": {
                "backupIntervalInMinutes": 360,
                "backupRetentionIntervalInHours": 12,
                "backupStorageRedundancy": "Zone"
            }
        }
      }
    }
  ]
}

Como alternativa, puede usar la variante de Bicep de la misma plantilla.

@description('New Azure Cosmos DB account name. Max length is 44 characters.')
param newAccountName string = 'sql-${toLower(uniqueString(resourceGroup().id))}'

@description('Location for the new Azure Cosmos DB account.')
param location string = resourceGroup().location

resource account 'Microsoft.DocumentDB/databaseAccounts@2022-05-15' = {
  name: newAccountName
  location: location
  kind: 'GlobalDocumentDB'
  properties: {
    databaseAccountOfferType: 'Standard'
    locations: [
      {
        locationName: location
      }
    ]
    backupPolicy:
      type: 'Periodic'
      periodicModeProperties:
        backupIntervalInMinutes: 360,
        backupRetentionIntervalInHours: 12,
        backupStorageRedundancy: 'Zone'
  }
}

Pasos siguientes

Solicitud de una restauración de datos desde una copia de seguridad

Compartir vía