Belirli bir noktadan önceyi kurtarma (PITR) ile çalışma

Konsol

1. Google Cloud Platform Console'da Veritabanları sayfasına gidin.

   Veritabanlarına git

2. Veritabanı listesinden gerekli veritabanını seçin.

3. Gezinme menüsünde Olağanüstü Durum Kurtarma'yı tıklayın.

4. Ayarları düzenlemek için Düzenle'yi tıklayın.

5. Belirli bir noktadan önceyi kurtarmayı etkinleştir onay kutusunu işaretleyip Kaydet'i tıklayın.

PITR'nin etkinleştirilmesi depolama maliyetlerine neden olur. Daha fazla bilgi için Fiyatlandırma'yı inceleyin.

PITR'yi devre dışı bırakmak için GCP Console'daki Olağanüstü Durum Kurtarma sayfasında Belirli bir noktadan önceyi kurtarmayı etkinleştir onay kutusunun işaretini kaldırın.

gcloud

Aşağıdaki şekilde gcloud firestore databases create komutuyla veritabanı oluşturma işlemi sırasında PITR'yi etkinleştirin:

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

Değerleri aşağıdaki gibi değiştirin:

• Location: Veritabanınızı oluşturmak istediğiniz konum.
• DATABASE_ID: Veritabanı kimliğine veya (varsayılan) değerine ayarlanır.
• TYPE - firestore'da yerel olarak ayarlandı.

PITR'yi gcloud firestore databases update komutunu kullanarak aşağıdaki gibi devre dışı bırakabilirsiniz:

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

Değerleri aşağıdaki gibi değiştirin:

• DATABASE_ID: Veritabanı kimliğine veya (varsayılan) değerine ayarlanır.

Konsol

1. Google Cloud Platform Console'da Veritabanları sayfasına gidin.

   Veritabanlarına git

2. Veritabanı listesinden gerekli veritabanını seçin.

3. Gezinme menüsünde Olağanüstü Durum Kurtarma'yı tıklayın.

4. Ayarlar bölümünde, Saklama süresi ve En erken sürüm süresi'ne dikkat edin.

   • Saklama süresi: Cloud Firestore'un sakladığı dönem tüm versiyonlarını sunar. PITR ise bir saattir. devre dışı bırakılması ve PITR'nin etkinleştirildiği yedi gün olması gerekir.
   • En erken sürüm zamanı: Eski sürümlerin ait olduğu en erken zaman damgası veriler PITR penceresinde okunabilir. Bu değer sürekli olarak güncellenir ve sorgulandığı anda eskir. Şu durumda: verileri kurtarmak için bu değeri kullanıyorlarsa, bu işlem için Değerin sorgulandığı ana kadar, o ana kadar ele alacağız.
   • Belirli bir noktadan önceyi kurtarma: PITR ise Enabled gösterilir etkin olduğundan emin olun. PITR devre dışıysa Disabled

gcloud

gcloud firestore veritabanlarını açıklama komutunu aşağıdaki gibi çalıştırın:

gcloud firestore databases describe --database=DATABASE_ID

DATABASE_ID değerini veritabanı kimliği veya default ile değiştirin.

Çıkış şu şekildedir:

    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

Burada:

• earliestVersionTime - depolanan en eski PITR verilerinin zaman damgası.
• pointInTimeRecoveryEnablement: PITR ise POINT_IN_TIME_RECOVERY_ENABLED gösterilir etkin olduğundan emin olun. PITR devre dışıysa POINT_IN_TIME_RECOVERY_DISABLED veya pointInTimeRecoveryEnablement alanı görüntülenmeyebilir.
• versionRetentionPeriod - PITR verilerinin milisaniye cinsinden saklandığı dönem. Değer, PITR devre dışı bırakıldığında bir saat, PITR etkinse yedi gün olabilir.

İstemci kitaplıkları

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

REST API

PITR okumaları tüm Cloud Firestore okuma yöntemlerinde desteklenir. get, list, batchGet, listCollectionIds, listDocuments, runQuery, runAggregationQuery ve partitionQuery'dir.

REST yöntemlerini kullanarak bir okuma işlemi gerçekleştirmek için aşağıdaki seçeneklerden birini deneyin:

1. Okuma yöntemi isteğinizde, readTime değerini readOptions yönteminde desteklenen bir PITR zaman damgası olarak iletin. PITR zaman damgası, son bir saat içindeki mikrosaniye hassasiyeti zaman damgası veya son bir saatten sonraki bir tam dakika zaman damgası olabilir ancak earliestVersionTime değerinden önce olamaz.

2. Birden çok PITR okuması için ReadOnly işleminin parçası olarak readTime parametresini BeginTransaction yöntemiyle birlikte kullanın.

Apache Beam

Dataflow ile Cloud Firestore veritabanındaki dokümanları büyük ölçekte okumak veya yazmak için Cloud FirestoreIO Apache Beam bağlayıcısını kullanın.

PITR okumaları, Cloud FirestoreIO bağlayıcısı. Bu okuma yöntemleri PITR için kullanabileceğiniz withReadTime(@Nullable Instant readTime) yöntemi şunu okuyor:

• 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())
  ...

Dataflow ardışık düzenindeki readTime örneklerinin tam listesi için GitHub deposuna göz atın.