Изменение периодического интервала резервного копирования и периода хранения в Azure Cosmos DB

Статья
08/15/2024

Область применения: Nosql Mongodb Кассандра Гремлин Таблица

Azure Cosmos DB автоматически создает полную резервную копию базы данных каждые 4 часа, из которых в любой момент времени сохраняются последние две. Эта конфигурация предоставляется по умолчанию и без излишних затрат. Вы можете изменить интервал резервного копирования по умолчанию и период хранения во время создания учетной записи Azure Cosmos DB или после создания учетной записи. Конфигурация резервного копирования устанавливается на уровне учетной записи Azure Cosmos DB и ее необходимо настроить для каждой учетной записи. После настройки параметров резервного копирования для учетной записи они применяются ко всем контейнерам в этой учетной записи. Эти параметры можно изменить с помощью портал Azure, Azure PowerShell или Azure CLI.

Необходимые компоненты

Существующая учетная запись Azure Cosmos DB.
- Если у вас есть подписка Azure, создайте новую учетную запись.
- Если у вас нет подписки Azure, создайте бесплатную учетную запись, прежде чем приступить к работе.
- Кроме того, перед фиксацией можно воспользоваться бесплатной службой Azure Cosmos DB.

Перед началом работы

Если вы случайно удалили или повреждены данные, перед созданием запроса на поддержку для восстановления данных обязательно увеличьте срок хранения резервных копий для учетной записи по крайней мере семь дней. Рекомендуется увеличить срок хранения в течение 8 часов этого события. Таким образом, команда Azure Cosmos DB имеет достаточно времени для восстановления учетной записи.

Изменение параметров резервного копирования для существующей учетной записи

Чтобы изменить параметры резервного копирования по умолчанию для существующей учетной записи Azure Cosmos DB, выполните следующие действия.

Войдите на портал Azure.
Перейдите к учетной записи Azure Cosmos DB и откройте область резервного копирования и восстановления . При необходимости измените интервал резервного копирования и срок хранения резервных копий.
- Интервал резервного копирования — это интервал, с которым Azure Cosmos DB пытается создать резервную копию данных. Резервное копирование занимает ненулевое время, и в некоторых случаях это может привести к сбою из-за подчиненных зависимостей. Azure Cosmos DB пытается создать резервную копию с заданным интервалом, однако это не гарантирует, что резервное копирование завершится в пределах этого интервала времени. Это значение можно настроить в часах или минутах. Интервал резервного копирования не может превышать 1 час и больше 24 часов. При изменении этого интервала новый интервал вступает в силу с момента, когда была создана последняя резервная копия.
- Хранение резервных копий — задает период хранения каждой резервной копии. Его можно настроить в часах или днях. Минимальный срок хранения не может быть меньше двух интервалов резервного копирования (в часах) и не может превышать 720 часов.
- Копии хранящихся данных — по умолчанию бесплатно предлагаются две резервные копии данных. Если вам потребуется более двух копий, взимается дополнительная плата. См. раздел "Используемое хранилище" на странице цен, чтобы узнать точные цены на дополнительные копии.
- Избыточность хранилища резервных копий — выберите необходимый параметр избыточности хранилища. Дополнительные сведения см. в статье о избыточности хранилища резервных копий. По умолчанию существующие учетные записи периодического резервного копирования имеют геоизбыточное хранилище, если регион, в котором выполняется подготовка учетной записи, поддерживает ее. В противном случае можно выполнить откат учетной записи до максимального уровня избыточности. Вы можете выбрать другое хранилище, например локально избыточное, чтобы убедиться, что резервная копия не реплицируется в другой регион. Изменения, внесенные в существующую учетную запись, применяются только к будущим резервным копиям. После обновления избыточности хранилища резервных копий существующей учетной записи может занять до двух раз интервала резервного копирования, чтобы изменения вступили в силу, и вы потеряете доступ к восстановлению старых резервных копий немедленно.
Примечание.

Для настройки избыточности хранилища резервных копий необходимо назначить роль оператора Azure Cosmos DB на уровне подписки.

az cosmosdb update Используйте команду для обновления периодических параметров резервного копирования для существующей учетной записи.

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

Update-AzCosmosDBAccount Используйте командлет для обновления периодических параметров резервного копирования для существующей учетной записи.

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

Используйте следующий шаблон JSON Azure Resource Manager для обновления периодических параметров резервного копирования для существующей учетной записи.

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

Кроме того, можно использовать вариант Bicep одного шаблона.

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

Настройка параметров резервного копирования для новой учетной записи

Чтобы изменить параметры резервного копирования по умолчанию для новой учетной записи Azure Cosmos DB, выполните следующие действия.

Примечание.

В целях иллюстрации в этих примерах предполагается, что вы создаете учетную запись Azure Cosmos DB для NoSQL . Действия очень похожи для учетных записей с помощью других API.

При подготовке новой учетной записи на вкладке Политика архивации выберите для политики архивации значение Периодическая*. Периодическая политика позволяет настроить интервал резервного копирования, срок хранения резервных копий и избыточность хранилища резервных копий. Например, можно выбрать параметр Локально избыточное хранилище резервных копий или Хранилище резервных копий, избыточное между зонами, чтобы предотвратить репликацию данных резервных копий за пределы вашего региона.

az cosmosdb create Используйте команду, чтобы создать новую учетную запись с указанными параметрами периодического резервного копирования.

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

New-AzCosmosDBAccount Используйте командлет для создания новой учетной записи с указанными параметрами периодического резервного копирования.

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

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

Кроме того, можно использовать вариант Bicep одного шаблона.

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

Следующие шаги

Запрос восстановления данных из резервной копии

Поделиться через