Sauvegarder et restaurer des données

Sauvegarder et restaurer des données

Cette page explique comment utiliser les 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 de données.

Les sauvegardes vous permettent de configurer des calendriers de sauvegarde quotidiens ou hebdomadaires de la base de données spécifiée. Vous pouvez ensuite utiliser ces sauvegardes pour restaurer des 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 précis. La sauvegarde contient toutes les configurations d'index et de données à ce stade à temps. Une sauvegarde ne contient pas de règles relatives à la 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 et non supprimer 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'affecte pas les performances des lectures ou 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

Vérifiez que la facturation est activée pour votre projet Google Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.

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 gestion de l'authentification et des accès 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: permet de 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 moments différents 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 un planning de sauvegarde pour une base de données, utilisez la gcloud firestore backups schedules create ou firebase firestore:databases:backups:schedules.

Créer une programmation de sauvegarde quotidienne

gcloud

Pour créer une planification de sauvegarde quotidienne, définissez l'indicateur --recurrence sur daily :

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

Remplacez les éléments suivants :

• DATABASE_ID: ID de la base de données à sauvegarder. Définir sur '(default)' pour la base de données par défaut.
• RETENTION_PERIOD : définissez cette valeur sur une valeur maximale de 14 semaines (14w).

CLI Firebase

Pour créer une planification de sauvegarde quotidienne, définissez l'indicateur --recurrence sur DAILY :

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

Remplacez les éléments suivants :

• DATABASE_ID: ID de la base de données à sauvegarder. Définir sur '(default)' pour la base de données par défaut.
• RETENTION_PERIOD: définissez cette valeur sur une valeur maximale de 14 semaines (14w).

Terraform

Pour créer une planification de sauvegarde quotidienne, créez une ressource google_firestore_backup_schedule.

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

  retention = RETENTION_PERIOD_SECONDS

  daily_recurrence {}
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet
• DATABASE_ID: ID de la base de données à sauvegarder. Définir sur '(default)' pour la base de données par défaut.
Vous pouvez également utiliser une référence de ressource Ressource Terraform de type google_firestore_database.
• RETENTION_PERIOD_SECONDS: définissez cette valeur sur une valeur en secondes, suivie de "s". La valeur maximale est 8467200s (14 semaines).

Créer une programmation de sauvegarde hebdomadaire

gcloud

Pour créer un planning de sauvegarde hebdomadaire, définissez l'indicateur --recurrence sur weekly:

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

Remplacez les éléments suivants:

• DATABASE_ID : ID de la base de données à sauvegarder. Définissez cette valeur sur '(default)' pour la base de données par défaut.
• RETENTION_PERIOD : définissez cette valeur sur une valeur maximale de 14 semaines (14w).
• DAY : jour de la semaine où la sauvegarde doit être effectuée. Définissez cette option sur l'une des valeurs suivantes :
  • SUN pour dimanche
  • MON pour lundi
  • TUE pour mardi
  • WED pour mercredi
  • THU pour jeudi
  • FRI pour vendredi
  • SAT pour samedi

CLI Firebase

Pour créer un planning de sauvegarde hebdomadaire, définissez l'indicateur --recurrence sur WEEKLY:

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

Remplacez les éléments suivants :

• DATABASE_ID: ID de la base de données à sauvegarder. Définissez cette valeur sur '(default)' pour la base de données par défaut.
• RETENTION_PERIOD: définissez cette valeur sur une valeur maximale de 14 semaines (14w).
• DAY : jour de la semaine où la sauvegarde doit être effectuée. Définissez cette option sur l'une des valeurs suivantes :
  • SUNDAY pour dimanche
  • MONDAY pour lundi
  • TUESDAY pour mardi
  • WEDNESDAY pour mercredi
  • THURSDAY pour jeudi
  • FRIDAY pour vendredi
  • SATURDAY pour samedi

Terraform

Pour définir un calendrier de sauvegarde hebdomadaire, créez une ressource google_firestore_backup_schedule.

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

  retention = RETENTION_PERIOD_SECONDS

  weekly_recurrence {
    day = DAY
  }
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet
• DATABASE_ID : ID de la base de données à sauvegarder. Définir sur '(default)' pour la base de données par défaut.
Vous pouvez également utiliser une référence de ressource Ressource Terraform de type google_firestore_database.
• RETENTION_PERIOD_SECONDS: définissez cette valeur sur une valeur en secondes, suivie de "s". La valeur maximale est de 8467200s (14 semaines).
• DAY: jour de la semaine où effectuer la sauvegarde. Définissez cette option sur l'une des valeurs suivantes :
  • SUNDAY pour dimanche
  • MONDAY pour lundi
  • TUESDAY pour mardi
  • WEDNESDAY pour mercredi
  • THURSDAY pour jeudi
  • FRIDAY pour vendredi
  • SATURDAY pour samedi

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

Exécutez la commande gcloud firestore backups schedules list.

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

Remplacez DATABASE_ID par l'ID de la base de données. Utilisez '(default)' pour la base de données par défaut.

CLI Firebase

Exécutez la commande firebase firestore:backups:schedules:list.

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

Remplacez DATABASE_ID par l'ID de la base de données. Utilisez '(default)' pour la base de données par défaut.

Décrire le calendrier de sauvegarde

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

gcloud

Utilisez les Commande gcloud firestore backups schedules describe:

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

Remplacez les éléments suivants :

• DATABASE_ID: ID de la base de données à sauvegarder. Définir sur '(default)' pour la base de données par défaut.
• BACKUP_SCHEDULE_ID : ID d'une planification de sauvegarde. Toi vous pouvez voir l'ID de chaque planification de sauvegarde répertorier tous les plannings de sauvegarde ;

Mettre à jour 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

Exécutez la commande gcloud firestore backups schedules update :

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

Remplacez les éléments suivants:

• DATABASE_ID : ID de la base de données à sauvegarder. Définir sur '(default)' pour la base de données par défaut.
• BACKUP_SCHEDULE_ID : ID d'une planification de sauvegarde. Vous pouvez afficher l'ID de chaque planification de sauvegarde lorsque vous listez toutes les planifications de sauvegarde.
• RETENTION_PERIOD: définissez cette valeur sur une valeur maximale de 14 semaines (14w).

CLI Firebase

Exécutez la commande firebase firestore:backups:schedules:update :

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

Remplacez les éléments suivants :

• BACKUP_SCHEDULE : nom complet de la ressource d'un calendrier de sauvegarde. Toi vous pouvez voir le nom de chaque planification de sauvegarde répertorier tous les plannings de sauvegarde ;
• RETENTION_PERIOD: définissez cette valeur sur une valeur maximale de 14 semaines (14w).

Vous pouvez modifier la durée de conservation d'un calendrier de sauvegarde, mais vous ne pouvez pas modifier 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 un planning de sauvegarde

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

gcloud

Exécutez la commande gcloud firestore backups schedules delete :

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

Remplacez les éléments suivants:

• DATABASE_ID : ID de la base de données à sauvegarder. Définissez cette valeur sur '(default)' pour la base de données par défaut.
• BACKUP_SCHEDULE_ID: ID d'un planning de sauvegarde. Vous pouvez afficher l'ID de chaque planification de sauvegarde lorsque vous listez toutes les planifications de sauvegarde.

CLI Firebase

Exécutez la commande firebase firestore:backups:schedules:delete :

firebase firestore:backups:schedules:delete \
BACKUP_SCHEDULE

Remplacez les éléments suivants:

• BACKUP_SCHEDULE : nom complet de la ressource d'un calendrier de sauvegarde. Toi vous pouvez voir le nom de chaque planification de sauvegarde répertorier tous les plannings de sauvegarde ;

Notez que la suppression d'un planning de sauvegarde ne supprime pas les sauvegardes déjà créées par ce calendrier. 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 répertorier les sauvegardes disponibles, utilisez l'une des méthodes suivantes:

gcloud

Exécutez la commande gcloud firestore backups list :

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

L'option --format="table(name, database, state)" formate la sortie dans un plus lisible. Pour répertorier uniquement les sauvegardes d'un emplacement spécifique, utilisez l'option --location :

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

Remplacez LOCATION par le nom d'un objet Firestore. l'emplacement.

CLI Firebase

Exécutez la commande firebase firestore:backups:list :

firebase firestore:backups:list

Pour ne répertorier que les sauvegardes d'un emplacement spécifique, utilisez l'option --location:

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

Remplacez LOCATION par le nom d'un objet Firestore. l'emplacement.

Décrire une sauvegarde

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

gcloud

Exécutez la commande gcloud firestore backups describe :

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

Remplacez les éléments suivants:

• LOCATION : emplacement de la base de données.
• BACKUP_ID : ID d'une sauvegarde. Toi Vous pouvez afficher l'ID de chaque sauvegarde lorsque vous répertoriez toutes les sauvegardes.

CLI Firebase

Exécutez la commande firebase firestore:backups:get :

firebase firestore:backups:get BACKUP

Remplacez les éléments suivants :

• BACKUP: nom complet de la ressource d'une sauvegarde. Vous pouvez voir le nom de chaque sauvegarde en répertoriant toutes les sauvegardes.

Supprimer une sauvegarde

Pour supprimer une sauvegarde, utilisez l'une des méthodes suivantes. Avertissement : Vous ne pouvez pas récupérer une sauvegarde supprimée.

gcloud

Exécutez la commande gcloud firestore backups delete :

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

Remplacez les éléments suivants :

• LOCATION : emplacement de la base de données.
• BACKUP_ID : ID d'une sauvegarde. Vous pouvez afficher l'ID de chaque sauvegarde lorsque vous listez toutes les sauvegardes.

CLI Firebase

Exécutez la commande firebase firestore:backups:delete :

firebase firestore:backups:delete \
BACKUP

Remplacez les éléments suivants:

• BACKUP : nom complet de la ressource d'une sauvegarde. Vous pouvez afficher le nom de chaque sauvegarde lorsque vous listez toutes les sauvegardes.

Remarque :Firestore stocke les métadonnées liées aux sauvegardes et aux sauvegardes. des calendriers liés à 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.

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

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

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

gcloud

Exécutez la commande gcloud firestore databases restore :

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

Remplacez les éléments suivants:

• PROJECT_ID : ID de votre projet
• LOCATION: emplacement de la sauvegarde de la base de données et emplacement de la nouvelle base de données créée pour les données restaurées.
• BACKUP_ID: ID d'une sauvegarde. Vous pouvez afficher l'ID de chaque sauvegarde en répertoriant toutes les sauvegardes.
• DATABASE_ID : ID de base de données pour la nouvelle base de données. Vous ne pouvez pas utiliser un ID de base de données déjà utilisé.

Le mode de la base de données correspond à celui de la sauvegarde. La sortie inclura les composants metadata, name et response:

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
  ...

Le champ metadata inclut un composant progressPercentage, qui détaille la progression estimée de la restauration jusqu'à présent, et un operationState spécifiant l'état global de la restauration. Pour récupérer à nouveau ces informations, utilisez gcloud firestore operations list :

gcloud firestore operations list --database=DATABASE_ID

ou, à l'aide du champ name de la sortie décrite ci-dessus, avec gcloud firestore operations describe :

gcloud firestore operations describe OPERATION_NAME

CLI Firebase

Exécutez la commande firebase firestore:databases:restore :

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

Remplacez les éléments suivants:

• BACKUP: nom complet de la ressource d'une sauvegarde. Vous pouvez voir le nom de chaque sauvegarde en répertoriant toutes les sauvegardes.
• DATABASE_ID : ID de base de données pour la nouvelle base de données. Vous ne pouvez pas utiliser un ID de base de données déjà utilisé.

Le mode de base de données correspond à celui de la sauvegarde.