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

Artigo
01/10/2024

APLICA-SE A: NoSQL MongoDB Cassandra Gremlin Tabela

O Azure Cosmos DB faz automaticamente um backup completo dos seus dados a cada 4 horas e, a qualquer momento, os dois backups mais recentes são armazenados. Esta configuração é a opção padrão e é oferecida sem qualquer custo extra. Você pode alterar 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 você precisa configurá-la em cada conta. Depois de configurar as opções de backup para uma conta, ela é aplicada a todos os contêineres dessa conta. Você pode modificar essas configurações usando o portal do Azure, o 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 não tiver uma subscrição 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ê excluiu ou corrompeu acidentalmente 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 a sua retenção dentro de 8 horas após este 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 etapas a seguir para alterar as opções de backup padrão para uma conta existente do Azure Cosmos DB.

Inicie sessão no portal do Azure.
Navegue até sua conta do Azure Cosmos DB e abra o painel Backup & Restore . 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 de seus dados. O backup leva um tempo diferente de zero e, em alguns casos, pode falhar devido a dependências downstream. O Azure Cosmos DB tenta ao máximo 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 é mantido. Você pode configurá-lo em horas ou dias. O período mínimo de retenção não pode ser inferior a duas vezes o intervalo de backup (em horas) e não pode ser superior a 720 horas.
- Cópias dos dados retidos - Por padrão, duas cópias de backup de seus dados são oferecidas gratuitamente. Há uma taxa extra se você precisar de mais de duas cópias. Consulte a seção Armazenamento consumido na página de preços para saber o preço exato das cópias extras.
- 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 existentes no modo de backup periódico têm armazenamento com redundância geográfica se a região onde a conta está sendo provisionada oferecer suporte a ele. Caso contrário, a conta retornará para a opção de redundância mais alta disponível. Você pode escolher outro armazenamento, como localmente redundante, para garantir que o backup não seja replicado para outra região. As alterações feitas em uma conta existente são aplicadas apenas a backups futuros. Depois que a redundância de armazenamento de backup de uma conta existente for atualizada, pode levar até o dobro do intervalo de backup para que as alterações entrem em vigor e você perderá o acesso para restaurar os backups mais antigos imediatamente.
Nota

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

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

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

Use o Update-AzCosmosDBAccount cmdlet para atualizar as opções de backup periódico de 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"
            }
        }
      }
    }
  ]
}

Como alternativa, 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 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.

Nota

Para fins ilustrativos, esses exemplos pressupõem que você esteja criando uma conta do Azure Cosmos DB para 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 Política de backup periódico*. A política periódica permite configurar o intervalo de backup, a retenção de backup e a redundância de armazenamento de backup. Por exemplo, você pode escolher opções de armazenamento de backup com redundância local ou de armazenamento de backup redundante de zona para impedir a replicação de dados de backup fora da sua região.

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

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

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

$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"
            }
        }
      }
    }
  ]
}

Como alternativa, 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óximos passos

Solicitar restauração de dados a partir de um backup

Partilhar via