Praca z odzyskiwaniem do określonego momentu (PITR)

Konsola

1. W konsoli Google Cloud otwórz stronę Bazy danych.

   Otwórz stronę Bazy danych

2. Wybierz wymaganą bazę danych z listy baz danych.

3. W menu nawigacyjnym kliknij Odzyskiwanie po katastrofie.

4. Aby edytować ustawienia, kliknij Edytuj.

5. Zaznacz pole wyboru Włącz punktowe przywracanie, a następnie kliknij Zapisz.

Włączenie PITR spowoduje naliczanie kosztów za miejsce na dane. Więcej informacji znajdziesz w sekcji Ceny.

Aby wyłączyć PITR, odznacz pole wyboru Włącz odzyskiwanie do określonego momentu na stronie Odzyskiwanie po awarii w konsoli Google Cloud.

gcloud

Aby włączyć PITR podczas tworzenia bazy danych, użyj polecenia gcloud firestore databases create w ten sposób:

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

Zastąp wartości w ten sposób:

• LOCATION – lokalizacja, w której chcesz utworzyć bazę danych.
• DATABASE_ID – ustaw jako identyfikator bazy danych lub (domyślnie).
• TYPE – ustaw na „firestore-native”.

Możesz wyłączyć PITR za pomocą polecenia gcloud firestore databases update w ten sposób:

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

Zastąp wartości w ten sposób:

• DATABASE_ID – ustaw jako identyfikator bazy danych lub (domyślnie).

Konsola

1. W konsoli Google Cloud otwórz stronę Bazy danych.

   Otwórz stronę Bazy danych

2. Wybierz wymaganą bazę danych z listy baz danych.

3. W menu nawigacyjnym kliknij Odzyskiwanie po katastrofie.

4. W sekcji Ustawienia zwróć uwagę na okres przechowywania i najwcześniejszy czas wersji.

   • Okres przechowywania: okres, w którym Cloud Firestore przechowuje wszystkie wersje danych bazy danych. Gdy PITR jest wyłączone, wartość wynosi 1 godzinę, a gdy jest włączone – 7 dni.
   • Czas najstarszej wersji: najstarsza sygnatura czasowa, w której można odczytać starsze wersje danych w oknie PITR. Ta wartość jest stale aktualizowana (Cloud Firestore) i staje się nieaktualna w momencie, gdy zostanie zapytana. Jeśli używasz tej wartości do odzyskiwania danych, uwzględnij czas od momentu zapytania o wartość do momentu zainicjowania odzyskiwania.
   • Odzyskiwanie do określonego momentu: jeśli opcja PITR jest włączona, wyświetla się Enabled. Jeśli PITR jest wyłączony, zobaczyszDisabled.

gcloud

Uruchom polecenie gcloud firestore databases describe w ten sposób:

gcloud firestore databases describe --database=DATABASE_ID

Zastąp DATABASE_ID identyfikatorem bazy danych lub '(default)'.

Oto wynik:

    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/DATABASE_ID
    pointInTimeRecoveryEnablement: POINT_IN_TIME_RECOVERY_DISABLED
    type: FIRESTORE_NATIVE
    uid: 5230c382-dcd2-468f-8cb3-2a1acfde2b32
    updateTime: '2021-11-17T17:48:22.171180Z'
    versionRetentionPeriod: 3600s

gdzie,

• earliestVersionTime: sygnatura czasowa najstarszych zapisanych danych PITR.
• pointInTimeRecoveryEnablement: jeśli PITR jest włączony, wyświetla POINT_IN_TIME_RECOVERY_ENABLED. Jeśli zasada PITR jest wyłączona, zobaczysz pole POINT_IN_TIME_RECOVERY_DISABLED lub pole pointInTimeRecoveryEnablement może się nie wyświetlać.
• versionRetentionPeriod: okres przechowywania danych PITR w milisekundach. Wartość może wynosić 1 godzinę, gdy PITR jest wyłączony, lub 7 dni, gdy jest włączony.

Biblioteki klienta

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

Interfejs API typu REST

Odczyty PITR są obsługiwane we wszystkich metodach odczytu Cloud Firestore, czyli get, list, batchGet, listCollectionIds, listDocuments, runQuery, runAggregationQuery i partitionQuery.

Aby wykonać operację odczytu za pomocą metod REST, użyj jednej z tych opcji:

1. W żądaniu metody odczytu prześlij wartość readTime jako obsługiwany sygnaturą czasu PITR w metodzie readOptions. Sygnatura czasowa PITR może być sygnaturą czasową z dokładnością do mikrosekund w ciągu ostatniej godziny lub sygnaturą czasową z dokładnością do minuty po ostatniej godzinie, ale nie wcześniej niż earliestVersionTime.

2. Użyj parametru readTime razem z metodą BeginTransaction w ramach transakcji ReadOnly, aby odczytać wiele wartości PITR.

Apache Beam

Użyj oprogramowania sprzęgającego Cloud FirestoreIO Apache Beam, aby odczytywać i zapisywać dokumenty w bazie danych Cloud Firestore na dużą skalę za pomocą Dataflow.

Czytanie PITR jest obsługiwane w ramach tej metody odczytu z interfejsu Cloud FirestoreIO. Te metody odczytu obsługują metodę withReadTime(@Nullable Instant readTime), której możesz używać do odczytów PITR:

• FirestoreV1.BatchGetDocuments
• FirestoreV1.ListCollectionIds
• FirestoreV1.ListDocuments
• 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())
  ...

Pełną listę przykładów readTime w przepływie danych Dataflow znajdziesz w repozytorium GitHub.