Partager via

Migrer un compte Azure Cosmos DB du mode de sauvegarde périodique vers le mode de sauvegarde continue

  • S’applique à: ✅ NoSQL, ✅ MongoDB, ✅ Apache Gremlin, ✅ Table

Les comptes Azure Cosmos DB avec une stratégie de sauvegarde en mode périodique peuvent être migrés en mode continu à l’aide du portail Azure, d’Azure CLI, d’Azure PowerShell ou de modèles Bicep. La migration périodique vers le mode continu est unidirectionnel et n’est pas réversible. Après avoir migré du mode périodique vers le mode continu, vous bénéficiez des avantages du mode continu.

Principales raisons de migrer vers le mode continu :

  • Restaurez vous-même des données à l’aide du portail Azure, de l’interface CLI ou de PowerShell.
  • Restaurez à une seconde précise dans les 30 ou 7 derniers jours.
  • Assurez-vous que les sauvegardes sont cohérentes entre les partitions ou les plages de clés de partition.
  • Restaurez un conteneur, une base de données ou le compte complet après la suppression ou les modifications.
  • Sélectionnez des événements sur le conteneur, la base de données ou le compte, puis choisissez quand démarrer la restauration.

Remarque

La migration est unidirectionnelle et ne peut pas être inversée. Une fois que vous avez migré du mode périodique vers le mode continu, vous ne pouvez pas revenir en arrière.

Vous pouvez migrer un compte vers le mode de sauvegarde continue uniquement si ces conditions sont vraies. Vérifiez également les limitations de restauration dans le temps avant de migrer :

  • Le compte est l’API pour NoSQL, Table, Gremlin ou MongoDB.
  • Le compte n’avait jamais désactivé Azure Synapse Link pour un conteneur.

Si le compte utilise des clés gérées par le client, déclarez une identité managée (affectée par le système ou affectée par l’utilisateur) dans la stratégie d’accès Key Vault et définissez-la comme identité par défaut sur le compte.

Important

Après avoir migré votre compte vers le mode de sauvegarde continue, le coût peut changer par rapport au mode de sauvegarde périodique. Le choix entre 30 jours et sept jours affecte également le coût de sauvegarde. Pour plus d’informations, consultez la tarification du mode de sauvegarde continue.

Prerequisites

  • Un compte Azure Cosmos DB
  • Autorisation Microsoft.DocumentDB/databaseAccounts/write de contrôle d’accès en fonction du rôle pour le compte en cours de migration
  • Dernière version d’Azure CLI ou d’Azure PowerShell

Migration à l’aide du portail

Procédez comme suit pour migrer votre compte de la sauvegarde périodique vers le mode de sauvegarde continue :

  1. Connectez-vous à Azure CLI.

    az login

  2. Migrez le compte vers le niveau continuous30days ou continuous7days.

    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"

    Remarque

    Si vous ne fournissez pas de valeur de niveau, la valeur par défaut est continuous30days.

  3. Une fois la migration terminée, la sortie montre l’objet backupPolicy, qui inclut la propriété type avec la valeur Continuous.

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

Vérifier l’état de la migration

Utilisez Azure CLI pour vérifier l’état d’une migration existante.

  1. Exécutez la commande suivante pour obtenir les propriétés du compte Azure Cosmos DB.

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

  2. Vérifiez les propriétés status et targetType de l'objet backupPolicy. L’état devrait être InProgress après le démarrage de la migration.

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

  3. Une fois la migration terminée, le type de sauvegarde change Continuous et inclut le niveau choisi. Si le niveau n’a pas été spécifié, il est défini sur Continuous30Days. Réexécutez la même az cosmosdb show commande pour vérifier l’état.

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

Changer les niveaux du mode continu

Vous pouvez basculer entre Continuous30Days et Continous7Days dans Azure PowerShell, Azure CLI ou le portail Azure.

La commande Azure CLI suivante montre le basculement d’un compte existant vers Continous7Days :

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

Vous pouvez aussi utiliser un modèle ARM dans une méthode similaire à l’utilisation d’Azure CLI et d’Azure PowerShell.

Remarque

Lorsque vous passez du niveau 30 jours au niveau de 7 jours, vous perdez immédiatement la possibilité de restaurer des données antérieures à sept jours. Lorsque vous passez du niveau 7 jours au niveau de 30 jours, vous pouvez uniquement restaurer les données des sept derniers jours jusqu’à ce que les nouvelles sauvegardes s’accumulent. Vous pouvez vérifier l’heure de restauration la plus ancienne disponible à l’aide d’Azure PowerShell ou d’Azure CLI. Les changements de prix lors du changement de niveaux prennent effet immédiatement.

Migrer vers une sauvegarde continue à l’aide de Bicep

Pour migrer vers le mode de sauvegarde continue à l’aide d’un modèle Bicep et d’Azure Resource Manager, recherchez la section BackupPolicy de votre modèle et mettez à jour la type propriété.

  1. Considérez cet exemple de modèle qui a une Periodic stratégie de sauvegarde :

    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. Mettez à jour l’exemple de modèle pour utiliser Continuous le mode de sauvegarde au niveau 7 jours :

    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. Déployez le modèle à l’aide d’Azure PowerShell ou de l’interface CLI. L’exemple suivant montre comment déployer le modèle avec une commande CLI :

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

Contenu connexe

  • Last updated on