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 au moment (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 ligne. Vous devez reconfigurer ces règles une fois la restauration terminée.

  • Points de division que vous créez lors de la prédivision d'une base de données.

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 effectuer de restauration vers une base de données existante.

Le processus de restauration offre 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 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 installant 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 sa restauration. Vous pouvez le supprimer une fois la restauration terminée et lorsque la base de données passe à l'état READY.
READY_OPTIMIZING Après avoir installé la sauvegarde, Spanner Omni commence à copier les données dans la nouvelle base de données tout en optimisant sa taille de stockage. Votre base de données est prête à être utilisée pendant ce processus.

Points à noter :
  • 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 pendant le transfert.
  • Vous ne pouvez pas supprimer la sauvegarde installé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 ne nécessite plus 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. Impossible de créer, de mettre à jour, de supprimer ou de 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

Étapes suivantes