Backup e ripristino dei dati

Backup e ripristino dei dati

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questa pagina descrive come utilizzare la funzionalità di backup pianificati di Firestore. Utilizza i backup per proteggere i dati da danni a livello di applicazione o dall'eliminazione accidentale dei dati.

I backup consentono di configurare pianificazioni dei backup in modo da eseguire backup giornalieri o settimanali del database specificato. Puoi quindi utilizzare questi backup per ripristinare i dati in un nuovo database.

Informazioni sui backup

Un backup è una copia coerente del database in un determinato momento. Il backup contiene tutte le configurazioni di dati e indici in quel momento. Un backup non contiene i criteri di durata del database. Un backup si trova nella stessa posizione del database di origine.

I backup hanno un periodo di conservazione configurabile e vengono archiviati fino alla scadenza del periodo di conservazione o fino a quando non elimini il backup. L'eliminazione del database di origine non elimina automaticamente i backup correlati.

Firestore archivia i metadati relativi ai backup e alle pianificazioni di backup relativi a un database. Firestore conserva questi metadati fino alla scadenza o all'eliminazione di tutti i backup per il database.

La creazione o la conservazione dei backup non influisce sulle prestazioni delle operazioni di lettura o scrittura nel database in tempo reale.

Costi

Quando utilizzi i backup, ti viene addebitato quanto segue:

• La quantità di spazio di archiviazione utilizzato da ogni backup.
• Per un'operazione di ripristino, l'addebito avviene in base alle dimensioni del backup.

Per ulteriori dettagli e le tariffe esatte, consulta la pagina Prezzi.

Prima di iniziare

Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i backup e le pianificazioni dei backup, chiedi all'amministratore di concederti uno o più dei seguenti ruoli di Identity and Access Management:

• roles/datastore.owner: accesso completo al database Firestore

• Anche i seguenti ruoli sono disponibili, ma non sono visibili nella console Google Cloud. Utilizza Google Cloud CLI per assegnare questi ruoli:

  • roles/datastore.backupsAdmin: accesso in lettura e scrittura ai backup
  • roles/datastore.backupsViewer: accesso in lettura ai backup
  • roles/datastore.backupSchedulesAdmin: accesso in lettura e scrittura alle pianificazioni dei backup
  • roles/datastore.backupSchedulesViewer: accesso in lettura alle pianificazioni dei backup
  • roles/datastore.restoreAdmin: autorizzazioni per avviare operazioni di ripristino

Crea e gestisci pianificazioni dei backup

Gli esempi riportati di seguito mostrano come configurare una pianificazione del backup. Per ogni database, puoi configurare fino a una pianificazione del backup giornaliera e fino a una pianificazione del backup settimanale. Non puoi configurare più pianificazioni di backup settimanali per giorni della settimana diversi.

Non puoi configurare l'ora esatta del backup. I backup vengono eseguiti in orari diversi ogni giorno. Per le pianificazioni dei backup settimanali, puoi configurare il giorno della settimana per eseguire il backup.

Crea una pianificazione del backup

Per creare una pianificazione del backup per un database, utilizza il comando gcloud alpha firestore backups schedules create.

Crea una pianificazione del backup giornaliero

Per creare una pianificazione del backup giornaliero, imposta il flag --recurrence su daily:

gcloud alpha firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

Sostituisci quanto segue:

• DATABASE_ID: l'ID del database di cui eseguire il backup. Imposta su (default) per il database predefinito.
• RETENTION_PERIOD: imposta questo valore su un valore massimo di 14 settimane (14w).

Crea una pianificazione del backup settimanale

Per creare una pianificazione del backup settimanale, imposta il flag --recurrence su weekly:

gcloud alpha firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=weekly \
--retention=RETENTION_PERIOD \
--day-of-week=DAY

Sostituisci quanto segue:

• DATABASE_ID: l'ID del database di cui eseguire il backup. Imposta su (default) per il database predefinito.
• RETENTION_PERIOD: imposta questo valore su un valore massimo di 14 settimane (14w).
• DAY: il giorno della settimana in cui eseguire il backup. Imposta uno dei seguenti valori:
  • SUN per domenica
  • MON per lunedì
  • TUE per martedì
  • WED per mercoledì
  • THU per giovedì
  • FRI per venerdì
  • SAT per sabato

Elenca pianificazioni dei backup

Per elencare tutte le pianificazioni dei backup per un database, utilizza il comando gcloud alpha firestore backups schedules list. Questo comando restituisce informazioni su tutte le pianificazioni dei backup.

gcloud alpha firestore backups schedules list \
--database='DATABASE_ID'

Sostituisci DATABASE_ID con l'ID del database. Utilizza (default) come database predefinito.

Descrivi la pianificazione del backup

Per recuperare informazioni su una pianificazione del backup, utilizza il comando gcloud alpha firestore backups schedules describe:

gcloud alpha firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

Sostituisci quanto segue:

• DATABASE_ID: l'ID del database di cui eseguire il backup. Imposta su (default) per il database predefinito.
• BACKUP_SCHEDULE_ID: l'ID di una pianificazione del backup. Puoi visualizzare l'ID di ogni pianificazione del backup quando elenchi tutte le pianificazioni dei backup.

Aggiorna una pianificazione del backup

Per aggiornare il periodo di conservazione di una pianificazione di backup, utilizza il comando gcloud alpha firestore backups schedules update:

gcloud alpha firestore backups schedules update \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID
--retention=RETENTION_PERIOD

Sostituisci quanto segue:

• DATABASE_ID: l'ID del database di cui eseguire il backup. Imposta su (default) per il database predefinito.
• BACKUP_SCHEDULE_ID: l'ID di una pianificazione del backup. Puoi visualizzare l'ID di ogni pianificazione del backup quando elenchi tutte le pianificazioni dei backup.
• RETENTION_PERIOD: imposta questo valore su un valore massimo di 14 settimane (14w).

Elimina una pianificazione del backup

Per eliminare una pianificazione del backup, utilizza il comando gcloud alpha firestore backups schedules delete:

gcloud alpha firestore backups schedules delete \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

Sostituisci quanto segue:

• DATABASE_ID: l'ID del database di cui eseguire il backup. Imposta su (default) per il database predefinito.
• BACKUP_SCHEDULE_ID: l'ID di una pianificazione del backup. Puoi visualizzare l'ID di ogni pianificazione del backup quando elenchi tutte le pianificazioni dei backup.

Tieni presente che l'eliminazione di una pianificazione del backup non comporterà l'eliminazione dei backup già creati da questa pianificazione. Puoi attendere che scadano dopo il periodo di conservazione oppure, per eliminare manualmente un backup, consulta Eliminare il backup.

Gestisci backup

Elenco dei backup

Per elencare i backup disponibili, utilizza il comando gcloud alpha firestore backups list:

gcloud alpha firestore backups list \
--format="table(name, database, state)"

Il flag --format="table(name, database, state)" formatta l'output in un formato più leggibile.

Per elencare solo i backup da una posizione specifica, utilizza il flag --location:

gcloud alpha firestore backups list \
--location=LOCATION \
--format="table(name, database, state)"

Sostituisci LOCATION con il nome di una località Firestore.

Descrivi un backup

Per visualizzare i dettagli su un backup, usa il comando gcloud alpha firestore backups describe:

gcloud alpha firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID

• LOCATION: la posizione del database.
• BACKUP_ID: l'ID di un backup. Puoi visualizzare l'ID di ogni backup quando elenchi tutti i backup.

Elimina backup

Per eliminare un backup, utilizza il comando gcloud alpha firestore backups delete:

Avviso: non puoi recuperare un backup eliminato.

gcloud alpha firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID

• LOCATION: la posizione del database.
• BACKUP_ID: l'ID di un backup. Puoi visualizzare l'ID di ogni backup quando elenchi tutti i backup.

Nota: Firestore archivia i metadati relativi ai backup e alle pianificazioni di backup relativi a un database. Firestore conserva questi metadati fino alla scadenza o all'eliminazione di tutti i backup per il database.

Ripristina dati da un backup del database

Un'operazione di ripristino scrive i dati da un backup in un nuovo database Firestore. Per avviare un'operazione di ripristino, utilizza il comando gcloud alpha firestore databases restore:

gcloud alpha firestore databases restore \
--source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
--destination-database='DATABASE_ID'

• PROJECT_ID: l'ID del tuo progetto.
• LOCATION: la posizione del backup del database e quella del nuovo database creato per i dati ripristinati.
• BACKUP_ID: l'ID di un backup. Puoi visualizzare l'ID di ogni backup quando elenchi tutti i backup.
• DATABASE_ID: un ID database per il nuovo database. Non puoi utilizzare un ID database già in uso. La modalità del database corrisponderà a quella del backup.

L'output includerà i componenti metadata, name e response:

metadata:
  '@type': type.googleapis.com/google.firestore.admin.v1.RestoreDatabaseMetadata
  backup: projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID
  database: projects/PROJECT_ID/databases/DATABASE_ID
  operationState: PROCESSING
  progressPercentage:
    completedWork: '20'
    estimatedWork: '100'
  startTime: '2023-12-06T14:20:17.398325Z'
name: projects/PROJECT_ID/databases/DATABASE_ID/operations/operation_uuid
response:
  '@type': type.googleapis.com/google.firestore.admin.v1.Database
  createTime: '2023-12-06T14:20:17.398325Z'
  name: projects/PROJECT_ID/databases/DATABASE_ID
  ...

Il campo metadata include un componente progressPercentage, che indica in dettaglio l'avanzamento stimato del ripristino fino a questo momento, e un operationState che specifica lo stato generale del ripristino.

Per recuperare queste informazioni, utilizza gcloud firestore operations list:

gcloud firestore operations list --database=DATABASE_ID

oppure, utilizzando il campo name dell'output descritto sopra, con gcloud firestore operations describe:

gcloud firestore operations describe OPERATION_NAME