Modèle de ressource pour la fonctionnalité Azure Cosmos DB de restauration à un instant dans le passé

S’APPLIQUE À : NoSQL MongoDB Gremlin Table

Cet article explique le modèle de ressource pour la fonctionnalité Azure Cosmos DB de restauration à un instant dans le passé. Il explique les paramètres qui prennent en charge la sauvegarde continue et les ressources qui peuvent être restaurées. Cette fonctionnalité est prise en charge dans les API Azure Cosmos DB pour SQL, Azure Cosmos DB pour Gremlin, Table et Azure Cosmos DB pour MongoDB.

Modèle de ressource du compte de base de données

Le modèle de ressource du compte de base de données est mis à jour avec quelques propriétés supplémentaires pour prendre en charge les nouveaux scénarios de restauration. Ces propriétés sont BackupPolicy, CreateMode et RestoreParameters.

BackupPolicy

Une nouvelle propriété dans la stratégie de sauvegarde au niveau du compte nommée Type sous le paramètre backuppolicy active les fonctionnalités de sauvegarde continue et de restauration à un instant dans le passé. Ce mode est appelé sauvegarde continue. Vous pouvez définir ce mode lors de la création du compte ou lors de la migration d’un compte du mode périodique vers le mode continu. Une fois que le mode continu est activé, les fonctionnalités de sauvegarde continue et de restauration à un instant dans le passé seront activées par défaut sur tous les conteneurs et toutes les bases de données créés dans ce compte. Le niveau de sauvegarde continue peut être défini sur Continuous7Days ou Continuous30Days. Par défaut, si aucun niveau n’est fourni, Continuous30Days est appliqué au compte.

CreateMode

Cette propriété indique la façon dont le compte a été créé. Les valeurs possibles sont Default et Restore. Pour effectuer une restauration, définissez cette valeur sur Restore et fournissez les valeurs appropriées dans la propriété RestoreParameters.

publicNetworkAccess

Cette propriété doit être définie sur « Désactivé » pour restaurer le compte sans accès au réseau public. Si cette propriété n’est pas fournie, la restauration du compte se poursuit avec publicNetworkAccess en tant que Enabled.

RestoreParameters

La ressource RestoreParameters contient les détails de l’opération de restauration, notamment l’ID de compte, l’heure de restauration et les ressources qui doivent être restaurées.

Exemple de ressource

Le code JSON suivant est un exemple de ressource de compte de base de données où la sauvegarde continue est activée :

{
  "location": "westus",
  "properties": {
    "databaseAccountOfferType": "Standard",
    "locations": [
      {
        "failoverPriority": "0",
        "locationName": "southcentralus",
        "isZoneRedundant": "false"
      }
    ],
    "createMode": "Restore",
    "publicNetworkAccess":"Disabled",
    "restoreParameters": {
      "restoreMode": "PointInTime",
      "restoreWithTtlDisabled" : "true",
      "restoreSource": "/subscriptions/subid/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "restoreTimestampInUtc": "2020-06-11T22:05:09Z",
      "databasesToRestore": [
        {
          "databaseName": "db1",
          "collectionNames": [
            "collection1",
            "collection2"
          ]
        },
        {
          "databaseName": "db2",
          "collectionNames": [
            "collection3",
            "collection4"
          ]
        }
      ]
    },
    "backupPolicy": {
      "type": "Continuous"
      ...
    }
  }
}

Ressources restaurables

Un ensemble de nouvelles ressources et d’API est disponible pour vous aider à découvrir des informations essentielles sur les ressources, notamment :

• Où les ressources peuvent être restaurées
• Emplacements depuis lesquels les ressources peuvent être restaurées
• Timestamps lorsque des opérations de clé ont été effectuées sur ces ressources.

Compte de base de données restaurable

Cette ressource contient une instance de compte de base de données qui peut être restaurée. Le compte de base de données peut être soit un compte supprimé, soit un compte actif. Il contient des informations qui vous permettent de trouver le compte de base de données source que vous souhaitez restaurer.

Pour obtenir la liste de tous les comptes pouvant être restaurés, consultez les articles Comptes de base de données restaurables – Liste ou Comptes de base de données restaurables – Liste par emplacement.

Base de données SQL restaurable

Chaque ressource contient des informations sur un événement de mutation, tel que la création et la suppression, qui s’est produit sur la base de données SQL. Ces informations peuvent être utiles dans les cas où la base de données a été supprimée par erreur et si vous avez besoin de savoir à quel moment cet événement s’est produit.

Pour obtenir la liste de toutes les mutations de base de données, consultez l’article Bases de données NoSQL restaurables – Liste.

Conteneur SQL restaurable

Chaque ressource contient des informations sur un événement de mutation, tel que la création et la suppression, qui s’est produit sur le conteneur SQL. Ces informations peuvent être utiles dans les cas où le conteneur a été modifié ou supprimé et si vous avez besoin de savoir à quel moment cet événement s’est produit.

Pour obtenir la liste de toutes les mutations de conteneur sous la même base de données, consultez l’article Conteneurs NoSQL récupérables– Liste.

Ressources SQL restaurables

Chaque ressource représente une base de données unique et tous les conteneurs sous cette base de données.

Pour obtenir la liste de toutes les combinaisons de bases de données et conteneur SQL qui existent sur le compte à l’heure et à l’emplacement donnés, consultez l’article Ressources NoSQL récupérables – Liste.

Base de données MongoDB restaurable

Chaque ressource contient des informations sur un événement de mutation, tel que la création et la suppression, qui s’est produit sur la base de données MongoDB. Ces informations peuvent être utiles dans le cas où la base de données a été supprimée par erreur et où l’utilisateur doit déterminer à quel moment cet événement s’est produit.

Pour obtenir la liste de toutes les mutations de base de données, consultez l’article Bases de données MongoDB restaurables – Liste.

Collection MongoDB restaurable

Chaque ressource contient des informations sur un événement de mutation, tel que la création et la suppression, qui s’est produit sur la collection MongoDB. Ces informations peuvent être utiles dans les cas où la collection a été modifiée ou supprimée et où l’utilisateur doit déterminer à quel moment cet événement s’est produit.

Pour obtenir la liste de toutes les mutations de conteneur sous la même base de données, consultez l’article Ressources MongoDB récupérables– Liste.

Ressources MongoDB restaurables

Chaque ressource représente une base de données unique et toutes les collections sous cette base de données.

Pour obtenir la liste de toutes les combinaisons de bases de données et collections MongoDB qui existent sur le compte à l’heure et à l’emplacement donnés, consultez Ressources MongoDB récupérables – Liste.

Ressources Graph restaurables

Chaque ressource représente une base de données unique et tous les graphes sous cette base de données.

Pour obtenir la liste de toutes les combinaisons de bases de données et graphes Gremlin qui existent sur le compte à l’heure et à l’emplacement donnés, consultez l’article Ressources Graph restaurables – Liste.

Base de données de graphe restaurable

Chaque ressource contient des informations sur un événement de mutation, tel que la création et la suppression, qui s’est produit sur la base de données de graphe. Ces informations peuvent être utiles dans le cas où la base de données a été supprimée par erreur et où l’utilisateur doit déterminer à quel moment cet événement s’est produit.

Pour obtenir un flux d’événements de toutes les mutations sur la base de données Gremlin, consultez Bases de données de graphique pouvant être restaurées - Liste.

Graphes restaurables

Chaque ressource contient des informations sur un événement de mutation, tel que la création et la suppression, qui s’est produit sur le graphe. Ces informations peuvent être utiles dans les cas où le graphe a été modifié ou supprimé et si vous avez besoin de savoir à quel moment cet événement s’est produit.

Pour obtenir la liste de toutes les mutations de conteneur sous la même base de données, consultez l’article Graphes restaurables – Liste.

Ressources de table restaurables

Répertorie toutes les tables Azure Cosmos DB restaurables disponibles pour un compte de base de données spécifique à un moment et un emplacement donnés. Notez que l’API pour Table ne spécifie pas de base de données explicite.

Pour obtenir la liste des tables qui existent sur le compte à l’heure et à l’emplacement donnés, consultez l’article Ressources SQL restaurables – Liste.

Table restaurable

Chaque ressource contient des informations sur un événement de mutation, tel que la création et la suppression, qui s’est produit sur la table. Ces informations peuvent être utiles dans les cas où la table a été modifiée ou supprimée et si vous avez besoin de savoir à quel moment cet événement s’est produit.

Pour obtenir la liste de toutes les mutations de table sous la même base de données, consultez l’article Tables restaurables – Liste.

Étapes suivantes

• Approvisionnez la sauvegarde continue à l’aide du portail Azure, de PowerShell, de l’interface CLI ou d’Azure Resource Manager.
• Restaurez un compte à l’aide du portail Azure, de PowerShell, de l’interface CLI ou d’Azure Resource Manager.
• Migrer vers un compte à partir d’une sauvegarde périodique vers une sauvegarde continue.
• Gérez les autorisations requises pour restaurer les données en mode de sauvegarde continue.