Azure Cosmos DB の定期バックアップ ストレージの冗長性を更新する

適用対象: NoSQL MongoDB Cassandra Gremlin Table

既定では、Azure Cosmos DB は、ペアのリージョンにレプリケートされる geo 冗長 BLOB ストレージに定期的モードのバックアップ データを格納します。 既定のバックアップ ストレージの冗長性をオーバーライドできます。 この記事では、Azure CLI と PowerShell を使用してバックアップ ストレージの冗長性を更新する方法について説明します。 また、必要なストレージ冗長性を適用するための Azure ポリシーをアカウントで構成する方法も示します。

必須コンポーネント

• 既存の Azure Cosmos DB アカウント。
  • Azure サブスクリプションをお持ちの場合は、新しいアカウントを作成します。
  • Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。
  • または、コミットする前に Azure Cosmos DB を無料で試すこともできます。

ストレージの冗長性を更新する

以下の手順を使用して、バックアップ ストレージの冗長性を更新します。

Azure Portal

1. Azure Portal にサインインし、Azure Cosmos DB アカウントに移動します。

2. [バックアップと復元] ペインを開き、バックアップ ストレージの冗長性を更新して、[送信] を選択します。 この操作の完了には数分かかります。

   

Azure CLI

1. ご使用の Azure CLI が最新バージョン、または 2.30.0 以降のバージョンであることを確認します。 cosmosdb-preview 拡張機能がインストールされている場合は、必ず削除してください。

2. az cosmosdb locations show コマンドを使用して、アカウントが存在するリージョンで利用できるバックアップ冗長性オプションを取得します。

   az cosmosdb locations show \
         --location <region-name>
   

   出力には、次の例のような JSON が含まれているはずです。

   {
     "id": "subscriptionId/<Subscription_ID>/providers/Microsoft.DocumentDB/locations/eastus/",
     "name": "East US",
     "properties": {
       "backupStorageRedundancies": [
         "Geo",
         "Zone",
         "Local"
       ],
       "isResidencyRestricted": false,
       "supportsAvailabilityZone": true
     },
     "type": "Microsoft.DocumentDB/locations"
   }
   

   Note

   前のコマンドでは、特定のリージョンで利用できるバックアップ冗長性の一覧が示されます。 サポートされる値が、backupStorageRedundancies プロパティで表示されます。 たとえば、一部のリージョンでは、最大 3 つの冗長性オプション (Geo、Zone、Local) がサポートされています。 その他のリージョンでは、これらのオプションのサブセットがサポートされています。 更新する前に、Azure Cosmos DB アカウントで使用するすべてのリージョンでサポートされているバックアップ ストレージの冗長性オプションを選択します。

3. 選択したバックアップ冗長性オプションを指定して az cosmosdb update コマンドを使用し、既存のアカウントのバックアップの冗長性を更新します。

   az cosmosdb update \
       --resource-group <resource-group-name> \
       --name <account_name> \
       --backup-redundancy Zone
   

4. あるいは、選択したバックアップ冗長性オプションを指定して az cosmosdb create コマンドを使用し、新しいアカウントを作成します。

   az cosmosdb create \
       --resource-group <resource-group-name> \
       --name <account-name> \
       --backup-redundancy Geo \
       --locations regionName=<azure-region>
   

Azure PowerShell

1. Azure PowerShell の最新バージョンまたは 1.4.0 以降のバージョンをインストールします。

   $parameters = @{
       Name = "Az.CosmosDB"
       RequiredVersion = "1.4.0"
   }
   Install-Module @parameters
   

2. Get-AzCosmosDBLocation コマンドレットを使用して、アカウントが存在するリージョンで利用できるバックアップ冗長性オプションを取得します。

   $parameters = @{
       Location = "<azure-region>"
   }
   (Get-AzCosmosDBLocation @parameters).Properties
   

   出力には、次の例のようなコンテンツが含まれているはずです。

   SupportsAvailabilityZone IsResidencyRestricted BackupStorageRedundancies
   ------------------------ --------------------- -------------------------
                       True                 False {Geo, Zone, Local}
   

   Note

   前のコマンドでは、特定のリージョンで利用できるバックアップ冗長性の一覧が示されます。 サポートされる値が、BackupStorageRedundancies プロパティで表示されます。 たとえば、一部のリージョンでは、最大 3 つの冗長性オプション (Geo、Zone、Local) がサポートされています。 その他のリージョンでは、これらのオプションのサブセットがサポートされています。 更新する前に、Azure Cosmos DB アカウントで使用するすべてのリージョンでサポートされているバックアップ ストレージの冗長性オプションを選択します。

3. 選択したバックアップ冗長性オプションを指定して Update-AzCosmosDBAccount コマンドレットを使用し、既存のアカウントのバックアップの冗長性を更新します。

   $parameters = @{
       ResourceGroupName "<resource-group-name>"
       Name = "<account-name>"
       BackupStorageRedundancy = "Zone"
   }
   Update-AzCosmosDBAccount @parameters
   

4. あるいは、選択したバックアップ冗長性オプションを指定して New-AzCosmosDBAccount コマンドレットを使用し、新しいアカウントを作成します。

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       Name = "<account-name>"
       Location = "<azure-region>"
       BackupPolicyType = "Periodic"
       BackupStorageRedundancy = "Geo"
   }
   New-AzCosmosDBAccount @parameters
   

バックアップ ストレージの冗長性に関する Azure Policy を追加する

Azure Policy は、組織の標準を適用し、コンプライアンスを大規模に評価するのに役立ちます。 詳細については、「Azure Policy とは」を参照してください。

次のサンプルでは、Azure Cosmos DB アカウントに対して、バックアップの冗長性が Local に設定されていることを (audit を使用して) 検証する Azure ポリシーを追加する方法を示しています。

"parameters": {},
"policyRule": {
  "if": {
    "allOf": [
      {
        "field": "Microsoft.DocumentDB/databaseAccounts/backupPolicy.periodicModeProperties.backupStorageRedundancy",
        "match": "Local"
      }
    ]
  },
  "then": {
    "effect": "audit"
  }
}

次のステップ

バックアップ間隔と保有期間を変更する