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

Bu sayfada, Cloud Firestore'da verileri saklamak ve kurtarmak için belirli bir noktadan önceyi kurtarma (PITR) işlevinin nasıl kullanılacağı açıklanmaktadır.

PITR kavramlarını anlamak için Belirli bir noktadan önceyi kurtarma başlıklı makaleyi inceleyin.

İzinler

PITR ayarlarını yönetmek için gereken izinleri almak üzere yöneticinizden PITR'yi etkinleştirmek istediğiniz projede aşağıdaki IAM rollerini vermesini isteyin:

• Cloud Datastore Sahibi (roles/datastore.owner)

Özel roller için aşağıdaki izinlerin verildiğinden emin olun:

• Veritabanı oluştururken PITR'yi etkinleştirmek için: datastore.databases.create
• Mevcut veritabanında PITR ayarlarını güncellemek için: datastore.databases.update,datastore.databases.list
• PITR verilerinden okuma işlemi yapmak için: datastore.databases.get,datastore.entities.get,datastore.entities.list
• PITR verilerini dışa aktarmak için: datastore.databases.export
• PITR verilerini içe aktarmak için: datastore.databases.import

Başlamadan önce

PITR'yi kullanmaya başlamadan önce aşağıdaki noktalara dikkat edin:

• PITR'yi etkinleştirdikten hemen sonra yedi gün öncesinden okumaya başlayamazsınız.
• Veritabanı oluştururken PITR'yi etkinleştirmek istiyorsanız gcloud firestore databases create komutunu kullanmanız gerekir. Google Cloud Console'u kullanarak veritabanı oluştururken PITR'yi etkinleştirme desteklenmez.
• Cloud Firestore, PITR etkinleştirildikten sonraki sürümleri saklamaya başlar.
• PITR'yi devre dışı bıraktıktan sonra PITR penceresindeki PITR verilerini okuyamazsınız.
• PITR'yi devre dışı bıraktıktan hemen sonra yeniden etkinleştirirseniz geçmiş PITR verileri artık kullanılamaz. PITR devre dışı bırakılmadan önce oluşturulan tüm PITR verileri, PITR geçerlilik bitiş tarihinden sonra silinir.
• Son bir saat içinde yanlışlıkla veri sildiyseniz ve PITR devre dışıysa silme işleminden sonraki bir saat içinde PITR'yi etkinleştirerek verilerinizi geri yükleyebilirsiniz.
• Süresi dolmuş PITR verileri üzerinde gerçekleştirilen tüm okuma işlemleri başarısız olur.

PITR'yi etkinleştirme

PITR'yi kullanmadan önce Google Cloud projeniz için faturalandırmayı etkinleştirin. PITR işlevini yalnızca faturalandırma özelliği etkinleştirilmiş Google Cloud projeleri kullanabilir.

Veritabanınız için PITR'yi etkinleştirmek üzere:

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

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

Saklama süresini ve en eski sürümün zamanını alma

gcloud firestore databases describe --database=DATABASE_ID

    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

PITR verilerini okuma

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

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

PITR verilerinden dışa ve içe aktarma

gcloud firestore export komutunu kullanarak veritabanınızı PITR verilerinden Cloud Storage biçiminde dışa aktarabilirsiniz. Zaman damgasının son yedi gün içinde tam dakika zaman damgası olduğu PITR verilerini dışa aktarabilirsiniz ancak earliestVersionTime tarihinden önceki verileri dışa aktaramazsınız. Veriler belirtilen zaman damgasında artık mevcut değilse dışa aktarma işlemi başarısız olur.

PITR dışa aktarma işlemi, tüm belgelerin dışa aktarılması ve belirli koleksiyonların dışa aktarılması da dahil olmak üzere tüm filtreleri destekler.

1. Veritabanını dışa aktarırken snapshot-time parametresini seçilen kurtarma zaman damgasına göre belirtin.

   gcloud

   Veritabanını paketinize aktarmak için aşağıdaki komutu çalıştırın.

   gcloud firestore export gs://BUCKET_NAME_PATH \
       --snapshot-time=PITR_TIMESTAMP \
       --collection-ids=COLLECTION_IDS \
       --namespace-ids=NAMESPACE_IDS
   

   Nerede,

   • BUCKET_NAME_PATH: Dışa aktarılan dosyaların depolandığı, isteğe bağlı yol ön eki içeren geçerli bir Cloud Storage paketi.
   • PITR_TIMESTAMP - Dakika ayrıntı düzeyinde bir PITR zaman damgası (örneğin, 2023-05-26T10:20:00.00Z veya 2023-10-19T10:30:00.00-07:00).
   • COLLECTION_IDS - koleksiyon kimliklerinin veya koleksiyon grubu kimliklerinin listesi gibi-'specific-collection-group1','specific-collection-group2'.
   • NAMESPACE_IDS - ad alanı kimliklerinin listesi (örneğin) -'customer','orders'.

   PITR verilerini dışa aktarmadan önce aşağıdaki noktalara dikkat edin:

   • Zaman damgasını RFC 3339 biçiminde belirtin. Örneğin, 2023-05-26T10:20:00.00Z veya 2023-10-19T10:30:00.00-07:00.
   • Belirttiğiniz zaman damgasının, son yedi gün içinde ancak earliestVersionTime tarihinden önce olmayan tam dakikalık bir zaman damgası olduğundan emin olun. Belirtilen zaman damgasında artık veri yoksa hata oluşturulur. Belirtilen süre son bir saat içinde olsa bile zaman damgası tam dakika olmalıdır.
   • Başarısız bir PITR dışa aktarma işlemi için sizden ödeme alınmaz.

2. Verileri bir veritabanına aktarma.

   Dışa aktarılan veritabanınızı içe aktarmak için Tüm dokümanları içe aktarma başlıklı makaledeki adımları uygulayın. Veritabanınızda zaten bulunan dokümanların üzerine yazılır.