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:

  1. Exporte os dados no banco de dados que você excluirá.

    Se você precisar recuperar o banco de dados excluído, import os dados da operação de exportação. Para recuperar o banco de dados excluído com o mesmo ID do banco de dados, você precisa aguardar até que qualquer operação de restauração em execução seja concluída e, em seguida:

    1. Excluir o banco de dados atual com o ID dele e aguardar pelo menos cinco minutos.
    2. Criar um novo banco de dados com o ID dele
    3. Iniciar uma operação de importação

  2. Recuperar e copiar a configuração de índice do seu banco de dados. Operações de exportação não capturam definições de índice. Use a configuração do índice para recriar índices depois de concluir a operação de restauração no local. Use os seguintes comandos 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