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 Odtwarzanie awaryjne.

4. Kliknij Edytuj, aby edytować ustawienia.

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

Włączenie odzyskiwania do określonego momentu wiąże się z kosztami miejsca na dane. Więcej informacji znajdziesz w cenniku.

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

gcloud

Włącz odzyskiwanie do określonego momentu podczas tworzenia bazy danych za pomocą poleceń gcloud firestore databases create i --enable-ptir w ten sposób:

gcloud firestore databases create\
  --location=LOCATION\
  --database=DATABASE_ID\
  --type=firestore-native\
  --enable-pitr

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

• LOCATION – lokalizacja, w której chcesz utworzyć bazę danych.
• DATABASE_ID – ustaw na identyfikator bazy danych.

Możesz wyłączyć odzyskiwanie do określonego momentu, używając polecenia gcloud firestore databases update w ten sposób:

gcloud firestore databases update\
  --database=DATABASE_ID\
  --no-enable-pitr

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

• DATABASE_ID – ustaw na identyfikator bazy danych lub (default).

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 Odtwarzanie awaryjne.

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

   • Okres przechowywania: okres, w którym Cloud Firestore przechowuje wszystkie wersje danych bazy danych. Wartość wynosi 1 godzinę, gdy odzyskiwanie do określonego momentu jest wyłączone, i 7 dni, gdy jest włączone.
   • Czas najwcześniejszej wersji: najwcześniejsza sygnatura czasowa, przy której starsze wersje danych można odczytać w oknie PITR. Ta wartość jest stale aktualizowana przez Cloud Firestore i staje się nieaktualna w momencie wysłania zapytania. Jeśli używasz tej wartości do przywracania danych, uwzględnij czas od momentu wysłania zapytania o wartość do momentu rozpoczęcia przywracania.
   • Odzyskiwanie do określonego momentu: pokazuje Enabled, jeśli odzyskiwanie do określonego momentu jest włączone. Jeśli odzyskiwanie do określonego momentu jest wyłączone, zobaczysz Disabled.

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 dane wyjściowe:

    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 najwcześniejszych przechowywanych danych PITR.
• pointInTimeRecoveryEnablement: pokazuje POINT_IN_TIME_RECOVERY_ENABLED, jeśli włączone jest odzyskiwanie do określonego momentu. Jeśli odzyskiwanie do określonego momentu jest wyłączone, zobaczysz POINT_IN_TIME_RECOVERY_DISABLED lub pole pointInTimeRecoveryEnablement może nie być wyświetlane.
• versionRetentionPeriod: okres przechowywania danych PITR w milisekundach. Wartość może wynosić 1 godzinę, gdy odzyskiwanie do określonego momentu jest wyłączone, lub 7 dni, gdy jest włączone.

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ć odczyt za pomocą 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ć sygnaturą czasową z dokładnością do mikrosekundy w ciągu ostatniej godziny lub sygnaturą czasową z dokładnością do minuty sprzed ostatniej godziny, ale nie wcześniejszą niż earliestVersionTime.

2. Użyj parametru readTime razem z metodą BeginTransaction w ramach transakcji ReadOnly, aby wykonać wiele odczytów PITR.

Apache Beam

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

Odczyty PITR są obsługiwane w tej metodzie odczytu oprogramowania sprzęgającego 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 potoku Dataflow znajdziesz w repozytorium GitHub.

Konsola

Konsola Firebase nie obsługuje klonowania baz danych. Aby sklonować bazy danych, możesz użyć instrukcji dla Google Cloud CLI.

gcloud

Aby sklonować bazę danych, użyj polecenia gcloud firestore databases clone:

gcloud firestore databases clone \
--source-database='SOURCE_DATABASE' \
--snapshot-time='PITR_TIMESTAMP' \
--destination-database='DESTINATION_DATABASE_ID'

Zastąp następujące elementy:

• SOURCE_DATABASE: nazwa bazy danych, którą chcesz sklonować. Nazwa ma format projects/PROJECT_ID/databases/SOURCE_DATABASE_ID.

• PITR_TIMESTAMP: sygnatura czasowa odzyskiwania do określonego momentu w formacie RFC 3339 z dokładnością do minuty. Na przykład: 2025-06-01T10:20:00.00Z lub 2025-06-01T10:30:00.00-07:00.

• DESTINATION_DATABASE_ID: identyfikator bazy danych dla nowej sklonowanej bazy danych. Ten identyfikator bazy danych nie może być powiązany z istniejącą bazą danych.

Przykład:

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db'

Jeśli podczas klonowania bazy danych chcesz powiązać ją z niektórymi tagami, użyj poprzedniego polecenia z flagą --tags, która jest opcjonalną listą par KLUCZ=WARTOŚĆ tagów do powiązania.

Przykład:

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--tags=key1=value1,key2=value2

Domyślnie sklonowana baza danych będzie miała taką samą konfigurację szyfrowania jak źródłowa baza danych. Aby zmienić konfigurację szyfrowania, użyj argumentu --encryption-type:

• (Domyślna) use-source-encryption: użyj tej samej konfiguracji szyfrowania co źródłowa baza danych.
• google-default-encryption: użyj domyślnego szyfrowania Google.
• customer-managed-encryption: użyj szyfrowania CMEK. W argumencie --kms-key-name podaj identyfikator klucza.

Poniższy przykład pokazuje, jak skonfigurować szyfrowanie CMEK dla sklonowanej bazy danych:

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--encryption-type='customer-managed-encryption' \
--kms-key-name='projects/example-project/locations/us-central1/keyRings/example-key-ring/cryptoKeys/example-key'

wiersz poleceń Firebase

Aby sklonować bazę danych, użyj polecenia firebase firestore:databases:clone:

firebase firestore:databases:clone \
'SOURCE_DATABASE' \
'DESTINATION_DATABASE' \
--snapshot-time 'PITR_TIMESTAMP'

Zastąp następujące elementy:

• SOURCE_DATABASE: nazwa bazy danych, którą chcesz sklonować. Nazwa ma format projects/PROJECT_ID/databases/SOURCE_DATABASE_ID.

• DESTINATION_DATABASE: nazwa bazy danych dla nowej sklonowanej bazy danych. Nazwa ma format projects/PROJECT_ID/databases/DESTINATION_DATABASE_ID. Ta nazwa bazy danych nie może być powiązana z istniejącą bazą danych.

• PITR_TIMESTAMP: sygnatura czasowa odzyskiwania do określonego momentu w formacie RFC 3339 z dokładnością do minuty. Na przykład: 2025-06-01T10:20:00.00Z lub 2025-06-01T10:30:00.00-07:00. Jeśli nie zostanie określony, wybrany zostanie bieżący czas zaokrąglony w dół do minuty.

Domyślnie sklonowana baza danych będzie miała taką samą konfigurację szyfrowania jak źródłowa baza danych. Aby zmienić konfigurację szyfrowania, użyj argumentu --encryption-type:

• (Domyślna) USE_SOURCE_ENCRYPTION: użyj tej samej konfiguracji szyfrowania co źródłowa baza danych.
• GOOGLE_DEFAULT_ENCRYPTION: użyj domyślnego szyfrowania Google.
• CUSTOMER_MANAGED_ENCRYPTION: użyj szyfrowania CMEK. W argumencie --kms-key-name podaj identyfikator klucza.

Poniższy przykład pokazuje, jak skonfigurować szyfrowanie CMEK dla sklonowanej bazy danych:

firebase firestore:databases:clone \
'projects/example-project/databases/(default)' \
'projects/example-project/databases/example-dest-db' \
--snapshot-time 'PITR_TIMESTAMP' \
--encryption-type CUSTOMER_MANAGED_ENCRYPTION