Esegui un 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 situ ti consente di ripristinare un database da un backup nel database di origine che ha creato il backup mentre il database originale è ancora esistente. Il ripristino in loco ti aiuta a evitare il reindirizzamento del traffico o creando 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 loco, segui questi passaggi:

  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.
di Gemini Advanced.

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 recuperare il database eliminato nello stesso ID database, devi attendere il completamento di eventuali operazioni di ripristino in esecuzione, 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 tuo database. Operazioni di esportazione non acquisiscono le definizioni dell'indice. Utilizza la configurazione dell'indice per ricreare gli indici al termine dell'operazione di ripristino in situ. Utilizza i seguenti comandi per recuperare la configurazione dell'indice del 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

Esegui un ripristino in loco

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 nel seguente formato:

        projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID

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

        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 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