Sauvegarder et restaurer des données

Cette page explique comment utiliser la fonctionnalité de sauvegardes planifiées Firestore. Utilisez des sauvegardes pour protéger vos données contre la corruption au niveau de l'application ou la suppression accidentelle.

Les sauvegardes vous permettent de configurer des calendriers de sauvegarde pour effectuer des sauvegardes quotidiennes ou hebdomadaires de la base de données spécifiée. Vous pouvez ensuite utiliser ces sauvegardes pour restaurer les données dans une nouvelle base de données.

À propos des sauvegardes

Une sauvegarde est une copie cohérente de la base de données à un moment donné. La sauvegarde contient toutes les données et configurations d'index à ce moment-là. Une sauvegarde ne contient pas les règles de durée de vie de la base de données. Une sauvegarde se trouve au même emplacement que la base de données source.

Les sauvegardes ont une période de conservation configurable et sont stockées jusqu'à son expiration ou jusqu'à ce que vous les supprimiez. La suppression de la base de données source ne supprime pas automatiquement les sauvegardes associées.

Firestore stocke les métadonnées liées aux sauvegardes et aux planifications de sauvegardes associées à une base de données. Firestore conserve ces métadonnées jusqu'à ce que toutes les sauvegardes de la base de données expirent ou soient supprimées.

La création ou la conservation de sauvegardes n'a aucune incidence sur les performances des lectures ou des écritures dans votre base de données active.

Coûts

Lorsque vous utilisez des sauvegardes, les éléments suivants vous sont facturés:

• Espace de stockage utilisé par chaque sauvegarde.
• Pour une opération de restauration, vous êtes facturé en fonction de la taille de la sauvegarde.

Pour en savoir plus et connaître les tarifs exacts, consultez la page Tarifs.

Avant de commencer

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les sauvegardes et les planifications de sauvegarde, demandez à votre administrateur de vous accorder l'un ou plusieurs des rôles de Identity and Access Management suivants:

• roles/datastore.owner: accès complet à la base de données Firestore

• Les rôles suivants sont également disponibles, mais ne sont pas visibles dans la console Google Cloud. Utilisez la Google Cloud CLI pour attribuer ces rôles:

  • roles/datastore.backupsAdmin: Accès en lecture et en écriture aux sauvegardes
  • roles/datastore.backupsViewer: Accès en lecture aux sauvegardes
  • roles/datastore.backupSchedulesAdmin: Accès en lecture et en écriture aux planifications de sauvegarde
  • roles/datastore.backupSchedulesViewer: Accès en lecture aux planifications de sauvegarde
  • roles/datastore.restoreAdmin: autorisations pour lancer des opérations de restauration

Créer et gérer des planifications de sauvegarde

Les exemples ci-dessous montrent comment configurer un calendrier de sauvegarde. Pour chaque base de données, vous pouvez configurer jusqu'à une planification de sauvegarde quotidienne et une planification de sauvegarde hebdomadaire. Vous ne pouvez pas configurer plusieurs planifications de sauvegarde hebdomadaires pour différents jours de la semaine.

Vous ne pouvez pas configurer l'heure exacte de la sauvegarde. Les sauvegardes sont effectuées à des heures différentes chaque jour. Pour les planifications de sauvegarde hebdomadaires, vous pouvez configurer le jour de la semaine où la sauvegarde sera effectuée.

Créer une programmation de sauvegarde

Pour créer une planification de sauvegarde pour une base de données, utilisez la commande gcloud firestore backups schedules create ou la commande firebase firestore:databases:backups:schedules.

Créer une programmation de sauvegarde quotidienne

gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'DAILY' \
--retention RETENTION_PERIOD

resource "google_firestore_backup_schedule" "daily-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  daily_recurrence {}
}

Créer une programmation de sauvegarde hebdomadaire

gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=weekly \
--retention=RETENTION_PERIOD \
--day-of-week=DAY

firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'WEEKLY' \
--retention RETENTION_PERIOD
--day-of-week DAY

resource "google_firestore_backup_schedule" "weekly-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  weekly_recurrence {
    day = DAY
  }
}

Répertorier les planifications de sauvegarde

Pour répertorier tous les calendriers de sauvegarde d'une base de données, utilisez l'une des méthodes suivantes:

gcloud firestore backups schedules list \
--database='DATABASE_ID'

firebase firestore:backups:schedules:list \
--database 'DATABASE_ID'

Décrire la planification des sauvegardes

Pour récupérer des informations sur une planification de sauvegarde, utilisez l'une des méthodes suivantes:

gcloud firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

Modifier un planning de sauvegarde

Pour mettre à jour la durée de conservation d'un calendrier de sauvegarde, utilisez l'une des méthodes suivantes:

gcloud firestore backups schedules update \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID \
--retention=RETENTION_PERIOD

firebase firestore:backups:schedules:update \
BACKUP_SCHEDULE \
--retention RETENTION_PERIOD

Vous pouvez modifier la période de conservation d'une planification de sauvegarde, mais pas sa récurrence. Si vous avez besoin d'une planification de sauvegarde avec une autre fréquence, supprimez l'ancienne planification de sauvegarde si elle n'est plus nécessaire, puis créez-en une nouvelle avec la fréquence souhaitée.

Supprimer une planification de sauvegarde

Pour supprimer une planification de sauvegarde, utilisez l'une des méthodes suivantes:

gcloud firestore backups schedules delete \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

firebase firestore:backups:schedules:delete \
BACKUP_SCHEDULE

Notez que la suppression d'une planification de sauvegarde ne supprime pas les sauvegardes déjà créées par cette planification. Vous pouvez attendre qu'elles expirent à la fin de leur période de conservation ou supprimer manuellement une sauvegarde. Pour ce faire, consultez Supprimer une sauvegarde.

Gérer les sauvegardes

Répertorier des sauvegardes

Pour lister les sauvegardes disponibles, utilisez l'une des méthodes suivantes:

gcloud firestore backups list \
--format="table(name, database, state)"

gcloud firestore backups list \
--location=LOCATION \
--format="table(name, database, state)"

firebase firestore:backups:list

firebase firestore:backups:list \
--location=LOCATION

Décrire une sauvegarde

Pour afficher les détails d'une sauvegarde, utilisez l'une des méthodes suivantes:

gcloud firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID

firebase firestore:backups:get BACKUP

Supprimer une sauvegarde

gcloud firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID

firebase firestore:backups:delete \
BACKUP

Restaurer des données à partir d'une sauvegarde de base de données

Une opération de restauration écrit les données d'une sauvegarde dans une nouvelle base de données Firestore.

Pour lancer une opération de restauration, utilisez l'une des méthodes suivantes:

gcloud firestore databases restore \
--source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
--destination-database='DATABASE_ID'

metadata:
  '@type': type.googleapis.com/google.firestore.admin.v1.RestoreDatabaseMetadata
  backup: projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID
  database: projects/PROJECT_ID/databases/DATABASE_ID
  operationState: PROCESSING
  progressPercentage:
    completedWork: '20'
    estimatedWork: '100'
  startTime: '2023-12-06T14:20:17.398325Z'
name: projects/PROJECT_ID/databases/DATABASE_ID/operations/operation_uuid
response:
  '@type': type.googleapis.com/google.firestore.admin.v1.Database
  createTime: '2023-12-06T14:20:17.398325Z'
  name: projects/PROJECT_ID/databases/DATABASE_ID
  ...

gcloud firestore operations list --database=DATABASE_ID

gcloud firestore operations describe OPERATION_NAME

firebase firestore:databases:restore \
--backup 'BACKUP' \
--database 'DATABASE_ID'