Modificar o intervalo de backup periódico e o período de retenção no Azure Cosmos DB

Artigo
08/15/2024

APLICA-SE AO: NoSQL MongoDB Cassandra Gremlin Table

O Azure Cosmos DB faz automaticamente um backup completo dos dados a cada 4 horas e, a qualquer momento, os dois backups mais recentes são armazenados. Essa configuração é a opção padrão, que é oferecida sem custo adicional. Você pode mudar o intervalo de backup padrão e o período de retenção durante a criação da conta do Azure Cosmos DB ou após a criação da conta. A configuração de backup é definida no nível da conta do Azure Cosmos DB e deve ser aplicada em cada conta. Depois de configurar as opções de backup de uma conta, essa configuração é aplicada a todos os contêineres dessa conta. Você pode modificar estas configurações usando o portal do Azure, PowerShell ou a CLI do Azure.

Pré-requisitos

Uma conta existente do Azure Cosmos DB.
- Se você tiver uma assinatura do Azure, crie uma nova conta.
- Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
- Como alternativa, você pode experimentar o Azure Cosmos DB gratuitamente antes de confirmar.

Antes de começar

Se você acidentalmente excluiu ou corrompeu seus dados, antes de criar uma solicitação de suporte para restaurar os dados, certifique-se de aumentar a retenção de backup da sua conta para pelo menos sete dias. É melhor aumentar sua retenção dentro de 8 horas após esse evento. Dessa forma, a equipe do Azure Cosmos DB tem tempo suficiente para restaurar sua conta.

Modificar opções de backup para uma conta existente

Use as seguintes etapas para alterar as opções de backup padrão para uma conta existente do Azure Cosmos DB.

Entre no portal do Azure.
Navegue até sua conta do Azure Cosmos DB e abra o painel Backup e Restauração. Atualize o intervalo de backup e o período de retenção de backup conforme necessário.
- Intervalo de Backup - é o intervalo no qual o Azure Cosmos DB tenta fazer um backup dos dados. O backup leva um tempo diferente de zero e, em alguns casos, pode falhar devido a dependências downstream. O Azure Cosmos DB faz o possível para fazer um backup no intervalo configurado, no entanto, não garante que o backup seja concluído dentro desse intervalo de tempo. Você pode configurar esse valor em horas ou minutos. O Intervalo de backup não pode ser inferior a 1 hora e superior a 24 horas. Quando você altera esse intervalo, o novo intervalo entra em vigor a partir do momento em que o último backup foi feito.
- Retenção de Backup - representa o período em que cada backup é retido. Você pode configurá-lo como horas ou dias. O período de retenção mínimo não pode ser menor que duas vezes o intervalo de backup (em horas) e não pode ser maior que 720 horas.
- Cópias de dados retidos - por padrão, duas cópias de backup de seus dados são oferecidas gratuitamente. Há um preço adicional se você precisar de mais de duas cópias. Consulte a seção Armazenamento Consumido na página de Preço para saber o preço exato de cópias adicionais.
- Redundância de armazenamento de backup - Escolha a opção de redundância de armazenamento necessária. Para obter mais informações, consulte redundância de armazenamento de backup. Por padrão, suas contas de modo de backup periódico existentes têm armazenamento geo-redundante se a região em que a conta está sendo provisionada dá suporte a ela. Caso contrário, o fallback da conta para a opção de redundância mais alta disponível. Você pode escolher outro armazenamento, como redundância local, para garantir que o backup não seja replicado para outra região. As alterações feitas em uma conta existente são aplicadas somente a backups futuros. Depois que a redundância do armazenamento de backup de uma conta existente for atualizada, pode levar até o dobro do tempo de intervalo de backup para que as alterações tenham efeito e você perderá o acesso para restaurar os backups mais antigos imediatamente.
Observação

Você deve ter a função de Operador do Azure Cosmos DB atribuída no nível de assinatura para configurar a redundância de armazenamento de backup.

Use o comando az cosmosdb update para atualizar as opções de backup periódico para uma conta existente.

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

Use o cmdlet Update-AzCosmosDBAccount para atualizar as opções de backup periódico para uma conta existente.

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

Use o seguinte modelo JSON do Azure Resource Manager para atualizar as opções de backup periódico de uma conta 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"
            }
        }
      }
    }
  ]
}

Alternativamente, você pode usar a variante Bicep do mesmo modelo.

@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'
  }
}

Configurar as opções de backup para uma nova conta

Use estas etapas para alterar as opções de backup padrão para uma nova conta do Azure Cosmos DB.

Observação

Para fins ilustrativos, estes exemplos assumem que você está criando uma conta do Azure Cosmos DB for NoSQL. As etapas são muito semelhantes para contas que usam outras APIs.

Ao provisionar uma nova conta, na guia Política de Backup, selecione a política de backup Periódico*. A política periódica permite que você configure o intervalo de backup, a retenção de backup e a redundância de armazenamento de backup. Por exemplo, você pode escolher armazenamento de backup com redundância local ou opções de Armazenamento de backup com redundância de zona para evitar a replicação de dados de backup fora da sua região.

Use o comando az cosmosdb create para criar uma nova conta com as opções de backup periódico especificado.

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

Use o cmdlet New-AzCosmosDBAccount para criar uma nova conta com as opções de backup periódico especificado.

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

Use o seguinte modelo JSON do Azure Resource Manager para atualizar as opções de backup periódico de uma conta 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"
            }
        }
      }
    }
  ]
}

Alternativamente, você pode usar a variante Bicep do mesmo modelo.

@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'
  }
}

Próximas etapas

Solicitar restauração de dados de um backup

Compartilhar via