Questa pagina fornisce informazioni su come creare backup dei database Spanner.
Per ulteriori informazioni sui backup, consulta la panoramica dei backup. Puoi eseguire il backup dei database nei seguenti modi:
- Utilizzo della console Google Cloud .
- Utilizzo di Google Cloud CLI.
- Utilizzo delle librerie client.
- Utilizzo delle API REST o RPC.
Prima di iniziare
-
Per ottenere le autorizzazioni necessarie per creare backup, chiedi all'amministratore di concederti i seguenti ruoli IAM sull'istanza:
-
Crea, visualizza, aggiorna ed elimina i backup:
Amministratore backup Cloud Spanner (
roles/spanner.backupAdmin
) -
Crea e visualizza i backup:
Cloud Spanner Backup Writer (
roles/spanner.backupWriter
)
-
Crea, visualizza, aggiorna ed elimina i backup:
Amministratore backup Cloud Spanner (
Gli esempi gcloud CLI in questa pagina si basano sulle seguenti ipotesi:
- Hai già configurato gcloud CLI per l'utilizzo con Spanner. Se non hai mai utilizzato gcloud CLI con Spanner, consulta Creare ed eseguire query su un database utilizzando gcloud CLI.
Hai configurato gcloud CLI con il tuo progetto. Ad esempio:
gcloud config set core/project PROJECT_ID
Crea backup
Quando crei un backup, Spanner crea una risorsa di backup e un'operazione di backup a lunga esecuzione per monitorare l'avanzamento del backup. Il backup appena creato si trova nella stessa istanza, regione e progetto del database di origine.
Quando crei un backup, devi specificare le seguenti informazioni:
- Un ID database di origine.
- Un nome per la risorsa di backup.
- Una data di scadenza (fino a un anno dalla data di creazione del backup).
Se vuoi, puoi specificare un
versionTime
per il database di origine,
che ti consente di eseguire il backup del database in un momento precedente.
Il campo versionTime
viene in genere utilizzato per sincronizzare i backup di più database o per recuperare i dati utilizzando il recupero point-in-time (PITR).
Se versionTime
non è specificato, viene impostato su createTime
del backup.
Puoi anche creare backup con una frequenza specifica utilizzando una pianificazione di backup. Per saperne di più, vedi Creare e gestire pianificazioni di backup.
Console
Nella console Google Cloud , vai alla pagina Istanze di Spanner.
Fai clic sull'istanza che contiene il database di cui vuoi eseguire il backup.
Fai clic sul database.
Nel riquadro di navigazione, fai clic su Backup/Restore.
Nella scheda Backup, fai clic su Crea backup.
Compila il modulo e fai clic su Crea.
Per controllare l'avanzamento di un'operazione di backup, vedi Controllare l'avanzamento dell'operazione.
gcloud
Prima di utilizzare i dati dei comandi riportati di seguito, apporta le seguenti sostituzioni:
- INSTANCE_ID: l'ID istanza Spanner.
- DATABASE_ID: l'ID database Spanner.
- BACKUP_NAME: il nome del backup Spanner.
-
RETENTION_PERIOD: il periodo di conservazione del backup creato. Ad esempio, se vuoi che la durata della conservazione sia di un giorno, puoi utilizzare
86400s
. -
ENCRYPTION_TYPE:
il tipo di crittografia del backup creato.
I valori validi sono
USE_CONFIG_DEFAULT_OR_BACKUP_ENCRYPTION
,GOOGLE_DEFAULT_ENCRYPTION
oCUSTOMER_MANAGED_ENCRYPTION
. Se utilizziCUSTOMER_MANAGED_ENCRYPTION
, devi specificare unkmsKeyName
.
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud spanner backups create BACKUP_NAME \ --instance=INSTANCE_ID \ --database=DATABASE_ID \ --retention-period=RETENTION_PERIOD \ --encryption-type=ENCRYPTION_TYPE \ --async
Windows (PowerShell)
gcloud spanner backups create BACKUP_NAME ` --instance=INSTANCE_ID ` --database=DATABASE_ID ` --retention-period=RETENTION_PERIOD ` --encryption-type=ENCRYPTION_TYPE ` --async
Windows (cmd.exe)
gcloud spanner backups create BACKUP_NAME ^ --instance=INSTANCE_ID ^ --database=DATABASE_ID ^ --retention-period=RETENTION_PERIOD ^ --encryption-type=ENCRYPTION_TYPE ^ --async
Dovresti ricevere una risposta simile alla seguente:
Create request issued for: BACKUP_NAME Check operation [projects/PROJECT_ID/instances/INSTANCE_ID/backups/BACKUP_NAME/operations/_auto_op_234567] for status.
Ecco alcune note sull'utilizzo:
- Per impostare la data di scadenza del backup, specifica il flag
--retention-period
o--expiration-date
. Per informazioni sulla sintassi della data, vedigcloud topic datetimes
. - Il nome del backup deve essere univoco nell'istanza.
- Il comando viene restituito immediatamente a causa del flag
--async
. Senza il flag, il comando attenderà il completamento dell'operazione di backup. - Specifica il flag
--help
per ricevere assistenza per qualsiasi comando.
Per controllare l'avanzamento di un'operazione di backup, vedi Controllare l'avanzamento dell'operazione.
Librerie client
Il seguente esempio di codice crea un backup in un version_time
specifico
e poi attende il completamento. Una volta completata, verifica che il backup sia pronto e recupera alcune informazioni, come nome, dimensioni e ora di creazione.
C++
C#
Go
Java
Node.js
PHP
Python
Ruby
Passaggi successivi
Per saperne di più sui backup, consulta Panoramica dei backup.
Per gestire i backup, consulta Gestire i backup.