Trabaje con la recuperación de un punto en el tiempo (PITR)

Consola

1. En la consola de Google Cloud Platform, vaya a la página Bases de datos .

   Ir a Bases de Datos

2. Seleccione la base de datos requerida de la lista de bases de datos.

3. En el menú de navegación, haga clic en Recuperación ante desastres .

4. Haga clic en Editar para editar la configuración.

5. Seleccione la casilla de verificación Habilitar recuperación de un momento dado y luego haga clic en Guardar .

Habilitar PITR generaría costos de almacenamiento. Consulte Precios para obtener más información.

Para deshabilitar PITR, desmarque la casilla de verificación Habilitar recuperación a un momento dado en la página Recuperación ante desastres en GCP Console.

nube de gcloud

Habilite PITR durante la creación de la base de datos con el comando gcloud firestore databases create de la siguiente manera:

gcloud firestore databases create\
  --location=LOCATION\
  [--database=DATABASE_ID; default="(default)"]\
  [--type=TYPE; default="firestore-native"]\
  --enable-pitr

Reemplace los valores de la siguiente manera:

• Location : ubicación donde desea crear su base de datos.
• DATABASE_ID : establecido en el ID de la base de datos o (predeterminado).
• TYPE : configurado como nativo de Firestore.

Puedes deshabilitar PITR usando el comando gcloud firestore databases update de la siguiente manera:

gcloud firestore databases update\
  [--database=DATABASE_ID; default="(default)"]\
  --no-enable-pitr

Reemplace los valores de la siguiente manera:

• DATABASE_ID : establecido en el ID de la base de datos o (predeterminado).

Consola

1. En la consola de Google Cloud Platform, vaya a la página Bases de datos .

   Ir a Bases de Datos

2. Seleccione la base de datos requerida de la lista de bases de datos.

3. En el menú de navegación, haga clic en Recuperación ante desastres .

4. En la sección Configuración , observe el Período de retención y la Hora de la versión más temprana .

   • Período de retención : el período en el que Cloud Firestore conserva todas las versiones de los datos de la base de datos. El valor es una hora cuando PITR está deshabilitado y siete días cuando PITR está habilitado.
   • Hora de versión más antigua : la marca de tiempo más antigua en la que se pueden leer versiones anteriores de los datos en la ventana PITR. Cloud Firestore actualiza continuamente este valor y queda obsoleto en el momento en que se consulta. Si está utilizando este valor para recuperar datos, asegúrese de tener en cuenta el tiempo desde el momento en que se consulta el valor hasta el momento en que inicia la recuperación.
   • Recuperación de un momento dado : muestra Enabled , si PITR está habilitado. Si PITR está deshabilitado, verá Disabled .

nube de gcloud

Ejecute el comando de descripción de bases de datos de gcloud firestore de la siguiente manera:

gcloud firestore databases describe --database=DATABASE_ID

Reemplace DATABASE_ID con el ID de la base de datos o default .

Aquí está el resultado:

    appEngineIntegrationMode: ENABLED
    concurrencyMode: PESSIMISTIC
    createTime: '2021-03-24T17:02:35.234Z'
    deleteProtectionState: DELETE_PROTECTION_DISABLED
    earliestVersionTime: '2023-06-12T16:17:25.222474Z'
    etag: IIDayqOevv8CMNTvyNK4uv8C
    keyPrefix: s
    locationId: nam5
    name: projects/PROJECT_ID/databases/(default)
    pointInTimeRecoveryEnablement: POINT_IN_TIME_RECOVERY_DISABLED
    type: FIRESTORE_NATIVE
    uid: 5230c382-dcd2-468f-8cb3-2a1acfde2b32
    updateTime: '2021-11-17T17:48:22.171180Z'
    versionRetentionPeriod: 3600s

dónde,

• earliestVersionTime : marca de tiempo de los primeros datos PITR almacenados.
• pointInTimeRecoveryEnablement : muestra POINT_IN_TIME_RECOVERY_ENABLED , si PITR está habilitado. Si PITR está deshabilitado, verá POINT_IN_TIME_RECOVERY_DISABLED o es posible que el campo pointInTimeRecoveryEnablement no se muestre.
• versionRetentionPeriod : período de tiempo durante el cual se retienen los datos PITR en milisegundos. El valor puede ser una hora cuando PITR está deshabilitado o siete días si PITR está habilitado.

Bibliotecas cliente

  Firestore firestore = …

  TransactionOptions options =
          TransactionOptions.createReadOnlyOptionsBuilder()
              .setReadTime(
                  com.google.protobuf.Timestamp.newBuilder()
                      .setSeconds(1684098540L)
                      .setNanos(0))
              .build();

  ApiFuture<Void> futureTransaction = firestore.runTransaction(
              transaction -> {
                // Does a snapshot read document lookup
                final DocumentSnapshot documentResult =
                    transaction.get(documentReference).get();

                // Executes a snapshot read query
                final QuerySnapshot queryResult =
                  transaction.get(query).get();
              },
              options);

  // Blocks on transaction to complete
  futureTransaction.get();

  const documentSnapshot = await firestore.runTransaction(
    updateFunction => updateFunction.get(documentRef),
    {readOnly: true, readTime: new Firestore.Timestamp(1684098540, 0)}
);

  const querySnapshot = await firestore.runTransaction(
    updateFunction => updateFunction.get(query),
    {readOnly: true, readTime: new Firestore.Timestamp(1684098540, 0)}
  )

API DESCANSO

Las lecturas PITR se admiten en todos los métodos de lectura de Cloud Firestore, que son get , list , batchGet , listCollectionIds , listDocuments , runQuery , runAggregationQuery y particionQuery .

Para realizar una lectura utilizando los métodos REST, pruebe una de las siguientes opciones:

1. En la solicitud del método de lectura, pase el valor readTime como marca de tiempo PITR admitida en el método readOptions . Una marca de tiempo PITR puede ser una marca de tiempo con precisión de microsegundos dentro de la última hora o una marca de tiempo de un minuto completo más allá de la última hora, pero no antes de la earliestVersionTime .

2. Utilice el parámetro readTime junto con el método BeginTransaction como parte de una transacción ReadOnly para múltiples lecturas PITR.

Haz Apache

Utilice el conector Apache Beam de Cloud FirestoreIO para leer o escribir documentos en una base de datos de Cloud Firestore a gran escala con Dataflow.

Las lecturas PITR se admiten en el siguiente método de lectura del conector Cloud FirestoreIO. Estos métodos de lectura admiten el método withReadTime(@Nullable Instant readTime) que puede utilizar para lecturas PITR:

• FirestoreV1.BatchGetDocumentos
• FirestoreV1.ListCollectionIds
• FirestoreV1.ListDocumentos
• FirestoreV1.PartitionQuery

• FirestoreV1.RunQuery

  Instant readTime = Instant.ofEpochSecond(1684098540L);

  PCollection<Document> documents =
      pipeline
          .apply(Create.of(collectionId))
          .apply(
              new FilterDocumentsQuery(
                  firestoreOptions.getProjectId(), firestoreOptions.getDatabaseId()))
          .apply(FirestoreIO.v1().read().runQuery().withReadTime(readTime).withRpcQosOptions(rpcQosOptions).build())
  ...

Para obtener una lista completa de ejemplos readTime en la canalización de Dataflow, consulte el repositorio de Github .