为 Azure Cosmos DB 帐户预配连续备份和时间点还原
适用对象: NoSQL MongoDB
Azure Cosmos DB 的时间点还原功能可帮助你从容器内的意外更改中恢复、还原已删除的资源或者还原到任何区域(其中已存在备份)。 通过连续备份模式,可还原到过去 30 或 7 天内的任何时间点。 可以追溯到多久以前取决于帐户的连续模式层。
本文介绍如何使用 Azure 门户、PowerShell、CLI 和资源管理器模板为帐户预配连续备份和时间点还原。
注意
只有在满足以下条件时,才能预配连续备份模式帐户:
- 如果帐户的类型为 API for NoSQL 或 API for MongoDB。
- 如果帐户的类型为 API for Table 或 API for Gremlin。
- 如果帐户有单个写入区域。
使用 Azure 门户进行预配
创建新的 Azure Cosmos DB 帐户时,在“备份策略”选项卡中选择“连续”模式,启用新帐户的时间点还原功能。 使用时间点还原时,数据将还原到新帐户,目前还无法还原到现有帐户。
使用 Azure PowerShell 进行预配
对于 PowerShell 和 CLI 命令,如果尚未提供,则层值是可选的。 如果未提供,帐户备份将保留 30 天。 层由值 Continuous7Days
或 Continuous30Days
表示。
安装最新版本的 Azure PowerShell
- 在预配帐户之前,请安装 Azure PowerShell 6.2.0 以上版本。 有关 Azure PowerShell 最新版本的详细信息,请参阅 Azure PowerShell 最新版本。
- 若要预配
Continuous7Days
层,需要通过运行Install-Module -Name Az.CosmosDB -AllowPrerelease
来安装模块的预览版本。
接下来,请使用以下命令连接到 Azure 帐户并选择所需的订阅:
使用以下命令登录到 Azure:
Connect-AzAccount -Environment AzureChinaCloud
使用以下命令选择特定订阅:
Select-AzSubscription -Subscription <SubscriptionName>
API for NoSQL 帐户
要为帐户预配连续备份,请添加参数 -BackupPolicyType Continuous
以及常规预配命令。
以下 cmdlet 假定在“中国北部”区域的 MyRG 资源组中有一个单区域写入帐户 Pitracct。 帐户已启用连续备份策略。 连续备份在 Continuous7days
层上配置:
New-AzCosmosDBAccount `
-ResourceGroupName "MyRG" `
-Location "China North" `
-BackupPolicyType Continuous `
-ContinuousTier Continuous7Days `
-Name "pitracct" `
-ApiKind "Sql"
适用于 MongoDB 的 API
以下 cmdlet 是使用 Continuous30days
层配置的连续备份帐户的示例:
New-AzCosmosDBAccount `
-ResourceGroupName "MyRG" `
-Location "China North" `
-BackupPolicyType Continuous `
-ContinuousTier Continuous30Days `
-Name "Pitracct" `
-ApiKind "MongoDB" `
-ServerVersion "3.6"
API for Table 帐户
要为帐户预配连续备份,请添加参数 -BackupPolicyType Continuous
以及常规预配命令。
以下 cmdlet 是使用 Continuous7days
层配置的连续备份策略的示例:
New-AzCosmosDBAccount `
-ResourceGroupName "MyRG" `
-Location "China North" `
-BackupPolicyType Continuous `
-ContinuousTier Continuous7Days `
-Name "pitracct" `
-ApiKind "Table"
API for Gremlin 帐户
要为帐户预配连续备份,请添加参数 -BackupPolicyType Continuous
以及常规预配命令。
以下 cmdlet 是使用 Continuous30days
层配置的连续备份策略帐户的示例:
New-AzCosmosDBAccount `
-ResourceGroupName "MyRG" `
-Location "China North" `
-BackupPolicyType Continuous `
-ContinuousTier Continuous30Days `
-Name "pitracct" `
-ApiKind "Gremlin"
使用 Azure CLI 进行预配
对于 PowerShell 和 CLI 命令,层值是可选的,如果未提供,帐户备份将保留 30 天。 层由 Continuous7Days
或 Continuous30Days
表示。
在预配帐户之前,请通过以下步骤安装 Azure CLI:
安装最新版本的 Azure CLI,请参阅 Azure CLI
登录并选择你的订阅。
- 使用
az login
来命令登录 Azure 账户。 - 使用
az account set -s <subscriptionguid>
命令选择所需订阅。
- 使用
API for NoSQL 帐户
若要为 API for NoSQL 帐户预配连续备份,应将额外的参数 --backup-policy-type Continuous
与常规预配命令一起传递。 以下命令为具有连续备份策略和 Continuous7days
层的命名为 Pitracct 单区写入账户的示例:
az cosmosdb create \
--name Pitracct \
--resource-group MyRG \
--backup-policy-type Continuous \
--continuous-tier "Continuous7Days" \
--default-consistency-level Session \
--locations regionName="China North"
适用于 MongoDB 的 API
以下命令为具有连续备份策略和 Continuous30days
层的命名为 Pitracct 单区写入账户的示例:
az cosmosdb create \
--name Pitracct \
--kind MongoDB \
--resource-group MyRG \
--server-version "3.6" \
--backup-policy-type Continuous \
--continuous-tier "Continuous30Days" \
--default-consistency-level Session \
--locations regionName="China North"
API for Table 帐户
以下命令为具有连续备份策略和 Continuous30days
层的命名为 Pitracct 单区写入账户的示例:
az cosmosdb create \
--name Pitracct \
--kind GlobalDocumentDB \
--resource-group MyRG \
--capabilities EnableTable \
--backup-policy-type Continuous \
--continuous-tier "Continuous30Days" \
--default-consistency-level Session \
--locations regionName="China North"
API for Gremlin 帐户
以下命令演示一个名为 Pitracct 的单区域写入帐户的示例,其连续备份策略和 Continuous7days
层是在“中国北部”区域中的“MyRG”资源组下创建的:
az cosmosdb create \
--name Pitracct \
--kind GlobalDocumentDB \
--resource-group MyRG \
--capabilities EnableGremlin \
--backup-policy-type Continuous \
--continuous-tier "Continuous7Days" \
--default-consistency-level Session \
--locations regionName="China North"
使用资源管理器模板进行预配
可以使用 Azure 资源管理器模板来部署具有连续模式的 Azure Cosmos DB 帐户。 定义用于预配帐户的模板时,请包含 backupPolicy
和层参数,如以下示例所示,层可以是 Continuous7Days
或 Continuous30Days
:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [
{
"name": "ademo-pitr1",
"type": "Microsoft.DocumentDB/databaseAccounts",
"apiVersion": "2023-04-15",
"location": "China North",
"properties": {
"locations": [
{
"locationName": "China North"
}
],
"backupPolicy":{
"type":"Continuous",
"continuousModeProperties":{
"tier":"Continuous7Days"
}
}
"databaseAccountOfferType": "Standard"
} }
接下来,使用 Azure PowerShell 或 CLI 部署模板。 下面的示例演示如何使用 CLI 命令部署模板:
az deployment group create -g <ResourceGroup> --template-file <ProvisionTemplateFilePath>
后续步骤
- 还原活动的或已删除的 Azure Cosmos DB 帐户
- 如何将帐户从定期备份迁移到连续备份。
- 连续备份模式资源模型。
- 管理以连续备份模式还原数据所需的权限。