Migrieren eines Azure Cosmos DB-Kontos vom zyklischen Sicherungsmodus zum fortlaufenden Sicherungsmodus

  • Gilt für:: ✅ NoSQL, ✅ MongoDB, ✅ Apache Gremlin, ✅ Table

Azure Cosmos DB-Konten mit Sicherungsrichtlinie für den regelmäßigen Modus können mithilfe des Azure-Portals, der Azure CLI, der Azure PowerShell- oder Bicep-Vorlagen in den fortlaufenden Modus migriert werden. Die Migration vom periodischen zum fortlaufenden Modus ist unidirektionale und nicht umkehrbar. Nachdem Sie vom periodischen zum fortlaufenden Modus migriert wurden, profitieren Sie vom kontinuierlichen Modus.

Wichtige Gründe für die Migration zum fortlaufenden Modus:

  • Wiederherstellen von Daten selbst mithilfe von Azure-Portal, CLI oder PowerShell.
  • Stellen Sie eine bestimmte Sekunde innerhalb des letzten 30-Tage- oder 7-Tage-Fensters wieder her.
  • Stellen Sie sicher, dass Sicherungen über Datenfragmente oder Partitionsschlüsselbereiche hinweg konsistent sind.
  • Wiederherstellen eines Containers, einer Datenbank oder eines vollständigen Kontos nach dem Löschen oder Ändern.
  • Wählen Sie Ereignisse für den Container, die Datenbank oder das Konto aus, und wählen Sie aus, wann die Wiederherstellung gestartet werden soll.

Note

Die Migration ist unidirektionale Und kann nicht rückgängig gemacht werden. Sobald Sie vom periodischen Modus zum fortlaufenden Modus migriert wurden, können Sie nicht wieder zurückwechseln.

Sie können ein Konto nur dann in den fortlaufenden Sicherungsmodus migrieren, wenn diese Bedingungen erfüllt sind. Überprüfen Sie außerdem die Einschränkungen für die zeitpunktbezogene Wiederherstellung, bevor Sie migrieren.

  • Das Konto ist API für NoSQL, Table, Gremlin oder MongoDB.
  • Bei einem Konto wurde der Azure Synapse-Link für einen Container nie deaktiviert.

Wenn das Konto vom Kunden verwaltete Schlüssel verwendet, deklarieren Sie eine verwaltete Identität (vom System zugewiesene oder vom Benutzer zugewiesene) in der Key Vault-Zugriffsrichtlinie, und legen Sie sie als Standardidentität für das Konto fest.

Important

Nachdem Sie Ihr Konto in den fortlaufenden Sicherungsmodus migriert haben, können sich die Kosten im Vergleich zum regelmäßigen Sicherungsmodus ändern. Die Wahl zwischen 30 Tagen und sieben Tagen wirkt sich auch auf die Sicherungskosten aus. Ausführliche Informationen finden Sie in den Preisen für den fortlaufenden Sicherungsmodus.

Prerequisites

  • Ein Azure Cosmos DB-Konto
  • Die Microsoft.DocumentDB/databaseAccounts/write rollenbasierte Zugriffssteuerungsberechtigung für das Konto, das migriert wird
  • Neueste Version von Azure CLI oder Azure PowerShell

Migrieren mithilfe des Portals

Führen Sie die folgenden Schritte aus, um Ihr Konto vom zyklischen Sicherungsmodus zum Modus der fortlaufenden Sicherung zu migrieren:

  1. Melden Sie sich bei der Azure CLI an.

    az login

  2. Migrieren Sie das Konto zur continuous30days- oder continuous7days-Dienstebene.

    az cosmosdb update \
    --resource-group "<resource-group-name>" \
    --name "<account-name>" \
    --backup-policy-type "Continuous"

    az cosmosdb update \
    --resource-group "<resource-group-name>" \
    --name "<account-name>" \
    --backup-policy-type "Continuous" \
    --continuous-tier "Continuous7Days"

    Note

    Wenn Sie keinen Ebenenwert angeben, lautet continuous30daysder Standardwert .

  3. Nachdem die Migration erfolgreich abgeschlossen wurde, zeigt die Ausgabe das backupPolicy-Objekt an, das die type-Eigenschaft mit dem Wert Continuous enthält.

    {
  ...
  "backupPolicy": {
    "continuousModeProperties": {
      "tier": "Continuous7Days"
    },
    "migrationState": null,
    "type": "Continuous"
  },
  ...
}

Überprüfen des Migrationstatus

Verwenden Sie die Azure CLI, um den Status einer vorhandenen Migration zu überprüfen.

  1. Führen Sie den folgenden Befehl aus, um die Eigenschaften des Azure Cosmos DB-Kontos abzurufen.

    az cosmosdb show \
    --resource-group "<resource-group-name>" \
    --name "<account-name>" \

  2. Überprüfen Sie die Eigenschaften von status und targetType des backupPolicy Objekts. Der Status sollte InProgress sein, nachdem die Migration beginnt.

    {
  ...
  "backupPolicy": {
    ...
    "migrationState": {
      "status": "InProgress",
      "targetType": "Continuous"
    },
    "type": "Periodic"
  },
  ...
}

  3. Wenn die Migration abgeschlossen ist, ändert sich der Sicherungstyp in Continuous, einschließlich der ausgewählten Ebene. Wenn keine Dienstebene angegeben wurde, wird die Dienstebene auf Continuous30Days festgelegt. Führen Sie denselben az cosmosdb show Befehl erneut aus, um den Status zu überprüfen.

    {
  ...
  "backupPolicy": {
    "continuousModeProperties": {
      "tier": "Continuous7Days"
    },
    "migrationState": null,
    "type": "Continuous"
  },
  ...
}

Ändern von Dienstebenen des fortlaufenden Modus

Sie können zwischen Continuous30Days und Continous7Days in Azure PowerShell, Azure CLI oder dem Azure-Portal wechseln.

Der folgende Azure CLI-Befehl veranschaulicht das Ändern eines vorhandenen Kontos in Continous7Days:

az cosmosdb update \
    --resource-group "<resource-group-name>" \
    --name "<account-name>" \
    --backup-policy-type "Continuous" \
    --continuous-tier "Continuous7Days"

Sie können auch eine ARM-Vorlage auf eine Weise verwenden, die der Nutzung von Azure CLI und Azure PowerShell ähnelt.

Note

Wenn Sie von der 30-Tage-Stufe auf die 7-Tage-Ebene wechseln, verlieren Sie sofort die Möglichkeit, Daten wiederherstellen zu können, die älter als sieben Tage sind. Wenn Sie von der 7-Tage-Stufe auf die 30-Tage-Stufe wechseln, können Sie nur Daten aus den letzten sieben Tagen wiederherstellen, bis neue Sicherungen erstellt werden. Sie können die früheste verfügbare Wiederherstellungszeit mithilfe von Azure PowerShell oder Azure CLI überprüfen. Preisänderungen durch Wechseln der Stufen werden sofort wirksam.

Migrieren Sie zur kontinuierlichen Sicherung mit Bicep

Um mithilfe einer Bicep-Vorlage und azure Resource Manager zum fortlaufenden Sicherungsmodus zu migrieren, suchen Sie den Abschnitt "backupPolicy" Ihrer Vorlage, und aktualisieren Sie die type Eigenschaft.

  1. Betrachten Sie diese Beispielvorlage mit einer Periodic Sicherungsrichtlinie:

    resource azureCosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2025-04-15' = {
  name: '<account-name>'
  properties: {
    // Other required properties omitted for brevity
    backupPolicy: {
      type: 'Periodic'
      periodicModeProperties: {
        backupIntervalInMinutes: 240 // 4 hours
        backupRetentionIntervalInHours: 48 // 2 days
      }
    }
  }
}

  2. Aktualisieren Sie die Beispielvorlage, um den Sicherungsmodus auf der Continuous-Ebene zu verwenden:

    resource azureCosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2025-04-15' = {
  name: '<account-name>'
  properties: {
    // Other required properties omitted for brevity
    backupPolicy: {
      type: 'Continuous'
      continuousModeProperties: {
        tier: 'Continuous7Days'
      }
    }
  }
}

  3. Stellen Sie die Vorlage mithilfe von Azure PowerShell oder CLI bereit. Im folgenden Beispiel wird gezeigt, wie die Vorlage mit einem CLI-Befehl bereitgestellt wird:

    az deployment group create \
    --resource-group "<resource-group-name>" \
    --template-file "<template-file-path>"

Verwandte Inhalte

  • Last updated on