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

Konsol

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

   Veritabanları'na gidin

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

3. Gezinme menüsünde Afet Kurtarma'yı tıklayın.

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

5. Belirli bir zamana ait kurtarma işlemini etkinleştir onay kutusunu işaretleyin ve Kaydet'i tıklayın.

PITR'nin etkinleştirilmesi depolama alanı maliyetlerine neden olur. Daha fazla bilgi için Fiyatlandırma bölümüne bakın.

PITR'yi devre dışı bırakmak için Google Cloud Console'daki Afet Kurtarma sayfasında Belirli bir zamana ait kurtarmayı etkinleştir onay kutusunu temizleyin.

gcloud

Aşağıdaki gibi gcloud firestore databases create komutuyla veritabanı oluşturma 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ı oluşturmak istediğiniz konum.
• DATABASE_ID: Veritabanı kimliğine veya (varsayılan) olarak ayarlanır.
• TYPE: firestore-native olarak ayarlanır.

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) olarak ayarlanır.

Konsol

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

   Veritabanları'na gidin

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

3. Gezinme menüsünde Afet Kurtarma'yı tıklayın.

4. Ayarlar bölümünde Saklama süresi ve En eski sürüm zamanı'nı not edin.

   • Saklama süresi: Cloud Firestore'nin veritabanı verilerinin tüm sürümlerini sakladığı dönemdir. Bu değer, PITR devre dışıyken bir saat, PITR etkinken yedi gündür.
   • En eski sürüm zamanı: Verilerin eski sürümlerinin PITR aralığında okunabildiği en erken zaman damgası. Bu değer Cloud Firestore tarafından sürekli olarak güncellenir ve sorgulandığı anda güncelliğini yitirir. 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: Belirli bir noktadan önceyi kurtarma etkinse Enabled gösterilir. PITR devre dışıysa Disabled simgesini görürsünüz.

gcloud

gcloud firestore databases describe komutunu aşağıdaki gibi çalıştırın:

gcloud firestore databases describe --database=DATABASE_ID

DATABASE_ID yerine veritabanı kimliğini veya '(default)' değerini girin.

Çı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/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

Burada:

• earliestVersionTime: Depolanan en eski PITR verilerinin zaman damgası.
• pointInTimeRecoveryEnablement: PITR etkinse POINT_IN_TIME_RECOVERY_ENABLED değerini gösterir. PITR devre dışıysa POINT_IN_TIME_RECOVERY_DISABLED değerini görürsünüz veya pointInTimeRecoveryEnablement alanı gösterilmeyebilir.
• versionRetentionPeriod: PITR verilerinin milisaniye cinsinden saklandığı dönem. Değer, PITR devre dışıyken bir saat veya PITR etkinken 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ı, get, list, batchGet, listCollectionIds, listDocuments, runQuery, runAggregationQuery ve partitionQuery olan tüm Cloud Firestore okuma yöntemlerinde desteklenir.

REST yöntemlerini kullanarak 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çinde mikrosaniye hassasiyetinde bir zaman damgası veya son bir saatten sonraki bir tam dakikalık zaman damgası olabilir ancak earliestVersionTime'ten önce olamaz.

2. Birden fazla PITR okuması için readTime parametresini BeginTransaction yöntemiyle birlikte bir ReadOnly işlemi kapsamında kullanın.

Apache Beam

Dataflow ile Cloud Firestore veritabanında büyük ölçekte belge 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. Aşağıdaki 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())
  ...

Veri Akışı ardışık düzenindeki readTime örneklerinin tam listesi için GitHub deposuna bakın.