Esegui un'operazione di ripristino in loco

Questa pagina descrive come ripristinare i dati di un backup in un database con lo stesso nome del database di origine del backup. Prima di leggere questa pagina, dovresti conoscere Effettuare il backup e il ripristino dei dati.

Ripristino in loco

Un ripristino in loco consente di ripristinare un database da un backup di origine che ha creato il backup mentre il database originale esiste già. Un ripristino in situ ti consente di evitare di reindirizzare il traffico o di creare un database con un nome diverso.

Un'operazione di ripristino deve utilizzare un database di destinazione non esiste già. Tuttavia, puoi simulare un ripristino in loco eliminando il database di origine e quindi ripristinando da un backup a un nuovo database con dello stesso nome del database di origine.

Eseguire un ripristino in situ

Per eseguire un ripristino in situ:

  1. Identifica il backup da utilizzare per l'operazione di ripristino.
  2. Elimina il database esistente.
  3. Utilizza il backup e l'ID del database eliminato per completare l'operazione di ripristino.

Prima di iniziare

Ti consigliamo di completare i seguenti passaggi prima di iniziare il ripristino in loco process:

  1. Esporta i dati nel database che vuoi eliminare.

    Se devi recuperare il database eliminato, import i dati dall'operazione di esportazione. Per ripristinare il database eliminato allo stesso ID database, devi attendere fino a quando tutte le operazioni di ripristino in esecuzione vengono completate e quindi:

    1. Elimina il database esistente con l'ID database e attendi almeno 5 minuti
    2. Crea un nuovo database con l'ID database
    3. Avviare un'operazione di importazione

  2. Recupera e copia la configurazione dell'indice del database. Le operazioni di esportazione non acquisiscono le definizioni degli indici. Utilizza la configurazione dell'indice per ricreare indici dopo aver completato l'operazione di ripristino in loco. Usa i seguenti comandi per recuperare la configurazione dell'indice del tuo database:

    • Utilizza gcloud firestore indexes composite list per recuperare un elenco di indici composti:

      gcloud firestore indexes composite list --database=DATABASE_ID

      Sostituisci DATABASE_ID con l'ID del tuo database.

    • Utilizza gcloud firestore indexes fields list per recuperare un elenco di esenzioni degli indici a campo singolo (integrato).

      gcloud firestore indexes fields list --database=DATABASE_ID

Eseguire un ripristino in situ

Completa i seguenti passaggi per eseguire un'operazione di ripristino in loco. Questa procedura richiede un tempo di riposo tra il momento in cui elimini il database e il completamento dell'operazione di ripristino.

Una volta avviata un'operazione di ripristino, non puoi annullarla e devi attendere fino al completamento dell'operazione. L'operazione di ripristino occupa immediatamente l'ID database utilizzato nell'operazione.

  1. Utilizza il comando gcloud alpha firestore backups list per identificare il backup da utilizzare per l'operazione di ripristino e prendi nota del nome della risorsa. Il nome della risorsa utilizza il seguente formato:

        projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID

  2. Utilizza il comando gcloud firestore databases delete per eliminare il database esistente:

        gcloud firestore databases delete --database='DATABASE_ID'

    Sostituisci DATABASE_ID con l'ID del database.

  3. Attendi almeno 5 minuti dopo aver eliminato il database per trovare l'ID database per essere di nuovo disponibili. Avvia un'operazione di ripristino utilizzando 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'

    Sostituisci DATABASE_ID con l'ID del database.

Passaggi successivi