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, veritabanı için verilerin tüm sürümlerini sakladığı dönem. Değer, PITR devre dışı bırakıldığında bir saat, PITR etkinleştirildiğinde ise yedi gündür.
   • En erken sürüm zamanı: Verilerin PITR penceresinde okunabildiği en erken zaman damgası. Bu değer, Cloud Firestore tarafından sürekli olarak güncellenir ve sorgulandığı anda eskir. Verileri kurtarmak için bu değeri kullanıyorsanız değerin sorgulandığı andan kurtarma işlemini başlattığınız ana kadar geçen süreyi hesaba kattığınızdan emin olun.
   • Belirli bir noktadan önceyi kurtarma: PITR etkinse Enabled gösterilir. PITR devre dışıysa Disabled görürsünüz.

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 etkinse POINT_IN_TIME_RECOVERY_ENABLED gösterilir. PITR devre dışıysa POINT_IN_TIME_RECOVERY_DISABLED gösterilir 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. Bu yöntemler: get, list, batchGet, listCollectionIds, listDocuments, runQuery, runAggregationQuery ve partitionQuery.

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 mikro saniyelik hassasiyet 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ının aşağıdaki okuma yönteminde desteklenir. Bu okuma yöntemleri, PITR okumaları için kullanabileceğiniz withReadTime(@Nullable Instant readTime) yöntemini destekler:

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