Présentation de la récupération ponctuelle (PITR)

La récupération ponctuelle (PITR) Cloud Firestore offre une protection contre les suppressions ou les écritures accidentelles. PITR conserve les versions de vos documents à partir des horodatages passés. Par exemple, dans le cas d'un développeur transmettant des données incorrectes, des suppressions ou des écritures accidentelles, PITR peut récupérer les données à un moment donné dans le passé (jusqu'à un maximum de 7 jours) de manière transparente.

Pour toute base de données active qui suit les meilleures pratiques , l'utilisation de PITR n'affecte pas les performances des lectures ou des écritures.

Fenêtre PITR

Une fois le PITR activé, Cloud Firestore commence à conserver les données PITR. Les données PITR sont conservées pendant 7 jours dans la fenêtre PITR.

Vous pouvez lire les données d'un horodatage en fonction du moment où PITR a été activé :

État d'activation du PITR Premières données PITR disponibles
Désactivé 1 heure avant l'heure de la demande de lecture
activé dans les 7 jours 1 heure avant l'activation du PITR
activé il y a plus de 7 jours 7 jours avant l'heure de la demande de lecture

Une seule version par minute est conservée dans la fenêtre PITR. Vous pouvez lire des documents avec une granularité infime en utilisant un horodatage d'une minute entière. Les lectures qui ne sont pas à une granularité minute, par exemple 2023-05-30 09:00:00.1234AM , renverront une erreur indiquant que read_time est trop ancien.

Une seule version d'un document est conservée en cas d'écritures multiples. Par exemple, si un document comportait plusieurs écritures allant de v1, v2, ... vk entre 2023-05-30 09:00:00AM (exclusif) et 2023-05-30 09:01:00AM (inclus), un la demande de lecture à l'horodatage 2023-05-30 09:01:00AM renvoie la version vk du document.

Vous pouvez lire à partir des données créées pendant la fenêtre PITR. Les données sont stockées avec une granularité infime et vous pouvez récupérer des données avec la même granularité. La fonctionnalité Cloud Firestore PITR est désactivée par défaut.

Le champ earlyVersionTime de votre base de données spécifie la première heure de lecture autorisée pour vos données.

Que PITR soit activé ou non, vous pouvez lire (mais pas exporter) des documents à n'importe quel horodatage de microseconde au cours de la dernière heure, mais pas avant la première version.

Façons de récupérer des données

Il existe deux manières de récupérer des données :

  • Pour récupérer une partie de la base de données , effectuez une lecture obsolète en spécifiant une condition de requête ou en utilisant une recherche directe par clé avec un horodatage dans le passé, puis réécrivez les résultats dans la base de données active. Ceci est généralement utilisé pour les opérations chirurgicales sur une base de données en direct. Par exemple, si vous supprimez accidentellement un document particulier ou mettez à jour de manière incorrecte un sous-ensemble de données, vous pouvez le récupérer avec cette méthode. Pour obtenir des instructions, consultez récupération d'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 passé, puis importez-la dans une nouvelle base de données. L'opération d'exportation PITR prend en charge tous les filtres, y compris l'exportation de tous les documents et l'exportation de collections spécifiques. Vous pouvez exporter des données PITR dont l'horodatage correspond à une minute entière au cours des sept derniers jours, mais pas avant la première version.

Tarifs

Tenez compte des informations de tarification suivantes avant d'activer PITR pour votre base de données :

  • Stockage : Cloud Firestore mesure quotidiennement la taille de la base de données. Sur une période d'un mois, la moyenne de ces points d'échantillonnage est calculée pour calculer la taille de stockage de la base de données. Cette valeur moyenne est multipliée par le prix unitaire du PITR (GB-mois). Consultez les tarifs du stockage pour plus d’informations.

    Le stockage PITR n'a pas de niveau gratuit et vous devez activer la facturation si vous souhaitez utiliser PITR.

  • Facturation du calcul : toutes les requêtes que vous effectuez pendant la fenêtre PITR de 7 jours, que ce soit par le biais de lectures ou d'exportations obsolètes, entraînent des coûts d'opération de lecture en fonction du nombre de documents lus. Voir les tarifs pour plus d'informations.

  • Facturation minimale : vous pouvez être facturé jusqu'à 1 jour de coût de stockage PITR même si vous désactivez PITR dans la journée suivant l'activation.

Et après