पॉइंट-इन-टाइम रिकवरी (पीआईटीआर) की मदद से काम करना

कंसोल

1. Google Cloud Console में, डेटाबेस पेज पर जाएं.

   डेटाबेस पर जाएं

2. डेटाबेस की सूची में से, ज़रूरी डेटाबेस चुनें.

3. नेविगेशन मेन्यू में, डिज़ास्टर रिकवरी पर क्लिक करें.

4. सेटिंग में बदलाव करने के लिए, बदलाव करें पर क्लिक करें.

5. पॉइंट-इन-टाइम रिकवरी की सुविधा चालू करें चेकबॉक्स को चुनें. इसके बाद, सेव करें पर क्लिक करें.

पीआईटीआर की सुविधा चालू करने पर, स्टोरेज का शुल्क लगता है. ज़्यादा जानकारी के लिए, कीमत देखें.

पीआईटीआर की सुविधा बंद करने के लिए, Google Cloud Console में डिज़ास्टर रिकवरी पेज पर जाकर, पॉइंट-इन-टाइम रिकवरी की सुविधा चालू करें चेकबॉक्स से सही का निशान हटाएं.

gcloud

डेटाबेस बनाते समय पीआईटीआर की सुविधा चालू करने के लिए, gcloud firestore databases create और --enable-ptir कमांड का इस्तेमाल करें. जैसे:

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

इन वैल्यू को बदलें:

• LOCATION - वह जगह जहां आपको अपना डेटाबेस बनाना है.
• DATABASE_ID \- इसे डेटाबेस आईडी पर सेट करें.

gcloud firestore databases update कमांड का इस्तेमाल करके, पीआईटीआर की सुविधा बंद की जा सकती है. जैसे:

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

इन वैल्यू को बदलें:

• DATABASE_ID - इसे डेटाबेस आईडी या (डिफ़ॉल्ट) पर सेट करें.

कंसोल

1. Google Cloud Console में, डेटाबेस पेज पर जाएं.

   डेटाबेस पर जाएं

2. डेटाबेस की सूची में से, ज़रूरी डेटाबेस चुनें.

3. नेविगेशन मेन्यू में, डिज़ास्टर रिकवरी पर क्लिक करें.

4. सेटिंग सेक्शन में, डेटा के रखरखाव की अवधि और सबसे पुराने वर्शन का समय देखें.

   • डेटा के रखरखाव की अवधि: वह अवधि जिसके दौरान Cloud Firestore डेटाबेस के सभी वर्शन का डेटा बनाए रखता है. पीआईटीआर की सुविधा बंद होने पर, यह वैल्यू एक घंटा होती है. वहीं, पीआईटीआर की सुविधा चालू होने पर, यह वैल्यू सात दिन होती है.
   • सबसे पुराने वर्शन का समय: वह सबसे पुराना टाइमस्टैंप जिस पर पीआईटीआर विंडो में डेटा के पुराने वर्शन पढ़े जा सकते हैं. Cloud Firestore इस वैल्यू को लगातार अपडेट करता है Cloud Firestoreक्वेरी करने पर, यह वैल्यू पुरानी हो जाती है. अगर डेटा वापस पाने के लिए इस वैल्यू का इस्तेमाल किया जा रहा है, तो क्वेरी करने के समय से लेकर डेटा वापस पाने की प्रोसेस शुरू करने के समय तक के अंतर को ध्यान में रखें.
   • पॉइंट-इन-टाइम रिकवरी: अगर पीआईटीआर की सुविधा चालू है, तो Enabled दिखता है. अगर पीआईटीआर की सुविधा बंद है, तो Disabled दिखेगा.

gcloud

gcloud firestore databases describe कमांड को इस तरह चलाएं:

gcloud firestore databases describe --database=DATABASE_ID

DATABASE_ID को डेटाबेस आईडी या '(default)' से बदलें.

यहां आउटपुट दिया गया है:

    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

यहां,

• earliestVersionTime: सेव किए गए सबसे पुराने पीआईटीआर डेटा का टाइमस्टैंप.
• pointInTimeRecoveryEnablement: अगर पीआईटीआर की सुविधा चालू है, तो POINT_IN_TIME_RECOVERY_ENABLED दिखता है. अगर पीआईटीआर की सुविधा बंद है, तो आपको POINT_IN_TIME_RECOVERY_DISABLED दिखेगा. इसके अलावा, pointInTimeRecoveryEnablement फ़ील्ड नहीं भी दिख सकता है.
• versionRetentionPeriod: वह समयावधि जिसके लिए पीआईटीआर डेटा को मिलीसेकंड में बनाए रखा जाता है. पीआईटीआर की सुविधा बंद होने पर, यह वैल्यू एक घंटा हो सकती है. वहीं, पीआईटीआर की सुविधा चालू होने पर, यह वैल्यू सात दिन हो सकती है.

क्लाइंट लाइब्रेरी

  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

पीआईटीआर रीड, सभी Cloud Firestore रीड तरीकों में काम करते हैं. जैसे, get, list, batchGet, listCollectionIds, listDocuments, runQuery, runAggregationQuery, और partitionQuery.

REST के तरीकों का इस्तेमाल करके रीड करने के लिए, इनमें से कोई एक विकल्प आज़माएं:

1. रीड करने के तरीके के अनुरोध में, readOptions तरीके में, readTime वैल्यू को पीआईटीआर के मान्य टाइमस्टैंप के तौर पर पास करें. पीआईटीआर का टाइमस्टैंप, पिछले एक घंटे के अंदर का माइक्रोसेकंड सटीक टाइमस्टैंप या पिछले एक घंटे के बाद का पूरे मिनट का टाइमस्टैंप हो सकता है. हालांकि, यह earliestVersionTime से पहले का नहीं होना चाहिए.

2. एक से ज़्यादा पीआईटीआर रीड के लिए, ReadOnly ट्रांज़ैक्शन के हिस्से के तौर पर, BeginTransaction तरीके के साथ readTime पैरामीटर का इस्तेमाल करें.

Apache Beam

Dataflow की मदद से, बड़े पैमाने पर Cloud Firestore डेटाबेस में दस्तावेज़ पढ़ने या लिखने के लिए, Cloud FirestoreIO Apache Beam कनेक्टर का इस्तेमाल करें.

पीआईटीआर रीड, Cloud FirestoreIO कनेक्टर के इस रीड तरीके में काम करते हैं. इन रीड तरीकों में, withReadTime(@Nullable Instant readTime) तरीका काम करता है. इसका इस्तेमाल पीआईटीआर रीड के लिए किया जा सकता है:

• 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 पाइपलाइन में readTime उदाहरणों की पूरी सूची के लिए, GitHub डेटा स्टोर करने की जगह देखें.

कंसोल

Firebase Console में, डेटाबेस क्लोन करने की सुविधा उपलब्ध नहीं है. डेटाबेस क्लोन करने के लिए, Google Cloud CLI के निर्देशों का इस्तेमाल किया जा सकता है.

gcloud

डेटाबेस क्लोन करने के लिए, gcloud firestore databases clone कमांड का इस्तेमाल करें:

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

इन्हें बदलें:

• SOURCE_DATABASE: किसी मौजूदा डेटाबेस का नाम जिसे आपको क्लोन करना है. नाम, projects/PROJECT_ID/databases/SOURCE_DATABASE_ID फ़ॉर्मैट में होता है.

• PITR_TIMESTAMP: आरएफ़सी 3339 फ़ॉर्मैट में पीआईटीआर का टाइमस्टैंप . इसकी ग्रैन्युलैरिटी एक मिनट होती है . उदाहरण के लिए: 2025-06-01T10:20:00.00Z या 2025-06-01T10:30:00.00-07:00.

• DESTINATION_DATABASE_ID: क्लोन किए गए नए डेटाबेस के लिए डेटाबेस आईडी. यह डेटाबेस आईडी, किसी मौजूदा डेटाबेस से जुड़ा नहीं होना चाहिए.

उदाहरण:

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 फ़्लैग के साथ पिछला कमांड इस्तेमाल करें. यह बाइंड करने के लिए, टैग के KEY=VALUE पेयर की वैकल्पिक सूची होती है.

उदाहरण:

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

डिफ़ॉल्ट रूप से, क्लोन किए गए डेटाबेस का एन्क्रिप्शन कॉन्फ़िगरेशन, सोर्स डेटाबेस के एन्क्रिप्शन कॉन्फ़िगरेशन जैसा ही होगा. एन्क्रिप्शन कॉन्फ़िगरेशन बदलने के लिए, --encryption-type आर्ग्युमेंट का इस्तेमाल करें:

• (डिफ़ॉल्ट) use-source-encryption: सोर्स डेटाबेस के एन्क्रिप्शन कॉन्फ़िगरेशन का इस्तेमाल करें.
• google-default-encryption: Google के डिफ़ॉल्ट एन्क्रिप्शन का इस्तेमाल करें.
• customer-managed-encryption: सीएमईके एन्क्रिप्शन का इस्तेमाल करें. कुंजी आईडी --kms-key-name आर्ग्युमेंट में तय करें.

यहां दिए गए उदाहरण में, क्लोन किए गए डेटाबेस के लिए सीएमईके एन्क्रिप्शन कॉन्फ़िगर करने का तरीका बताया गया है:

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

डेटाबेस क्लोन करने के लिए, firebase firestore:databases:clone कमांड का इस्तेमाल करें:

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

इन्हें बदलें:

• SOURCE_DATABASE: किसी मौजूदा डेटाबेस का नाम जिसे आपको क्लोन करना है. नाम, projects/PROJECT_ID/databases/SOURCE_DATABASE_ID फ़ॉर्मैट में होता है.

• DESTINATION_DATABASE: क्लोन किए गए नए डेटाबेस के लिए डेटाबेस का नाम. नाम, projects/PROJECT_ID/databases/DESTINATION_DATABASE_ID फ़ॉर्मैट में होता है. यह डेटाबेस नाम, किसी मौजूदा डेटाबेस से जुड़ा नहीं होना चाहिए.

• PITR_TIMESTAMP: आरएफ़सी 3339 फ़ॉर्मैट में पीआईटीआर का टाइमस्टैंप . इसकी ग्रैन्युलैरिटी एक मिनट होती है . उदाहरण के लिए: 2025-06-01T10:20:00.00Z या 2025-06-01T10:30:00.00-07:00. अगर इसे तय नहीं किया गया है, तो चुना गया स्नैपशॉट, मौजूदा समय होगा. इसे मिनट में राउंड डाउन किया जाएगा.

डिफ़ॉल्ट रूप से, क्लोन किए गए डेटाबेस का एन्क्रिप्शन कॉन्फ़िगरेशन, सोर्स डेटाबेस के एन्क्रिप्शन कॉन्फ़िगरेशन जैसा ही होगा. एन्क्रिप्शन कॉन्फ़िगरेशन बदलने के लिए, --encryption-type आर्ग्युमेंट का इस्तेमाल करें:

• (डिफ़ॉल्ट) USE_SOURCE_ENCRYPTION: सोर्स डेटाबेस के एन्क्रिप्शन कॉन्फ़िगरेशन का इस्तेमाल करें.
• GOOGLE_DEFAULT_ENCRYPTION: Google के डिफ़ॉल्ट एन्क्रिप्शन का इस्तेमाल करें.
• CUSTOMER_MANAGED_ENCRYPTION: सीएमईके एन्क्रिप्शन का इस्तेमाल करें. कुंजी आईडी --kms-key-name आर्ग्युमेंट में तय करें.

यहां दिए गए उदाहरण में, क्लोन किए गए डेटाबेस के लिए सीएमईके एन्क्रिप्शन कॉन्फ़िगर करने का तरीका बताया गया है:

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