Praca z odzyskiwaniem do określonego momentu (PITR)

Konsola

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

   Otwórz Bazy danych

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

3. W menu nawigacyjnym kliknij Odtwarzanie awaryjne.

4. Aby zmienić ustawienia, kliknij Edytuj.

5. Zaznacz pole wyboru Włącz odzyskiwanie do określonego momentu, a następnie kliknij Zapisz.

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

Aby wyłączyć odzyskiwanie do określonego momentu, odznacz pole wyboru Włącz odzyskiwanie do określonego momentu na stronie Odtwarzanie awaryjne w konsoli GCP.

gcloud

Włącz PITR podczas tworzenia bazy danych za pomocą 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 te wartości w ten sposób:

• Location – lokalizacja, w której chcesz utworzyć bazę danych.
• DATABASE_ID – ustaw identyfikator bazy danych lub wartość (domyślnie).
• TYPE – ustawiono na tryb natywny w firestore.

Aby wyłączyć PITR, użyj polecenia gcloud firestore databases update w ten sposób:

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

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

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

Konsola

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

   Otwórz Bazy danych

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

3. W menu nawigacyjnym kliknij Odtwarzanie awaryjne.

4. W sekcji Ustawienia zwróć uwagę na pola Okres przechowywania i Czas najwcześniejszej wersji.

   • Okres przechowywania: okres, w którym Cloud Firestore przechowuje wszystkich wersji danych dla tej bazy danych. Wartość wynosi 1 godzinę, gdy wskaźnik PITR wynosi i 7 dni po włączeniu odzyskiwania do określonego momentu.
   • Czas najwcześniejszej wersji: najwcześniejsza sygnatura czasowa, o której starsze wersje dane można odczytać w oknie odzyskiwania do określonego momentu. Ta wartość jest na bieżąco aktualizowana przez Cloud Firestore i staje się nieaktualne w momencie wykonania zapytania. Jeśli używają tej wartości do odzyskiwania danych, pamiętaj, aby uwzględnić okres od moment, w którym wartość jest sprawdzana do momentu zainicjowania zapytania w celu odzyskania konta.
   • Odzyskiwanie do określonego momentu: pokazuje Enabled, jeśli PITR jest włączona. Jeśli funkcja odzyskiwania konta jest wyłączona, zobaczysz Disabled

gcloud

Uruchom polecenie gcloud Firestore databasesscribe w ten sposób:

gcloud firestore databases describe --database=DATABASE_ID

Zastąp DATABASE_ID identyfikatorem bazy danych lub default.

Wyniki będą wyglądać tak:

    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

Gdzie?

• earliestVersionTime – sygnatura czasowa najstarszych przechowywanych danych PITR.
• pointInTimeRecoveryEnablement: pokazuje wartość POINT_IN_TIME_RECOVERY_ENABLED, jeśli PITR jest włączona. Jeśli funkcja odzyskiwania do określonego momentu jest wyłączona, zobaczysz POINT_IN_TIME_RECOVERY_DISABLED lub pointInTimeRecoveryEnablement może nie być wyświetlane.
• versionRetentionPeriod – okres, przez jaki dane o PITR są przechowywane w milisekundach. Wartość może wynosić 1 godzinę, gdy klucz odzyskiwania jest wyłączony, lub 7 dni, jeśli 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 za pomocą żądania PITR są obsługiwane przez wszystkie metody odczytu Cloud Firestore, które są: get, list, batchGet, listCollectionIds, listDocuments, runQuery, runAggregationQuery i partitionQuery.

Aby wykonać odczyt przy użyciu metod REST, wypróbuj jedną z tych opcji:

1. W żądaniu metody odczytu przekaż wartość readTime jako obsługiwaną sygnaturę czasową PITR w metodzie readOptions. Sygnatura czasowa PITR może być albo mikrosekundową, precyzyjną sygnaturą czasową w ciągu ostatniej godziny, albo sygnaturą czasową całej minuty poza ostatnią godziną, ale nie wcześniej niż earliestVersionTime.

2. Użyj parametru readTime w połączeniu z metodą BeginTransaction w ramach transakcji ReadOnly na potrzeby wielu odczytów PITR.

Apache Beam

Użycie oprogramowania sprzęgającego Cloud FirestoreIO Apache Beam do odczytywania i zapisywania dokumentów w bazie danych Cloud Firestore na dużą skalę za pomocą Dataflow.

Odczyty PITR są obsługiwane w tej metodzie odczytu funkcji Oprogramowanie sprzęgające Cloud FirestoreIO. Te metody odczytu obsługują Metoda withReadTime(@Nullable Instant readTime), której możesz użyć do odzyskiwania hasła czyta:

• 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 potoku Dataflow znajdziesz w repozytorium GitHub.