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 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şaretleyin ve ardından Kaydet'i tıklayın.

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

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

gcloud

Veritabanı oluşturma sırasında gcloud firestore databases create ve --enable-ptir komutuyla PITR'yi aşağıdaki gibi etkinleştirin:

gcloud firestore databases create\
  --location=LOCATION\
  --database=DATABASE_ID\
  --type=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ği olarak ayarlanır.

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

gcloud firestore databases update\
  --database=DATABASE_ID\
  --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 Console'da Veritabanları sayfasına gidin.

   Veritabanları'na gidin

2. Veritabanları 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 eski sürüm zamanı'nı not edin.

   • Saklama süresi: Cloud Firestore tarafından veritabanı için tüm veri sürümlerinin saklandığı süre. PITR devre dışı bırakıldığında değer bir saat, etkinleştirildiğinde ise yedi gündür.
   • En erken sürüm zamanı: Verilerin eski sürümlerinin PITR penceresinde okunabileceği en erken zaman damgası. Bu değer Cloud Firestore tarafından sürekli güncellenir ve sorgulandığı anda güncelliğini yitirir. Bu değeri veri kurtarmak için 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 değerini gösterir. PITR devre dışıysa Disabled ifadesini 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 ifadesini görürsünüz veya pointInTimeRecoveryEnablement alanı gösterilmeyebilir.
• versionRetentionPeriod: PITR verilerinin saklandığı milisaniye cinsinden süre. PITR devre dışıysa değer 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 okuma işlemleri, tüm Cloud Firestore okuma yöntemlerinde desteklenir: get, list, batchGet, listCollectionIds, listDocuments, runQuery, runAggregationQuery ve partitionQuery.

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çindeki mikrosaniye hassasiyetinde bir zaman damgası veya son bir saatten önceki tam dakika zaman damgası olabilir ancak earliestVersionTime tarihinden önce olamaz.

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

Apache Beam

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

Belirli bir zamana geri yükleme okuma işlemleri, 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 bakın.

Console

Firebase konsolu, veritabanı klonlamayı desteklemez. Veritabanlarını klonlamak için Google Cloud CLI talimatlarını kullanabilirsiniz.

gcloud

Bir veritabanını klonlamak için gcloud firestore databases clone komutunu kullanın:

gcloud firestore databases clone \
--source-database='SOURCE_DATABASE' \
--snapshot-time='PITR_TIMESTAMP' \
--destination-database='DESTINATION_DATABASE_ID'

Aşağıdakini değiştirin:

• SOURCE_DATABASE: Klonlamak istediğiniz mevcut bir veritabanının veritabanı adı. Ad, projects/PROJECT_ID/databases/SOURCE_DATABASE_ID biçimini kullanır.

• PITR_TIMESTAMP: RFC 3339 biçiminde, dakika ayrıntı düzeyinde bir PITR zaman damgası. Örneğin: 2025-06-01T10:20:00.00Z veya 2025-06-01T10:30:00.00-07:00.

• DESTINATION_DATABASE_ID: Klonlanan yeni bir veritabanı için veritabanı kimliği. Bu veritabanı kimliği, mevcut bir veritabanıyla ilişkili olmamalıdır.

Örnek:

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db'

Bir veritabanını klonlarken bazı etiketlere bağlamak istiyorsanız önceki komutu --tags işaretiyle kullanın. Bu işaret, bağlanacak etiketlerin ANAHTAR=DEĞER çiftlerinin isteğe bağlı bir listesidir.

Örnek:

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--tags=key1=value1,key2=value2

Klonlanan veritabanı, varsayılan olarak kaynak veritabanıyla aynı şifreleme yapılandırmasına sahip olur. Şifreleme yapılandırmasını değiştirmek için --encryption-type bağımsız değişkenini kullanın:

• (Varsayılan) use-source-encryption: Kaynak veritabanıyla aynı şifreleme yapılandırmasını kullanın.
• google-default-encryption: Google'ın varsayılan şifrelemesini kullanın.
• customer-managed-encryption: CMEK şifrelemesi kullanın. --kms-key-name bağımsız değişkeninde bir anahtar kimliği belirtin.

Aşağıdaki örnekte, kopyalanan veritabanı için CMEK şifrelemesinin nasıl yapılandırılacağı gösterilmektedir:

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--encryption-type='customer-managed-encryption' \
--kms-key-name='projects/example-project/locations/us-central1/keyRings/example-key-ring/cryptoKeys/example-key'

Firebase CLI

Bir veritabanını klonlamak için firebase firestore:databases:clone komutunu kullanın:

firebase firestore:databases:clone \
'SOURCE_DATABASE' \
'DESTINATION_DATABASE' \
--snapshot-time 'PITR_TIMESTAMP'

Aşağıdakini değiştirin:

• SOURCE_DATABASE: Klonlamak istediğiniz mevcut bir veritabanının veritabanı adı. Ad, projects/PROJECT_ID/databases/SOURCE_DATABASE_ID biçimini kullanır.

• DESTINATION_DATABASE: Klonlanan yeni veritabanı için bir veritabanı adı. Ad, projects/PROJECT_ID/databases/DESTINATION_DATABASE_ID biçimini kullanır. Bu veritabanı adı, mevcut bir veritabanıyla ilişkili olmamalıdır.

• PITR_TIMESTAMP: RFC 3339 biçiminde, dakika ayrıntı düzeyinde bir PITR zaman damgası. Örneğin: 2025-06-01T10:20:00.00Z veya 2025-06-01T10:30:00.00-07:00. Belirtilmezse seçilen anlık görüntü, geçerli zamanın dakikaya yuvarlanmış hali olur.

Klonlanan veritabanı, varsayılan olarak kaynak veritabanıyla aynı şifreleme yapılandırmasına sahip olur. Şifreleme yapılandırmasını değiştirmek için --encryption-type bağımsız değişkenini kullanın:

• (Varsayılan) USE_SOURCE_ENCRYPTION: Kaynak veritabanıyla aynı şifreleme yapılandırmasını kullanın.
• GOOGLE_DEFAULT_ENCRYPTION: Google'ın varsayılan şifrelemesini kullanın.
• CUSTOMER_MANAGED_ENCRYPTION: CMEK şifrelemesi kullanın. --kms-key-name bağımsız değişkeninde bir anahtar kimliği belirtin.

Aşağıdaki örnekte, kopyalanan veritabanı için CMEK şifrelemesinin nasıl yapılandırılacağı gösterilmektedir:

firebase firestore:databases:clone \
'projects/example-project/databases/(default)' \
'projects/example-project/databases/example-dest-db' \
--snapshot-time 'PITR_TIMESTAMP' \
--encryption-type CUSTOMER_MANAGED_ENCRYPTION