La récupération à un moment précis (PITR) protège contre les suppressions ou les écritures accidentelles. Elle conserve les versions de vos documents à partir d'horodatages passés. Par exemple, si un développeur envoie des données incorrectes, ou effectue des suppressions ou des écritures accidentelles, la récupération PITR peut restaurer les données à un moment antérieur (jusqu'à sept jours maximum).
Pour toute base de données active qui suit les bonnes pratiques, l'utilisation de la récupération PITR n'affecte pas les performances de lecture ou d'écriture.Fenêtre de récupération PITR
Une fois la récupération PITR activée, Cloud Firestore commence à conserver les données PITR. Les données PITR sont conservées pendant sept jours dans la fenêtre de récupération PITR.
Vous pouvez lire les données d'un horodatage en fonction du moment où la récupération PITR a été activée :
| État de l'activation de la récupération PITR | Premières données PITR disponibles | |
|---|---|---|
| Désactivé | 1 heure avant l'heure de la requête de lecture | |
| Activé au cours des sept derniers jours | 1 heure avant l'activation de la récupération PITR | |
| Activé il y a plus de sept jours | Sept jours avant l'heure de la requête de lecture |
Une seule version par minute est conservée dans la fenêtre de récupération PITR. Vous pouvez lire les documents avec une granularité à la minute à l'aide d'un horodatage d'une minute entière. Les lectures qui ne sont pas à la minute près, comme 2023-05-30 09:00:00.1234AM, renvoient 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 a fait l'objet de plusieurs écritures allant de v1, v2, ... vk entre
2023-05-30 09:00:00AM (exclus) et 2023-05-30 09:01:00AM (inclus)
horodatage, une requête de lecture à l'horodatage 2023-05-30 09:01:00AM renvoie la vk
version du document.
Vous pouvez lire les données créées pendant la fenêtre de récupération PITR. Les données sont stockées avec une granularité à la minute, et vous pouvez les récupérer avec la même granularité. La fonctionnalité de récupération PITR est désactivée par défaut.
Le champ earliestVersionTime de votre base de données spécifie l'
heure de lecture autorisée la plus ancienne pour vos données.
Que la récupération PITR soit activée ou non, vous pouvez lire (mais pas exporter) des documents à n'importe quel horodatage avec une granularité à la microseconde au cours de la dernière heure, mais pas avant earliestVersionTime.
Méthodes de récupération des données
Il existe plusieurs 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 directe par clé avec un horodatage dans le passé, puis écrivez à nouveau les résultats dans la base de données active. Cette méthode est généralement utilisée pour des opérations chirurgicales sur une base de données active. 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 Récupérer une partie de votre base de données.
Pour récupérer l'intégralité de la base de données, utilisez l'une des options suivantes :
Clonez la base de données pour créer une copie de la base de données à un horodatage spécifique.
Exportez la base de données et spécifiez un horodatage passé, puis importez-la 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 cloner ou exporter des données PITR dont l'horodatage est un horodatage d'une minute entière au cours des sept derniers jours, mais pas avant
earliestVersionTime.
Tarifs
Avant d'activer la récupération PITR pour votre base de données, tenez compte des informations tarifaires suivantes :
Stockage : Cloud Firestore mesure la taille de la base de données quotidiennement. Sur une période d'un mois, ces points d'échantillon sont moyennés pour calculer la taille de l'espace de stockage de la base de données. Cette valeur moyenne est multipliée par le prix unitaire de la récupération PITR (Go-mois). Pour en savoir plus, consultez les tarifs de stockage.
Le stockage PITR ne dispose pas de niveau sans frais. Vous devez activer la facturation si vous souhaitez utiliser la récupération PITR.
Facturation du calcul : toutes les requêtes que vous effectuez pendant la fenêtre de récupération PITR de sept jours, que ce soit par le biais de lectures non actualisées ou d'exportations, entraînent des coûts d'opération 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 coût de stockage PITR, même si vous désactivez la récupération PITR dans la journée suivant son activation.
Étape suivante
- Découvrez comment récupérer des données avec la récupération PITR.