Backup e ripristino dei dati

Backup e ripristino dei dati

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

I backup ti consentono di configurare pianificazioni per 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 determinato momento. Un backup non contiene i criteri TTL 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 li elimini. L'eliminazione del database di origine non comporta l'eliminazione automatica dei backup correlati.

Firestore archivia i metadati relativi ai backup e alle pianificazioni dei backup relativi a un database. Firestore conserva questi metadati fino a quando tutti i backup del database non scadono o vengono eliminati.

La creazione o il mantenimento dei backup non influisce sul rendimento delle letture o delle scritture nel database in produzione.

Costi

Quando utilizzi i backup, ti viene addebitato quanto segue:

• La quantità di spazio di archiviazione utilizzata da ogni backup.
• Per un'operazione di ripristino, ti verranno addebitati costi in base alle dimensioni del backup.

Per ulteriori dettagli e 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 è attivata in un progetto.

Ruoli obbligatori

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

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

• Sono disponibili anche i seguenti ruoli, che però 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 le operazioni di ripristino

Creare e gestire le pianificazioni dei backup

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

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

Crea una pianificazione dei backup

Per creare una pianificazione del backup per un database, utilizza il comando gcloud firestore backups schedules create o il comando firebase firestore:databases:backups:schedules.

Creare una pianificazione del backup giornaliera

gcloud

Per creare una pianificazione dei backup giornalieri, imposta il flag --recurrence su daily:

gcloud 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 un valore fino a 14 settimane (14w).

interfaccia a riga di comando di Firebase

Per creare una pianificazione dei backup giornalieri, imposta il flag --recurrence su DAILY:

firebase 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 un valore fino a 14 settimane (14w).

Terraform

Per creare una pianificazione dei backup giornalieri, crea una risorsa google_firestore_backup_schedule.

resource "google_firestore_backup_schedule" "daily-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  daily_recurrence {}
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto.
• DATABASE_ID: l'ID del database di cui eseguire il backup. Imposta su '(default)' per il database predefinito.
Puoi anche utilizzare un riferimento alla risorsa a una risorsa Terraform di tipo google_firestore_database.
• RETENTION_PERIOD_SECONDS: imposta un valore in secondi, seguito da "s". Il valore massimo è 8467200s (14 settimane).

Creare una pianificazione del backup settimanale

gcloud

Per creare una pianificazione dei backup settimanali, imposta il flag --recurrence su weekly:

gcloud 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 un valore fino a 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

interfaccia a riga di comando di Firebase

Per creare una pianificazione dei backup settimanali, imposta il flag --recurrence su WEEKLY:

firebase 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 un valore fino a 14 settimane (14w).
• DAY: il giorno della settimana in cui eseguire il backup. Imposta uno dei seguenti valori:
  • SUNDAY per domenica
  • MONDAY per lunedì
  • TUESDAY per martedì
  • WEDNESDAY per mercoledì
  • THURSDAY per giovedì
  • FRIDAY per venerdì
  • SATURDAY per sabato

Terraform

Per creare una pianificazione dei backup settimanali, crea una risorsa google_firestore_backup_schedule.

resource "google_firestore_backup_schedule" "weekly-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  weekly_recurrence {
    day = DAY
  }
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto.
• DATABASE_ID: l'ID del database di cui eseguire il backup. Imposta su '(default)' per il database predefinito.
Puoi anche utilizzare un riferimento alla risorsa a una risorsa Terraform di tipo google_firestore_database.
• RETENTION_PERIOD_SECONDS: imposta un valore in secondi, seguito da "s". Il valore massimo è 8467200s (14 settimane).
• DAY: il giorno della settimana in cui eseguire il backup. Imposta uno dei seguenti valori:
  • SUNDAY per domenica
  • MONDAY per lunedì
  • TUESDAY per martedì
  • WEDNESDAY per mercoledì
  • THURSDAY per giovedì
  • FRIDAY per venerdì
  • SATURDAY per sabato

Elenco delle pianificazioni di backup

Per elencare tutte le pianificazioni dei backup per un database, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud firestore backups schedules list.

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

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

interfaccia a riga di comando di Firebase

Utilizza il comando firebase firestore:backups:schedules:list.

firebase firestore:backups:schedules:list \
--database 'DATABASE_ID'

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

Descrivi la pianificazione del backup

Per recuperare informazioni su una pianificazione dei backup, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud firestore backups schedules describe:

gcloud 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 dei backup. Puoi visualizzare l'ID di ogni pianificazione dei backup quando elenchi tutte le pianificazioni dei backup.

Aggiornare una pianificazione del backup

Per aggiornare il periodo di conservazione di una pianificazione dei backup, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud firestore backups schedules update:

gcloud 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 dei backup. Puoi visualizzare l'ID di ogni pianificazione dei backup quando elenchi tutte le pianificazioni dei backup.
• RETENTION_PERIOD: imposta un valore fino a 14 settimane (14w).

interfaccia a riga di comando di Firebase

Utilizza il comando firebase firestore:backups:schedules:update:

firebase firestore:backups:schedules:update \
BACKUP_SCHEDULE \
--retention RETENTION_PERIOD

Sostituisci quanto segue:

• BACKUP_SCHEDULE: il nome completo della risorsa di una pianificazione di backup. Puoi visualizzare il nome di ogni pianificazione di backup quando elenchi tutte le pianificazioni di backup.
• RETENTION_PERIOD: imposta un valore fino a 14 settimane (14w).

Puoi aggiornare il periodo di conservazione di una pianificazione del backup, ma non la sua ricorrenza. Se hai bisogno di una pianificazione del backup con una ricorrenza diversa, elimina la vecchia pianificazione se non è più necessaria e crea una nuova pianificazione con la ricorrenza desiderata.

Eliminare una pianificazione del backup

Per eliminare una pianificazione dei backup, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud firestore backups schedules delete:

gcloud 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 dei backup. Puoi visualizzare l'ID di ogni pianificazione dei backup quando elenchi tutte le pianificazioni dei backup.

interfaccia a riga di comando di Firebase

Utilizza il comando firebase firestore:backups:schedules:delete:

firebase firestore:backups:schedules:delete \
BACKUP_SCHEDULE

Sostituisci quanto segue:

• BACKUP_SCHEDULE: il nome completo della risorsa di una pianificazione di backup. Puoi visualizzare il nome di ogni pianificazione di backup quando elenchi tutte le pianificazioni di backup.

Tieni presente che l'eliminazione di una pianificazione del backup non comporta l'eliminazione dei backup già creati da questa pianificazione. Puoi attendere che scadano al termine del periodo di conservazione oppure eliminare manualmente un backup. Per informazioni su come eliminare un backup, consulta Eliminare un backup.

Gestisci backup

Elenco dei backup

Per elencare i backup disponibili, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud firestore backups list:

gcloud 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 di una posizione specifica, utilizza il flag --location:

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

Sostituisci LOCATION con il nome di una località Firestore.

interfaccia a riga di comando di Firebase

Utilizza il comando firebase firestore:backups:list:

firebase firestore:backups:list

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

firebase firestore:backups:list \
--location=LOCATION

Sostituisci LOCATION con il nome di una località Firestore.

Descrivere un backup

Per visualizzare i dettagli di un backup, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud firestore backups describe:

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

Sostituisci quanto segue:

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

interfaccia a riga di comando di Firebase

Utilizza il comando firebase firestore:backups:get:

firebase firestore:backups:get BACKUP

Sostituisci quanto segue:

• BACKUP: il nome completo della risorsa di un backup. Puoi visualizzare il nome di ogni backup quando elenchi tutti i backup.

Elimina backup

Per eliminare un backup, utilizza uno dei seguenti metodi. Attenzione: non puoi recuperare un backup eliminato.

gcloud

Utilizza il comando gcloud firestore backups delete:

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

Sostituisci quanto segue:

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

interfaccia a riga di comando di Firebase

Utilizza il comando firebase firestore:backups:delete:

firebase firestore:backups:delete \
BACKUP

Sostituisci quanto segue:

• BACKUP: il nome completo della risorsa di un backup. Puoi visualizzare il nome di ogni backup quando elenchi tutti i backup.

Nota: Firestore archivia i metadati relativi ai backup e alle pianificazioni dei backup di un database. Firestore conserva questi metadati fino a quando tutti i backup del database non scadono o vengono eliminati.

Ripristinare i dati da un backup del database

Un'operazione di ripristino scrive i dati di un backup in un nuovo database Firestore.

Per avviare un'operazione di ripristino, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud firestore databases restore:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto.
• LOCATION: la posizione del backup del database e la posizione 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 descrive dettagliatamente l'avanzamento stimato del ripristino fino a quel momento e un operationState che specifica lo stato complessivo del ripristino. Per recuperare di nuovo queste informazioni, utilizza gcloud firestore operations list:

gcloud firestore operations list --database=DATABASE_ID

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

gcloud firestore operations describe OPERATION_NAME

interfaccia a riga di comando di Firebase

Utilizza il comando firebase firestore:databases:restore:

firebase firestore:databases:restore \
--backup 'BACKUP' \
--database 'DATABASE_ID'

Sostituisci quanto segue:

• BACKUP: il nome completo della risorsa di un backup. Puoi visualizzare il nome 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.