Realiza una operación de restablecimiento local

En esta página, se describe cómo restablecer datos de una copia de seguridad en una base de datos con el mismo nombre como la base de datos de origen de la copia de seguridad. Antes de leer esta página, debes familiarizarte con Cómo crear una copia de seguridad y restablecer los datos.

Restablecimiento local

El restablecimiento local te permite restablecer una base de datos desde una copia de seguridad a la base de datos de origen que creó la copia de seguridad mientras que la base de datos original aún existe. Un restablecimiento local te ayuda a evitar redirigir el tráfico o crear una base de datos con un nombre diferente.

Una operación de restablecimiento debe usar una base de datos de destino que no existe todavía. Sin embargo, puedes simular una restauración local si borras la base de datos de origen y, luego, restableces desde una copia de seguridad a una nueva base de datos con el mismo nombre que la base de datos de origen.

Realiza un restablecimiento local

Para realizar un restablecimiento local, sigue estos pasos:

  1. Identifica la copia de seguridad que se usará para la operación de restablecimiento.
  2. Borra la base de datos existente.
  3. Usa la copia de seguridad y el ID de la base de datos de la base de datos borrada para completar la operación de restablecimiento.

Antes de comenzar

Te recomendamos que completes los siguientes pasos antes de comenzar el proceso de restablecimiento local:

  1. Exporta los datos en la base de datos que borrarás.

    Si necesitas recuperar la base de datos borrada, usa el comando import para importar los datos de la operación de exportación. Para recuperar la base de datos borrada con el mismo ID de la base de datos, debes esperar hasta que se complete cualquier operación de restablecimiento en ejecución y, luego, haz lo siguiente:

    1. Borra la base de datos existente con el ID de la base de datos y espera al menos 5 minutos
    2. Crea una base de datos nueva con el ID de la base de datos
    3. Inicia una operación de importación

  2. Recupera y copia la configuración de índices de tu base de datos. Las operaciones de exportación no capturan las definiciones de índice. Usa la configuración de índices para volver a crear los índices después de completar la operación de restablecimiento local. Usa los siguientes comandos para recuperar la configuración de índices de tu base de datos:

    • Usa gcloud firestore indexes composite list para recuperar una lista de índices compuestos:

      gcloud firestore indexes composite list --database=DATABASE_ID

      Reemplaza DATABASE_ID por el ID de tu base de datos.

    • Usa gcloud firestore indexes fields list para recuperar una lista de exenciones de índice de campo único (integrados).

      gcloud firestore indexes fields list --database=DATABASE_ID

Realiza un restablecimiento local

Completa los siguientes pasos para realizar una operación de restablecimiento local. Este proceso requiere tiempo de inactividad desde que se borra la base de datos hasta que se completa la operación de restablecimiento.

Una vez que comienza una operación de restablecimiento, no puedes cancelarla y debes esperar hasta que la operación finalice. La operación de restablecimiento ocupa inmediatamente el ID de la base de datos que se usa en la operación.

  1. Usa el comando gcloud firestore backups list para identificar la copia de seguridad que se usará para la operación de restablecimiento y anota el nombre del recurso. El nombre del recurso usa el siguiente formato:

        projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID

  2. Usa el comando gcloud firestore databases delete para borrar la base de datos existente:

        gcloud firestore databases delete --database='DATABASE_ID'

    Reemplaza DATABASE_ID por el ID de la base de datos.

  3. Espera al menos 5 minutos después de borrar la base de datos para que el ID de la base de datos vuelva a estar disponible. Inicia una operación de restablecimiento con el comando gcloud firestore databases restore:

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

    Reemplaza DATABASE_ID por el ID de la base de datos.

Próximos pasos