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

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

Belirli bir noktadan önceyi kurtarma 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 size 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 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 noktaları göz önünde bulundurun:

• PITR'yi etkinleştirdikten hemen sonra yedi gün öncesine ait kayıtları okumaya başlayamazsınız.
• Bir 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ştirmek desteklenmez.
• Cloud Firestore, PITR'yi etkinleştirdikten sonra o noktadan itibaren 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'nin 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 verilerinde yapılan 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. Yalnızca faturalandırma özelliği etkinleştirilmiş Google Cloud projeleri PITR işlevini kullanabilir.

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

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

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

Saklama süresini ve en eski sürüm 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

İstemci kitaplıklarını, REST API yöntemlerini veya FirestoreIO Apache Beam bağlayıcısını kullanarak PITR verilerini okuyabilirsiniz.

  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 verilerini dışa ve içe aktarma

gcloud firestore export komutunu kullanarak veritabanınızı PITR verilerinden Cloud Storage'e aktarabilirsiniz. Zaman damgasının son yedi gün içinde tam dakikalık bir zaman damgası olduğu ancak earliestVersionTime tarihinden önce olmadığı PITR verilerini dışa aktarabilirsiniz. Belirtilen zaman damgasında artık veri yoksa dışa aktarma işlemi başarısız olur.

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

1. snapshot-time parametresini istenen kurtarma zaman damgasıyla belirterek veritabanını dışa aktarın.

   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
   

   Where,

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

   PITR verilerini dışa aktarmadan önce aşağıdaki noktaları göz önünde bulundurun:

   • 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 tam dakikalık bir zaman damgası olduğundan ancak earliestVersionTime tarihinden önce olmadığından emin olun. Belirtilen zaman damgasında artık veri yoksa hata oluşur. Belirtilen zaman son bir saat içinde olsa bile zaman damgası tam bir dakika olmalıdır.
   • Başarısız PITR dışa aktarma işlemi için ücretlendirilmezsiniz.

2. Bir veritabanına aktarın.

   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ında zaten mevcut olan dokümanların üzerine yazılır.