Restaurer une sauvegarde Spanner Omni

Vous pouvez restaurer une sauvegarde d'une base de données Spanner Omni dans une nouvelle base de données. La base de données restaurée contient toutes les données et informations de schéma de la base de données d'origine à l'instant versionTime de la sauvegarde, y compris toutes les options de base de données que vous avez définies avec la commande ALTER DATABASE SET OPTIONS.

Les éléments suivants ne sont pas inclus dans une base de données restaurée :

  • Autorisations IAM Vous devez appliquer les autorisations IAM appropriées une fois la restauration terminée.

  • Données internes de tous les flux de modifications.

  • Valeur TTL (Time To Live) définie par une règle de suppression de lignes. Vous devrez reconfigurer ces règles une fois la restauration terminée.

  • Points de fractionnement que vous créez lorsque vous fractionnez une base de données au préalable.

Fonctionnement de la restauration

Lorsque vous restaurez une base de données Spanner Omni, vous devez spécifier une sauvegarde source et une nouvelle base de données cible. Vous ne pouvez pas restaurer une sauvegarde vers une base de données existante.

Le processus de restauration assure une haute disponibilité. Vous pouvez restaurer la base de données à condition que le quorum majoritaire des régions et des zones de la cible soit disponible.

États de la restauration

Une base de données restaurée passe par trois états, suivis par deux opérations de longue durée.

État Description
CREATING Spanner Omni commence la restauration en créant une base de données et en montant les fichiers de la sauvegarde. Dans cet état, la base de données restaurée n'est pas encore prête à être utilisée. Une fois l'opération terminée, votre base de données est prête à être utilisée.

Remarque : Spanner Omni ne vous permet pas de supprimer la sauvegarde pendant la restauration. Vous pouvez le supprimer une fois la restauration terminée et la base de données passée à l'état READY.
READY_OPTIMIZING Une fois la sauvegarde montée, Spanner Omni commence à copier les données dans la nouvelle base de données tout en optimisant leur taille de stockage. Votre base de données est prête à l'emploi pendant ce processus.

Mises en garde :
  • Les latences de lecture peuvent être légèrement plus élevées que d'habitude.
  • Les métriques de stockage affichent la taille de la nouvelle base de données, et non celle de la sauvegarde. Il est possible que les résultats ne reflètent pas la taille totale de toutes vos données lors du transfert.
  • Vous ne pouvez pas supprimer la sauvegarde associée pendant cet état.
READY Une fois l'opération de copie et d'optimisation terminée, la base de données passe à l'état READY. La base de données est entièrement restaurée et n'a plus besoin de la sauvegarde.

Pour suivre la progression pendant l'état CREATING, vous pouvez interroger l'opération de restauration de longue durée, qui renvoie un objet RestoreDatabaseMetadata. Pendant l'état READY_OPTIMIZING, l'opération renvoie un objet OptimizeRestoredDatabaseMetadata.

Contrôle des accès (IAM)

Les rôles suivants fournissent les autorisations requises pour les opérations de restauration Spanner Omni :

Rôle IAM Autorisations
roles/spanner.restoreAdmin Autorisation de restaurer à partir d'une sauvegarde.
roles/spanner.admin Accès complet aux opérations de restauration et à toutes les autres ressources Spanner Omni.
owner Accès complet aux opérations de restauration.
editor Accès complet aux opérations de restauration.
viewer Autorisation d'afficher les opérations de restauration. Ne peut pas créer, mettre à jour, supprimer ni copier une sauvegarde.

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

Pour restaurer une base de données, utilisez la commande spanner databases restore :

spanner databases restore \
  --destination-database=RESTORE_DATABASE_NAME \
  --source-backup=BACKUP_NAME \
  --async