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 di versionTime del backup, incluse tutte le opzioni del database impostate con il comando ALTER DATABASE SET OPTIONS.

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 eventuali flussi di modifiche in tempo reale.

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

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

La versione di anteprima di Spanner Omni non supporta backup o ripristini. Per ottenere le funzionalità che consentono di creare backup e ripristinare da backup, contatta Google per richiedere l'accesso anticipato alla versione completa di Spanner Omni.

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 del quorum delle regioni e delle zone di 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. In questo stato, il database ripristinato non è ancora pronto per l'uso. Al termine, il database è pronto 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 ottimizzandone le dimensioni di archiviazione. 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 dati durante il trasferimento.
  • Non puoi eliminare il backup montato in questo stato.
READY Al termine dell'operazione di copia e ottimizzazione, il database passa allo stato READY. Il database è stato ripristinato completamente e non richiede più il backup.

Per monitorare l'avanzamento durante lo stato CREATING, puoi eseguire una 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 per il 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