Realizar uma operação de restauração no local

Esta página descreve como restaurar dados em um backup para um banco de dados com o mesmo nome como o banco de dados de origem do backup. Antes de ler esta página, você precisa saber como Fazer backup e restaurar dados.

Restauração no local

Uma restauração no local permite restaurar um banco de dados a partir de um backup de origem que criou o backup, enquanto o banco de dados original existe. Uma restauração no local ajuda a evitar o redirecionamento do trânsito ou criar um banco de dados com outro nome.

Uma operação de restauração precisa usar um banco de dados de destino que ainda não existe. No entanto, é possível simular uma restauração no local excluindo o banco de dados de origem e, em seguida, restaurar de um backup para um novo banco de dados com o mesmo nome do banco de dados de origem.

Realizar uma restauração no local

Para realizar uma restauração no local, siga estas etapas:

  1. Identifique o backup a ser usado na operação de restauração.
  2. Exclua o banco de dados atual.
  3. Use o backup e o ID do banco de dados excluído para concluir a operação de restauração.

Antes de começar

Recomendamos concluir as etapas a seguir antes de iniciar o processo de restauração no local.

Recuperar e copiar a configuração de índice do seu banco de dados. Use a configuração do índice para recriar índices depois de concluir a operação de restauração no local. Use os comandos a seguir para recuperar a configuração de índice do seu banco de dados:

  • Use gcloud firestore indexes composite list para recuperar uma lista de índices compostos:

        gcloud firestore indexes composite list --database=DATABASE_ID
    

    Substitua DATABASE_ID pelo ID do seu banco de dados.

  • Use gcloud firestore indexes fields list para recuperar uma lista de isenções de índice de campo único (integrado).

        gcloud firestore indexes fields list --database=DATABASE_ID
    

Realizar uma restauração no local

Conclua as etapas a seguir para executar uma operação de restauração no local. Esse processo requer tempo de inatividade entre o momento em que você exclui o banco de dados e quando a a operação de restauração é concluída.

Depois que uma operação de restauração é iniciada, não é possível cancelá-la e é necessário aguardar até que a operação seja concluída. A operação de restauração ocupa imediatamente a ID do banco de dados usado na operação.

  1. Use o comando gcloud firestore backups list para identificar o backup a ser usado para a operação de restauração e anote o nome do recurso. O nome do recurso usa o seguinte formato:

        projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID
    
  2. Use o comando gcloud firestore databases delete para excluir o banco de dados:

        gcloud firestore databases delete --database='DATABASE_ID'
    

    Substitua DATABASE_ID pelo ID do banco de dados.

  3. Aguarde pelo menos cinco minutos após a exclusão do banco de dados para o ID do banco de dados ficar disponível novamente. Inicie uma operação de restauração usando o comando gcloud firestore databases restore:

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

    Substitua DATABASE_ID pelo ID do banco de dados.

A seguir