Présentation de la récupération à un moment précis (PITR)

La récupération à un moment précis Cloud Firestore offre une protection contre des suppressions ou écritures accidentelles. La récupération à un moment précis gère les versions des horodatages antérieurs. Par exemple, dans le cas d'un développeur des données incorrectes, des suppressions ou des écritures accidentelles, la récupération à un moment précis des données à un moment précis dans le passé (jusqu'à sept jours) de manière transparente.

Pour toute base de données active qui respecte les bonnes pratiques, utilisez de la récupération PITR n'affecte pas les performances des lectures ou des écritures.

Fenêtre PITR

Une fois la récupération à un moment précis activée, Cloud Firestore commence à conserver les données correspondantes. Les données PITR sont sont conservés pendant sept jours au cours de la période PITR.

Vous pouvez lire les données d'un horodatage basé sur le moment où la récupération à un moment précis a été activée:

État d'activation de la récupération à un moment précis Premières données PITR disponibles
Désactivé 1 heure avant l'heure de la requête de lecture
activées sous sept jours 1 heure avant l'activation de la récupération à un moment précis
activée il y a plus de sept jours 7 jours avant l'heure de la requête de lecture

Une seule version par minute est conservée dans la fenêtre PITR. Vous pouvez lire des documents à la minute près à l'aide d'un code temporel d'une minute entière. Les lectures qui ne sont pas à la granularité de la minute, par exemple 2023-05-30 09:00:00.1234AM, renvoient une erreur indiquant que la valeur read_time est trop ancienne.

Une seule version d'un document est conservée en cas d'écritures multiples. Pour exemple, si un document comporte plusieurs écritures allant de v1, v2, ... vk entre 2023-05-30 09:00:00AM (exclu) et 2023-05-30 09:01:00AM (inclus) code temporel, une requête de lecture au code temporel 2023-05-30 09:01:00AM renvoie le vk du document.

Vous pouvez lire les données créées lors de la récupération à un moment précis fenêtre. Les données sont stockées à la minute près et vous pouvez les récupérer avec le même niveau de précision. La fonctionnalité PITR Cloud Firestore est désactivée par défaut.

Le champ earliestVersionTime de votre base de données spécifie la de lecture la plus proche autorisée pour vos données.

Que la récupération à un moment précis soit activée ou non, vous pouvez lire (mais pas exporter) les documents à n'importe quel horodatage de la microseconde au cours de la dernière heure, mais pas avant le début de la version.

Méthodes de récupération des données

Il existe deux façons de récupérer des données :

  • Pour récupérer une partie de la base de données, effectuez une lecture non actualisée en spécifiant une condition de requête ou en utilisant une recherche de clé directe avec un code temporel passé, puis écrivez à nouveau les résultats dans la base de données active. C'est généralement utilisé pour des opérations chirurgicales sur une base de données en direct. Par exemple, si vous supprimez accidentellement un document spécifique ou mettez à jour un sous-ensemble de données de manière incorrecte, vous pouvez les récupérer à l'aide de cette méthode. Pour obtenir des instructions, consultez l'article récupérer une partie de votre base de données.

  • Pour récupérer l'intégralité de la base de données, exportez la base de données en spécifiant un horodatage dans le passé, puis l'importer dans une nouvelle base de données. L'opération d'exportation PITR est compatible avec tous les filtres, y compris l'exportation de tous les documents et l'exportation de collections spécifiques. Vous pouvez exporter les données PITR correspond à un code temporel d'une minute entière au cours des sept derniers jours, mais pas avant au début de la version.

Tarifs

Tenez compte des informations tarifaires suivantes avant d'activer la récupération PITR pour votre base de données :

  • Stockage : Cloud Firestore mesure la taille de la base de données chaque jour. Au cours de la période période d'un mois, la moyenne de ces points d'échantillonnage est calculée la taille de stockage de la base de données. Cette valeur moyenne est multipliée par le prix unitaire PITR (Go-mois). Pour en savoir plus, consultez les tarifs de stockage.

    Il n'existe pas de version sans frais pour le stockage PITR, et vous devez activer la facturation si vous souhaitez utiliser cette fonctionnalité.

  • Facturation basée sur le calcul: toutes les requêtes que vous effectuez au cours de la période de récupération à un moment précis de sept jours, via des lectures ou des exportations non actualisées, entraînent des coûts d'opérations de lecture. en fonction du nombre de documents lus. Consultez la page Tarifs pour plus de détails.

  • Facturation minimale : vous pouvez être facturé jusqu'à un jour de stockage de la récupération à un moment précis, même si vous désactivez cette fonctionnalité dans un délai d'un jour après l'avoir activée.

Étape suivante