Ändern des regelmäßigen Sicherungsintervalls und Aufbewahrungszeitraums in Azure Cosmos DB

Artikel
08/15/2024

GILT FÜR: NoSQL MongoDB Cassandra Gremlin Tabelle

Von Azure Cosmos DB wird alle vier Stunden automatisch eine vollständige Sicherung Ihrer Daten erstellt, und es sind immer die beiden neuesten Sicherungen gespeichert. Diese Konfiguration ist die Standardoption, die ohne Zusatzkosten angeboten wird. Sie können das Standardsicherungsintervall und den Aufbewahrungszeitraum während der Erstellung des Azure Cosmos DB-Kontos oder nach Erstellen des Kontos ändern. Die Sicherungskonfiguration wird auf der Ebene des Azure Cosmos DB-Kontos festgelegt und muss für jedes Konto durchgeführt werden. Nachdem Sie die Sicherungsoptionen für ein Konto konfiguriert haben, wird es auf alle Container innerhalb dieses Kontos angewandt. Sie können diese Einstellungen ändern, indem Sie das Azure-Portal, Azure PowerShell oder die Azure CLI verwenden.

Voraussetzungen

Ein vorhandenes Azure Cosmos DB-Konto
- Falls Sie bereits über ein Azure-Abonnement verfügen, erstellen Sie ein neues Konto.
- Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
- Alternativ können Sie Azure Cosmos DB kostenlos testen, bevor Sie sich festlegen.

Vorbereitung

Wenn Sie Ihre Daten versehentlich gelöscht oder beschädigt haben, verlängern Sie vor dem Erstellen einer Supportanfrage zum Wiederherstellen der Daten den Aufbewahrungszeitraum für Ihr Konto unbedingt auf mindestens sieben Tage. Es empfiehlt sich, den Aufbewahrungszeitraum innerhalb von acht Stunden nach diesem Ereignis zu verlängern. Auf diese Weise hat das Azure Cosmos DB-Team genügend Zeit, Ihr Konto wiederherzustellen.

Ändern von Sicherungsoptionen für ein vorhandenes Konto

Verwenden Sie die folgenden Schritte, um die Standardsicherungsoptionen für ein vorhandenes Azure Cosmos DB-Konto zu ändern.

Melden Sie sich beim Azure-Portal an.
Navigieren Sie zu Ihrem Azure Cosmos DB-Konto, und öffnen Sie den Bereich Sichern & Wiederherstellen. Aktualisieren Sie das Sicherungsintervall und den Aufbewahrungszeitraum für Sicherungen nach Bedarf.
- Sicherungsintervall: das Intervall, in dem Azure Cosmos DB versucht, eine Sicherung der Daten zu erstellen. Die Sicherung nimmt eine gewisse Zeit in Anspruch und kann in einigen Fällen aufgrund von Downstreamabhängigkeiten möglicherweise zu einem Fehler führen. Azure Cosmos DB versucht, eine Sicherung im konfigurierten Intervall zu erstellen, es kann jedoch nicht garantiert werden, dass die Sicherung innerhalb dieses Zeitintervalls abgeschlossen wird. Sie können diesen Wert in Stunden oder Minuten konfigurieren. Das Sicherungsintervall darf nicht kürzer als eine Stunde und nicht länger als 24 Stunden sein. Wenn Sie dieses Intervall ändern, wird das neue Intervall ab dem Zeitpunkt wirksam, zu dem die letzte Sicherung erstellt wurde.
- Beibehaltung der Sicherung: Dies stellt den Aufbewahrungszeitraum für die einzelnen Sicherungen dar. Sie können die Zeit in Stunden oder Tagen konfigurieren. Der minimale Aufbewahrungszeitraum darf nicht kürzer als das Zweifache des Sicherungsintervalls (in Stunden) und nicht länger als 720 Stunden sein.
- Aufbewahrte Kopien der Daten: Standardmäßig werden zwei Sicherungskopien Ihrer Daten kostenlos angeboten. Wenn Sie mehr als zwei Kopien benötigen, fallen zusätzliche Gebühren an. Im Abschnitt „Verbrauchter Speicher“ auf der Preisseite erfahren Sie den genauen Preis für zusätzliche Kopien.
- Sicherungsspeicherredundanz – Wählen Sie die erforderliche Speicherredundanzoption aus. Weitere Informationen finden Sie unter Redundanz für Sicherungsspeicher. Standardmäßig verfügen Ihre vorhandenen Konten im regelmäßigen Sicherungsmodus über georedundanten Speicher, wenn die Region, in der das Konto bereitgestellt wird, diesen Speicher unterstützt. Andernfalls erfolgt ein Fallback des Kontos auf die höchste verfügbare Redundanzoption. Sie können einen anderen Speicher wie z. B. lokal redundanten Speicher auswählen, um sicherzustellen, dass die Sicherung nicht in einer anderen Region repliziert wird. Die an einem vorhandenen Konto vorgenommenen Änderungen werden nur auf zukünftige Sicherungen angewendet. Nach der Aktualisierung der Redundanz für den Sicherungsspeicher eines vorhandenen Kontos kann maximal die doppelte Zeit eines Sicherungsintervalls verstreichen, bis die Änderungen wirksam werden. Darüber hinaus verlieren Sie den Zugriff, um die älteren Sicherungen sofort wiederherzustellen.
Hinweis

Ihnen muss die Azure Cosmos DB-Rolle „Operator“ auf Abonnementebene zugewiesen werden, damit Sie Redundanz für den Sicherungsspeicher konfigurieren können.

Verwenden Sie den az cosmosdb update-Befehl, um die regelmäßigen Sicherungsoptionen für ein vorhandenes Konto zu aktualisieren.

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

Verwenden Sie das Update-AzCosmosDBAccount-Cmdlet, um die regelmäßigen Sicherungsoptionen für ein vorhandenes Konto zu aktualisieren.

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

Verwenden Sie die folgende Azure Resource Manager JSON-Vorlage, um die regelmäßigen Sicherungsoptionen für ein vorhandenes Konto zu aktualisieren.

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

Alternativ können Sie die Bicep-Variante derselben Vorlage verwenden.

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

Konfigurieren der Sicherungsoptionen für ein neues Konto

Verwenden Sie diese Schritte, um die Standardsicherungsoptionen für ein neues Azure Cosmos DB-Konto zu ändern.

Hinweis

Zur Veranschaulichung wird in diesen Beispielen davon ausgegangen, dass Sie ein Azure Cosmos DB for NoSQL-Konto erstellen. Die Schritte sind sehr ähnlich für Konten, die andere APIs verwenden.

Wenn Sie ein neues Konto bereitstellen, wählen Sie auf der Registerkarte Sicherungsrichtlinie die Sicherungsrichtlinie Periodisch* aus. Bei einer Richtlinie für regelmäßige Sicherungen können Sie das Sicherungsintervall, den Aufbewahrungszeitraum und die Redundanz für den Sicherungsspeicher konfigurieren. Sie können z. B. die Optionen Lokal redundanter Sicherungsspeicher oder Zonenredundanter Sicherungsspeicher auswählen, um die Replikation von Sicherungsdaten außerhalb Ihrer Region zu verhindern.

Verwenden Sie den az cosmosdb create-Befehl, um ein neues Konto mit den angegebenen Optionen für regelmäßige Sicherungen zu erstellen.

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

Verwenden Sie das New-AzCosmosDBAccount-Cmdlet, um ein neues Konto mit den angegebenen Optionen für regelmäßige Sicherungen zu erstellen.

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

Verwenden Sie die folgende Azure Resource Manager JSON-Vorlage, um die regelmäßigen Sicherungsoptionen für ein vorhandenes Konto zu aktualisieren.

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

Alternativ können Sie die Bicep-Variante derselben Vorlage verwenden.

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

Nächste Schritte

Anfordern der Datenwiederherstellung aus einer Sicherung

Freigeben über