Ripristinare un backup di Spanner Omni

Puoi ripristinare un backup di un database Spanner Omni in un nuovo database. Il database ripristinato contiene tutti i dati e le informazioni sullo schema del database originale al momento del backup, inclusi tutti i parametri del database impostati con il comando ALTER DATABASE SET OPTIONS.versionTime

I seguenti elementi non sono inclusi in un database ripristinato:

  • Autorizzazioni IAM. Devi applicare le autorizzazioni IAM appropriate al termine del ripristino.

  • Dati interni di tutti i flussi di modifiche in tempo reale.

  • Durata (TTL) definita da una politica di cancellazione delle righe. Devi riconfigurare queste policy al termine del ripristino.

  • Punti di divisione creati durante la pre-divisione di un database.

Come funziona il ripristino

Quando ripristini un database Spanner Omni, devi specificare un backup di origine e un nuovo database di destinazione. Non puoi eseguire il ripristino in un database esistente.

La procedura di ripristino offre alta affidabilità. Puoi ripristinare il database a condizione che sia disponibile la maggior parte delle regioni e delle zone nella destinazione.

Stati di ripristino

Un database ripristinato passa attraverso tre stati, monitorati da due operazioni a lunga esecuzione.

Stato Descrizione
CREATING Spanner Omni inizia il ripristino creando un nuovo database e montando i file dal backup. Quando si trova in questo stato, il database ripristinato non è ancora pronto per l'uso. Una volta completata, la tua base di dati è pronta per l'uso.

Nota:Spanner Omni non consente di eliminare il backup durante il ripristino. Puoi eliminarlo al termine del ripristino e quando il database entra nello stato READY.
READY_OPTIMIZING Dopo aver montato il backup, Spanner Omni inizia a copiare i dati nel nuovo database ottimizzando le dimensioni archiviate. Il database è pronto per l'uso durante questa procedura.

Avvertenze:
  • Le latenze di lettura potrebbero essere leggermente superiori al solito.
  • Le metriche di archiviazione mostrano le dimensioni del nuovo database, non del backup. I risultati potrebbero non riflettere le dimensioni totali di tutti i tuoi dati durante il trasferimento.
  • Non puoi eliminare il backup montato durante questo stato.
READY Una volta completata l'operazione di copia e ottimizzazione, il database passa allo stato READY. Il database è stato completamente ripristinato e non richiede più il backup.

Per monitorare l'avanzamento durante lo stato CREATING, puoi eseguire query sull'operazione di ripristino a lunga esecuzione, che restituisce un oggetto RestoreDatabaseMetadata. Durante lo stato READY_OPTIMIZING, l'operazione restituisce un oggetto OptimizeRestoredDatabaseMetadata.

Controllo degli accessi (IAM)

I seguenti ruoli forniscono le autorizzazioni necessarie per le operazioni di ripristino di Spanner Omni:

Ruolo IAM Autorizzazioni
roles/spanner.restoreAdmin Autorizzazione al ripristino da un backup.
roles/spanner.admin Accesso completo alle operazioni di ripristino e a tutte le altre risorse Spanner Omni.
owner Accesso completo alle operazioni di ripristino.
editor Accesso completo alle operazioni di ripristino.
viewer Autorizzazione per visualizzare le operazioni di ripristino. Non è possibile creare, aggiornare, eliminare o copiare un backup.

Ripristinare un database da un backup

Per ripristinare un database, utilizza il comando spanner databases restore:

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