Questa pagina è stata tradotta dall'API Cloud Translation.

Gestisci backup

Questa pagina descrive come eseguire le operazioni di backup di Bigtable. Prima di leggere questa pagina, dovresti acquisire familiarità con i backup.

Puoi lavorare con i backup Bigtable utilizzando quanto segue:

La console Google Cloud .
Google Cloud CLI.
Le librerie client di Cloud Bigtable.

Prima di iniziare

Assicurati che tu o l'account utente che utilizzi disponiate delle autorizzazioni richieste per l'azione che devi eseguire.

Se prevedi di utilizzare gcloud CLI, installa gcloud CLI per Bigtable.

Utilizzare il backup automatico

Puoi utilizzare gcloud CLI o la console Google Cloud per attivare il backup automatico. Il backup automatico crea un backup giornaliero della tabella con un periodo di conservazione predefinito di sette giorni. Per modificare il periodo di conservazione nella policy di backup automatico di una tabella, vedi Aggiornare una policy di backup automatico.

I passaggi per eliminare, aggiornare, copiare e ripristinare un backup sono gli stessi indipendentemente dal fatto che il backup sia creato manualmente o come risultato di un backup automatico.

Puoi estendere la data di scadenza di un backup o di una copia di backup. Per ulteriori informazioni, vedi Modificare un backup o una copia di backup.

Se prevedi di attivare il backup automatico, tieni in considerazione i seguenti fattori:

Se un cluster viene aggiunto a un'istanza che contiene una tabella con il backup automatico abilitato, i backup giornalieri non vengono creati nel cluster aggiunto. Per creare backup giornalieri su tutti i cluster, incluso quello appena aggiunto, disattiva il backup automatico per la tabella e poi riattivalo.
Se una tabella con il backup automatico abilitato viene eliminata e successivamente recuperata, devi riattivare il backup automatico sulla tabella recuperata.
Il ripristino di un backup automatico di una tabella non abilita automaticamente il backup automatico sulla tabella ripristinata. Devi attivare manualmente il backup automatico.

Abilita backup automatico

Puoi attivare il backup automatico utilizzando la console o Google Cloud CLI. Quando il backup automatico è abilitato, Bigtable crea un backup standard della tabella ogni giorno su ogni cluster nell'istanza. Non puoi utilizzare il backup automatico per creare backup a caldo.

Ai backup creati nell'ambito del backup automatico vengono assegnati ID che iniziano con auto. Ad esempio, una tabella con ID my-table avrebbe un ID backup automatico come auto.my-table.c7x3.20230220-145537, dove my-table è l'ID tabella troncato, c7x3 è l'ID hash univoco e 20230220-145537 è la data e l'ora in formato UTC.

Per creare una nuova tabella con il backup automatico abilitato, consulta Creare e gestire tabelle.

Console

Apri l'elenco delle istanze Bigtable nella console Google Cloud .

Apri l'elenco delle istanze
Fai clic sull'istanza con la tabella di cui vuoi eseguire il backup.
Fai clic su Tabelle nel riquadro a sinistra.

La pagina Tabelle mostra un elenco di tabelle nell'istanza.
Nella colonna Backup automatico della tabella, fai clic su Attiva. Potrebbe essere necessaria fino a un'ora prima che Bigtable inizi a creare i backup.

gcloud

Per abilitare il backup automatico per una tabella, esegui il comando gcloud bigtable tables update. Per saperne di più sull'attivazione del backup automatico durante la creazione di una tabella, vedi Creare una tabella.

Dopo l'abilitazione del criterio di backup automatico per una tabella, l'applicazione della configurazione aggiornata potrebbe richiedere fino a un'ora.

gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--enable-automated-backup

Sostituisci quanto segue:

TABLE_ID: l'ID della tabella di cui eseguire il backup.
INSTANCE_ID: L'identificatore permanente per l'istanza.

(Facoltativo) Per abilitare il backup automatico di una tabella e impostare un periodo di conservazione diverso da quello predefinito di sette giorni, utilizza il flag --automated-backup-retention-period anziché il flag --enable-automated-backup:

gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--automated-backup-retention-period=RETENTION_PERIOD

Sostituisci RETENTION_PERIOD con un valore compreso tra 3 e 90 giorni, espresso come numero con un'unità di m, h o d (minuti, ore o giorni), ad esempio 15d per 15 giorni.

Disattivare il backup automatico

Dopo la disattivazione del criterio di backup automatico per una tabella, l'applicazione della configurazione aggiornata potrebbe richiedere fino a un'ora. I backup creati prima della modifica delle norme vengono conservati fino alla scadenza, a meno che non li elimini.

Console

Apri l'elenco delle istanze Bigtable nella console Google Cloud .

Apri l'elenco delle istanze
Fai clic sull'istanza che contiene la tabella per cui vuoi disattivare il backup automatico.
Fai clic su Tables.

La pagina Tabelle mostra un elenco di tabelle nell'istanza.
Nella riga della tabella per cui vuoi disattivare il backup automatico, fai clic su Modifica.
Deseleziona la casella di controllo Abilita backup automatico.
Fai clic su Salva.

gcloud

Per disattivare il backup automatico per una tabella, esegui il comando gcloud bigtable instances tables update.

gcloud bigtable instances tables update TABLE_ID \
--instance=INSTANCE_ID \
--disable-automated-backup

Sostituisci quanto segue:

TABLE_ID: l'ID della tabella.
INSTANCE_ID: L'identificatore permanente per l'istanza.

Visualizza la policy di backup automatico

Per visualizzare la policy di backup automatico per una tabella, esegui il comando gcloud bigtable instances tables describe.

gcloud bigtable instances tables describe TABLE_ID \
--instance=INSTANCE_ID

Sostituisci quanto segue:

TABLE_ID: l'ID della tabella.
INSTANCE_ID: L'identificatore permanente per l'istanza.

L'output è simile al seguente:

automatedBackupPolicy:
  retentionPeriod: 3d
  frequency: 24h
columnFamilies:
  my-family: {}
createTime: '2023-02-07T20:10:55.613546Z'
granularity: MILLIS
name: projects/my-project/instances/my-instance/tables/my-table
updateTime: '2023-02-07T20:10:55.613546Z'

Tieni presente quanto segue:

Il campo automatedBackupPolicy non è presente quando il backup automatico non è abilitato per una tabella.
retentionPeriod indica il periodo di conservazione dei backup creati automaticamente. Puoi modificare il periodo di conservazione di un backup fino a 90 giorni dalla data di creazione del backup. Per aggiornare il periodo di conservazione del backup, vedi Modificare un backup o una copia di backup.

Aggiorna una policy di backup automatico

Le modifiche a una policy di backup automatico vengono applicate ai backup creati dopo la modifica.

Console

Apri l'elenco delle istanze Bigtable nella console Google Cloud .

Apri l'elenco delle istanze
Fai clic sull'istanza che contiene la tabella di cui vuoi aggiornare il criterio di backup automatico.
Fai clic su Tables.

La pagina Tabelle mostra un elenco di tabelle nell'istanza.
Nella riga della tabella per cui vuoi configurare il criterio di backup automatico, fai clic su Modifica. Viene visualizzato il riquadro delle proprietà della tabella.
In Configura backup automatico, nel campo Periodo di conservazione, inserisci un numero intero compreso tra 3 e 90 per specificare il numero di giorni in cui Bigtable deve conservare i backup dopo il salvataggio della modifica.
Fai clic su Salva.

gcloud

Per modificare la policy di backup automatico di una tabella, utilizza il comando gcloud bigtable tables update con il flag --automated-backup-retention-period.

gcloud bigtable tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --automated-backup-retention-period=retention-period=RETENTION_PERIOD

Sostituisci quanto segue:

TABLE_ID: l'ID della tabella con backup automatico.
INSTANCE_ID: L'identificatore permanente per l'istanza.
RETENTION_PERIOD: un periodo di massimo 90 giorni, espresso come numero con un'unità di m, h o d (minuti, ore o giorni).

Esempi: 72h o 89d

Visualizzare i log eventi

Quando il backup automatico è abilitato, Bigtable genera log degli eventi di sistema quando viene creato un backup. Inoltre, emette un log eventi se la creazione del backup viene ritardata.

Per visualizzare i log degli eventi di sistema di backup automatico nella pagina di panoramica del cluster Bigtable nella console, procedi nel seguente modo:

Apri l'elenco delle istanze Bigtable nella console Google Cloud .

Apri l'elenco delle istanze
Fai clic sull'ID istanza.
Fai clic sull'ID cluster.

Se i log degli eventi di backup automatico sono stati creati nell'ultima ora, vengono visualizzati nel riquadro Log.
(Facoltativo) Per visualizzare i log degli eventi meno recenti, fai clic sulla freccia accanto a 1 ora e seleziona un altro intervallo di tempo.

Per visualizzare i log eventi del sistema di backup automatico in Esplora log:

Vai a Esplora log:

Vai a Esplora log

Seleziona il progetto Google Cloud appropriato.

Per visualizzare gli eventi di creazione del backup, inserisci quanto segue nel campo Query:

resource.type="audited_resource" resource.labels.service="bigtableadmin.googleapis.com"
resource.labels.method="CreateAutomatedBackup"

Fai clic su Esegui query.

Per visualizzare gli eventi di ritardo del backup, inserisci quanto segue nel campo Query:

resource.type="audited_resource" resource.labels.service="bigtableadmin.googleapis.com"
resource.labels.method="DelayedAutomatedBackup"

Fai clic su Esegui query.

Il risultato della query include un messaggio simile al seguente:
```
Automated backup is delayed for table ab-test on cluster my-cluster-staging-c1.
```

Crea un backup standard

Puoi creare un backup standard di una tabella utilizzando Google Cloud CLI, la console o una delle librerie client Bigtable. Puoi anche abilitare il backup automatico per consentire a Bigtable di creare un backup standard giornaliero.

Console

Vai alla pagina Istanze di Bigtable nella consoleGoogle Cloud .

Apri l'elenco delle istanze
Fai clic sull'istanza che contiene la tabella di cui vuoi eseguire il backup.
Nel riquadro di navigazione a sinistra, fai clic su Tabelle.
Fai clic su Crea backup per la tabella di cui vuoi eseguire il backup.
Se utilizzi la replica, utilizza il menu a discesa per scegliere l'ID cluster per il cluster che deve archiviare il backup. Se hai fatto clic su Crea backup accanto a un ID cluster anziché a un ID istanza nella pagina Tabelle, il cluster è preselezionato.
Inserisci un ID univoco per il backup.
Imposta una data di scadenza.
Fai clic su Crea.

La console mostra la pagina Backup filtrata per mostrare il backup e i relativi dettagli.
Fai clic su Attività per visualizzare lo stato del backup.

La colonna Stato mostra Backup completato al termine del backup.

gcloud

Per tutti i comandi, sostituisci i valori effettivi con i seguenti:

INSTANCE_ID: L'identificatore permanente per l'istanza.
CLUSTER_ID: L'identificatore permanente del cluster.
TABLE_ID: l'ID della tabella di cui eseguire il backup.
BACKUP_ID: l'ID che assegni al backup.
EXPIRATION_DATE: una data futura di 90 giorni o meno, formattata come timestamp UTC "Zulu", preciso al nanosecondo.

Esempio: 2022-10-02T15:01:23.045123456Z
RETENTION_PERIOD: un periodo di massimo 90 giorni, espresso come numero con un'unità di m, h o d (minuti, ore o giorni).

Esempi: 36h o 89d

Se non conosci l'ID istanza, utilizza il comando bigtable instances list per visualizzare un elenco delle istanze del tuo progetto:
```
gcloud bigtable instances list
```
Visualizza l'elenco dei backup per l'istanza che contiene la tabella di cui vuoi eseguire il backup, in modo da poter scegliere un ID backup non ancora in uso nel cluster di destinazione.
```
gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID
```
Visualizza l'elenco delle tabelle per confermare l'ID della tabella di cui vuoi eseguire il backup.
```
gcloud bigtable instances tables list --instances=INSTANCE_ID
```
Esegui il comando gcloud bigtable instances backups create per creare un backup dalla tabella, fornendo una data di scadenza o un periodo di conservazione fino a 90 giorni.
```
gcloud bigtable backups create BACKUP_ID --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID \
  --table=TABLE_ID \
  --async \
  --expiration-date=EXPIRATION_DATE \
  --retention-period=RETENTION_PERIOD
```
Il flag --async è facoltativo. Utilizzalo se vuoi che il terminale restituisca l'ID operazione prima che l'operazione sia completata. Questa opzione è utile se vuoi controllare lo stato dell'operazione.

Visualizza l'elenco dei backup per verificare se il backup è stato creato.

gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID

Se il backup non è elencato, controlla lo stato dell'operazione.

Lo stato Ready indica che il backup è stato completato.

Crea un hot backup

gcloud

Per tutti i comandi, sostituisci i valori effettivi con i seguenti:

INSTANCE_ID: L'identificatore permanente per l'istanza.
CLUSTER_ID: L'identificatore permanente del cluster.
TABLE_ID: l'ID della tabella di cui eseguire il backup.
BACKUP_ID: l'ID che assegni al backup.
EXPIRATION_DATE: una data futura di 90 giorni o meno, formattata come timestamp UTC "Zulu", preciso al nanosecondo.

Esempio: 2022-10-02T15:01:23.045123456Z
RETENTION_PERIOD: un periodo di massimo 90 giorni, espresso come numero con un'unità di m, h o d (minuti, ore o giorni).

Esempi: 36h o 89d
(Facoltativo) HOT_TO_STANDARD_TIME: la data e l'ora in cui Bigtable deve convertire il backup da un backup caldo a un backup standard. Questo valore deve essere almeno 24 ore dopo l'ora di creazione del backup.

Esempio: 2024-08-02T15:01:23.045123456Z

In alternativa, puoi fornire una data e un'ora di durata relativa. Per saperne di più, consulta gcloud topic datetimes.

Esempio: +P30D per 30 giorni

Se non conosci l'ID istanza, utilizza il comando bigtable instances list per visualizzare un elenco delle istanze del tuo progetto:
```
gcloud bigtable instances list
```
Visualizza l'elenco dei backup per l'istanza che contiene la tabella di cui vuoi eseguire il backup, in modo da poter scegliere un ID backup non ancora in uso nel cluster di destinazione.
```
gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID
```
Visualizza l'elenco delle tabelle per confermare l'ID della tabella di cui vuoi eseguire il backup.
```
gcloud bigtable instances tables list --instances=INSTANCE_ID
```
Esegui il comando gcloud bigtable instances backups create per creare un backup a caldo della tabella, fornendo una data di scadenza o un periodo di conservazione fino a 90 giorni.
```
gcloud bigtable backups create BACKUP_ID --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID \
  --table=TABLE_ID \
  --async \
  --expiration-date=EXPIRATION_DATE \
  --retention-period=RETENTION_PERIOD \
  --backup-type=HOT \
  --hot-to-standard-time=HOT_TO_STANDARD_TIME
```
Il flag --async è facoltativo. Utilizzalo se vuoi che il terminale restituisca l'ID operazione prima che l'operazione sia completata. Questa opzione è utile se vuoi controllare lo stato dell'operazione.

Visualizza l'elenco dei backup per verificare se il backup è stato creato.

gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID

Se il backup non è elencato, controlla lo stato dell'operazione.

Lo stato Ready indica che il backup è stato completato.

Ripristina da un backup

Una nuova tabella ripristinata da un backup non ha il backup automatico abilitato anche se la tabella di origine lo aveva. Se vuoi il backup automatico nella nuova tabella, devi abilitarlo.

I passaggi per il ripristino da un backup sono gli stessi indipendentemente dal fatto che il backup sia standard o hot. Bigtable ripristina un hot backup alle prestazioni di produzione più rapidamente di un backup standard.

Console

Non puoi eseguire il ripristino in un altro progetto utilizzando la console Google Cloud . Se devi farlo, utilizza invece gcloud CLI.

Vai alla pagina Istanze di Bigtable nella consoleGoogle Cloud .

Apri l'elenco delle istanze
Fai clic sull'istanza che contiene il backup che vuoi ripristinare.
Nel riquadro di navigazione a sinistra, fai clic su Backup.
Fai clic su Ripristina per il backup che vuoi ripristinare.
Seleziona l'istanza in cui vuoi eseguire il ripristino.

Le istanze che non dispongono di spazio di archiviazione sufficiente per la nuova tabella non sono disponibili. Se non disponi dell'autorizzazione per creare una tabella in un'istanza, l'istanza non è disponibile. Passa il mouse sopra l'icona per ulteriori informazioni.

Se esegui il ripristino da un backup protetto da CMEK, anche l'istanza di destinazione deve essere protetta da CMEK.

Non puoi eseguire il ripristino in un progetto diverso utilizzando la consoleGoogle Cloud . Se necessario, utilizza invece gcloud CLI.
Inserisci un ID univoco per la tabella che verrà creata dal backup. Non potrai modificare questo ID in un secondo momento.
Fai clic su Ripristina.

La console mostra la pagina Tabelle filtrata per mostrare la nuova tabella.

La console mostra lo stato del ripristino per ogni cluster. Quando la colonna stato per tutti i cluster mostra Pronto, la tabella è stata ripristinata e replicata in tutti i cluster dell'istanza.

gcloud

Per tutti i comandi, sostituisci i valori effettivi con i seguenti:

PROJECT_ID_SOURCE: l'ID del progetto contenente il backup da cui eseguire il ripristino.
INSTANCE_ID_SOURCE: l'ID permanente dell'istanza di origine.
PROJECT_ID_DESTINATION: l'ID del progetto in cui vuoi eseguire il ripristino. Questo flag è facoltativo. Se non specifichi questa opzione, il backup viene ripristinato in una nuova tabella nella stessa istanza in cui è stato creato.
INSTANCE_ID_DESTINATION: l'ID permanente dell'istanza di destinazione.
CLUSTER_ID: L'identificatore permanente del cluster.
BACKUP_ID: l'ID del backup da cui vuoi eseguire il ripristino.
TABLE_ID_NEW: l'ID della nuova tabella.

Se non conosci l'ID istanza, utilizza il comando bigtable instances list per visualizzare un elenco delle istanze del tuo progetto:
```
gcloud bigtable instances list
```
Visualizza l'elenco dei backup per l'istanza che contiene il backup per verificare che esista.
```
gcloud bigtable backups list --instance=INSTANCE_ID_SOURCE \
  --cluster=CLUSTER_ID_SOURCE
```
Visualizza l'elenco delle tabelle nell'istanza di destinazione, in modo da poter scegliere un ID per la nuova tabella che non sia già in uso.
```
gcloud bigtable instances tables list --instances=INSTANCE_ID_DESTINATION
```
Esegui il comando gcloud bigtable instances tables restore per eseguire il ripristino dal backup in una nuova tabella.
```
gcloud bigtable instances tables restore \
--source=projects/PROJECT_ID_SOURCE/instances/INSTANCE_ID_SOURCE/clusters/CLUSTER_ID/backups/BACKUP_ID \
--async \
--destination=TABLE_ID_NEW \
--destination-instance=INSTANCE_ID_DESTINATION \
--project=PROJECT_ID_DESTINATION
```
Il flag --async è facoltativo. Utilizzalo se vuoi che il terminale restituisca l'ID operazione prima del completamento dell'operazione. Questa opzione è utile se vuoi controllare lo stato dell'operazione.

Visualizza l'elenco delle tabelle per verificare se la tua è stata creata.

gcloud bigtable instances tables list --instances=INSTANCE_ID_DESTINATION

Se il backup non è elencato, controlla lo stato dell'operazione.

Crea una copia di un backup

Console

Non puoi creare una copia di un backup in un altro progetto utilizzando la console. Se devi farlo, utilizza gcloud CLI.

Vai alla pagina Istanze di Bigtable nella consoleGoogle Cloud .

Apri l'elenco delle istanze
Fai clic sull'istanza che contiene il backup che vuoi copiare.
Nel riquadro di navigazione a sinistra, fai clic su Backup.
Per il backup che vuoi copiare, espandi il menu Altro accanto alla parola Ripristina e poi fai clic su Copia.
Fai clic su Copia per il backup di cui vuoi creare una copia.

Se il backup è una copia di un altro backup, l'opzione Copia non è disponibile.
Seleziona l'istanza di destinazione.

Non puoi creare una copia di un backup in un progetto diverso utilizzando la console. Se devi farlo, utilizza gcloud CLI.

Le istanze che non dispongono di spazio di archiviazione sufficiente per la copia di backup non sono disponibili. Se non disponi dell'autorizzazione per creare un backup in un'istanza, l'istanza non è disponibile. Tieni premuto il puntatore sopra l'icona per ulteriori informazioni.

Se copi un backup protetto da CMEK, anche l'istanza di destinazione deve essere protetta da CMEK.
Seleziona il cluster di destinazione.

Come qualsiasi backup, una copia di backup viene archiviata in un solo cluster di un'istanza, anche se questa utilizza la replica.
Inserisci un ID univoco per la copia che verrà creata dal backup. Non potrai modificare questo ID in un secondo momento.
Imposta un tempo di scadenza per la copia di backup, fornendo un valore per Tempo e selezionando un'Unità dal menu a discesa.
Fai clic su Copia.
Per visualizzare la copia, fai clic su Visualizza copia.

La console mostra la pagina Backup dell'istanza di destinazione, filtrata per la copia di backup appena creata. Quando la colonna dello stato mostra Pronto, la copia è completa e pronta per ulteriori operazioni.

gcloud

Per tutti i comandi, sostituisci i valori effettivi con i seguenti:

PROJECT_ID_SOURCE: il progetto contenente il backup da copiare.
INSTANCE_ID_SOURCE: l'ID permanente dell'istanza di origine.
CLUSTER_ID_SOURCE: l'ID del cluster in cui è archiviato il backup di origine.
BACKUP_ID_SOURCE: l'ID del backup da copiare.
PROJECT_ID_DESTINATION: Il progetto in cui vuoi inserire la copia.
INSTANCE_ID_DESTINATION: l'ID permanente dell'istanza di destinazione.
CLUSTER_ID_DESTINATION: L'ID del cluster nell'istanza di destinazione in cui vuoi archiviare la copia.
BACKUP_ID_DESTINATION: l'ID che assegni alla copia del backup.
RETENTION_PERIOD: il tempo di permanenza della copia di backup, espresso come numero e unità (d o h). Ad esempio, 5d per cinque giorni o 15h per 15 ore. Utilizza questa opzione o una data di scadenza.
EXPIRATION_DATE: la data e l'ora in cui la copia di backup deve scadere, formattate come 2022-09-01T10:00:00.0Z.

Se non conosci l'ID istanza, utilizza il comando bigtable instances list per visualizzare un elenco delle istanze del tuo progetto:
```
gcloud bigtable instances list
```
Visualizza l'elenco dei backup per l'istanza di origine che contiene il backup per verificare che il backup che vuoi copiare esista.
```
gcloud bigtable backups list --instance=INSTANCE_ID_SOURCE \
--cluster=CLUSTER_ID_SOURCE
```
Visualizza l'elenco dei backup nell'istanza di destinazione, in modo da poter scegliere un ID per la copia che non è già in uso.
```
gcloud bigtable backups list --instances=DESTINATION_INSTANCE
```
Esegui il comando gcloud bigtable instances backups copy per creare la copia di backup.
```
gcloud bigtable backups copy \
  --source-project=PROJECT_ID_SOURCE \
  --source-instance=INSTANCE_ID_SOURCE \
  --source-cluster=CLUSTER_ID_SOURCE \
  --source-backup=BACKUP_ID_SOURCE \
  --destination-project=PROJECT_ID_DESTINATION \
  --destination-instance=INSTANCE_ID_DESTINATION \
  --destination-cluster=CLUSTER_ID_DESTINATION \
  --destination-backup=BACKUP_ID_DESTINATION \
```
Aggiungi al comando uno dei seguenti elementi:
- --retention-period`=RETENTION_PERIOD: periodo di conservazione della copia di backup. Deve essere almeno 6 ore e al massimo 30 giorni dopo la creazione del backup di origine.
- --expiration-date`=EXPIRATION_DATE: scadenza della copia di backup. Deve essere almeno 6 ore e al massimo 30 giorni dopo la creazione del backup di origine.
Se vuoi, puoi aggiungere --async al comando. Utilizzalo se vuoi che il terminale restituisca l'ID operazione prima che l'operazione sia completata. Questa opzione è utile se vuoi controllare lo stato dell'operazione.

Se viene restituito un messaggio di timeout, il backup potrebbe essere riuscito e la copia potrebbe essere stata creata.
Visualizza l'elenco dei backup per verificare se la copia è stata creata.
```
gcloud bigtable backups list --instances=INSTANCE_ID_DESTINATION
```
Se il backup non è elencato, controlla lo stato dell'operazione.

Nel raro caso in cui un'operazione di copia di backup non vada a buon fine a causa di limitazioni di capacità, riprova con un cluster di destinazione diverso. Se anche questa operazione non va a buon fine, contatta l'assistenza.

Controllare lo stato di un'operazione

Console

Vai alla pagina Istanze di Bigtable nella consoleGoogle Cloud .

Apri l'elenco delle istanze
Fai clic sull'istanza che contiene il backup.
Nel riquadro di navigazione a sinistra, fai clic su Backup.
Nella pagina Backup, fai clic su Attività. La colonna Stato mostra lo stato attuale di ogni operazione.

Gli stati dell'operazione durante il ripristino di una tabella includono quanto segue:

Copia in attesa
Ripristino backup in corso
Inizializzazione
Pronta per l'ottimizzazione
Pronto

Gli stati dell'operazione durante la creazione di un backup includono quanto segue:

Creazione del backup in corso
Backup completato

Gli stati dell'operazione durante la copia di un backup includono:

Copia del backup in corso
Backup copiato

gcloud

Per controllare lo stato di un'operazione di backup o ripristino, devi disporre dell'ID univoco dell'operazione. Di seguito è riportato un esempio di ID operazione:

`instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635`

Dopo aver eseguito un comando per creare un backup o ripristinare una nuova tabella utilizzando l'opzione --async, il terminale visualizza l'ID operazione.

Copia l'ID operazione.
Esegui il comando gcloud bigtable operations describe, sostituendo il valore che hai copiato con OPERATION_ID.
```
gcloud bigtable operations describe OPERATION_ID
```
Esempio:
```
gcloud bigtable operations describe \
instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635
```
Puoi eseguire questo comando a intervalli regolari di alcuni secondi fino a quando il valore di DONE non è TRUE.

Se non conosci l'ID operazione, perché non hai appena eseguito il comando o ti trovi in una finestra del terminale diversa, puoi visualizzare un elenco di operazioni per l'istanza e determinare quale operazione vuoi controllare.

Visualizza un elenco delle attività recenti dell'istanza che contiene la tabella di cui stai eseguendo il backup o il ripristino, sostituendo l'ID dell'istanza con INSTANCE_ID:
```
gcloud bigtable operations list --instance=INSTANCE_ID
```
Il terminale mostra un elenco di operazioni nelle colonne etichettate NAME, START_TIME, END_TIME e DONE. Il valore nella colonna NAME è l'ID operazione.
A partire dal primo elemento dell'elenco, copia l'ID operazione.

Utilizza gcloud bigtable operations describe per visualizzare i metadati dell'operazione.

gcloud bigtable operations describe OPERATION_ID

Esempio:

gcloud bigtable operations describe \
instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635

Se i metadati di un'operazione mostrano un valore per backupInfo, hai trovato l'operazione corretta e puoi ripetere questo comando di tanto in tanto finché il valore di DONE non è TRUE.

Se i metadati non mostrano un valore per backupInfo, controlla l'operazione successiva nell'elenco delle operazioni visualizzate nel passaggio 1.

Modificare un backup o una copia di backup

Console

La console Google Cloud non consente di modificare un backup, incluse le copie.

gcloud

gcloud CLI consente di modificare la data o il periodo di scadenza di un backup o di una copia di backup. Puoi anche convertire un backup a caldo in un backup standard.

Per tutti i comandi, sostituisci i valori effettivi con i seguenti:

INSTANCE_ID: L'identificatore permanente per l'istanza.
CLUSTER_ID: L'identificatore permanente del cluster.
BACKUP_ID: l'ID univoco di un backup.
EXPIRATION_DATE: una data futura di 90 giorni o meno, formattata come timestamp UTC "Zulu", preciso al nanosecondo.

Esempio: 2019-10-02T15:01:23.045123456Z
RETENTION_PERIOD: un periodo massimo di 90 giorni per i backup o massimo 30 giorni per le copie di backup, espresso come numero con un'unità di m, h o d (minuti, ore o giorni).

Esempi: 36h o 89d
(Facoltativo) HOT_TO_STANDARD_TIME: la data e l'ora in cui Bigtable deve convertire il backup da un backup caldo a un backup standard. Questo valore deve essere almeno 24 ore dopo l'ora di creazione del backup.

Esempio: 2024-08-02T15:01:23.045123456Z

In alternativa, puoi fornire una data e un'ora di durata relativa. Per saperne di più, consulta gcloud topic datetimes.

Esempio: +P30D per 30 giorni

Visualizza un elenco di backup:
```
    gcloud bigtable backups list --instance=INSTANCE_ID
```
Il terminale mostra un elenco di backup.
Prendi nota degli ID backup e cluster per il backup che devi aggiornare.

Esegui il comando gcloud bigtable instances backups update per aggiungere una nuova data di scadenza o un nuovo periodo di conservazione o per convertire un backup caldo in un backup standard.

  gcloud bigtable backups update BACKUP_ID \
  --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID \
  --expiration-date=EXPIRATION_DATE \
  --retention-period=RETENTION_PERIOD
  --hot-to-standard-time=HOT_TO_STANDARD_TIME

Esegui il comando gcloud bigtable instances backups describe per verificare di aver aggiornato correttamente la scadenza.
```
    gcloud bigtable backups describe BACKUP_ID \
    --instance=INSTANCE_ID \
    --cluster=CLUSTER_ID
```

Eliminare un backup

Se vuoi eliminare un backup dopo averne creato una copia, controlla lo stato per verificare che l'operazione di copia sia stata completata.

Console

Vai alla pagina Istanze di Bigtable nella consoleGoogle Cloud .

Apri l'elenco delle istanze
Fai clic sull'istanza che contiene il backup.
Nel riquadro di navigazione a sinistra, fai clic su Backup.
Per il backup da eliminare, espandi il menu Altro accanto alla parola Ripristina, quindi fai clic su Elimina.
Inserisci l'ID backup nel campo Conferma eliminazione, quindi fai clic su Elimina.

gcloud

Visualizza un elenco di backup sostituendo l'ID dell'istanza con INSTANCE_ID:
```
gcloud bigtable backups list --instance=INSTANCE_ID
```
Il terminale mostra un elenco di backup.
Prendi nota dell'ID backup e dell'ID del cluster in cui è archiviato.
Esegui il comando gcloud bigtable instances backups delete, sostituendo l'ID backup che hai annotato con BACKUP_ID e l'ID cluster con CLUSTER_ID.
```
gcloud bigtable backups delete BACKUP_ID \
  --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID
```

Passaggi successivi

Scopri di più sui backup.
Scopri come importare ed esportare i dati Bigtable.
Consulta la sezione Bigtable di Progettazione del ripristino di emergenza per interruzioni dell'infrastruttura cloud.