পয়েন্ট-ইন-টাইম রিকভারি (PITR) ব্যবহার করে কাজ করা

কনসোল

1. Google Cloud কনসোলে, ডেটাবেস পৃষ্ঠায় যান।

   ডেটাবেসে যান

2. ডেটাবেসের তালিকা থেকে প্রয়োজনীয় ডেটাবেস বেছে নিন।

3. নেভিগেশন মেনুতে, ডিজাস্টার রিকভারি বিকল্পে ক্লিক করুন।

4. সেটিংস এডিট করতে এডিট করুন বিকল্পে ক্লিক করুন।

5. পয়েন্ট-ইন-টাইম রিকভারি চালু করুন চেকবক্স বেছে নিন এবং তারপরে সেভ করুন বিকল্পে ক্লিক করুন।

PITR চালু করলে স্টোরেজের জন্য খরচ হয়। আরও তথ্যের জন্য দাম দেখুন।

PITR বন্ধ করতে, Google Cloud কনসোলের ডিজাস্টার রিকভারি পৃষ্ঠা থেকে পয়েন্ট-ইন-টাইম রিকভারি চালু করুন চেকবক্স থেকে টিকচিহ্ন সরিয়ে দিন।

gcloud

ডেটাবেস তৈরি করার সময় gcloud firestore databases create ও --enable-ptir কমান্ডের সাহায্যে PITR চালু করুন:

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

নিম্নলিখিতভাবে ভ্যালু পরিবর্তন করুন:

• LOCATION - আপনি যেখানে ডেটাবেস তৈরি করতে চান সেই লোকেশন।
• DATABASE_ID - ডেটাবেসের আইডিতে সেট করা হয়েছে।

আপনি এইভাবে gcloud firestore databases update কমান্ড ব্যবহার করে PITR বন্ধ করতে পারবেন:

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

নিম্নলিখিতভাবে ভ্যালু পরিবর্তন করুন:

• DATABASE_ID - ডেটাবেসের আইডি বা (ডিফল্ট) হিসেবে সেট করা।

কনসোল

1. Google Cloud কনসোলে, ডেটাবেস পৃষ্ঠায় যান।

   ডেটাবেসে যান

2. ডেটাবেসের তালিকা থেকে প্রয়োজনীয় ডেটাবেস বেছে নিন।

3. নেভিগেশন মেনুতে, ডিজাস্টার রিকভারি বিকল্পে ক্লিক করুন।

4. সেটিংস বিভাগে, রিটেনশন পিরিয়ড এবং সবচেয়ে পুরনো ভার্সনের সময় নোট করুন।

   • রিটেনশন পিরিয়ড: যে সময়সীমা পর্যন্ত Cloud Firestore ডেটাবেসের জন্য ডেটার সব ভার্সন রেখে দেয়। PITR বন্ধ থাকলে ভ্যালু এক ঘণ্টা এবং PITR চালু থাকলে সাত দিন হয়।
   • সবচেয়ে পুরনো ভার্সনের সময়: সবচেয়ে পুরনো টাইমস্ট্যাম্প যেখানে ডেটার পুরনো ভার্সন PITR উইন্ডোতে পড়া যাবে। এই ভ্যালু Cloud Firestore-এর মাধ্যমে ক্রমাগত আপডেট করা হয় এবং কোয়েরি করার সাথে সাথেই তা বাসি হয়ে যায়। আপনি যদি ডেটা ফিরিয়ে আনার জন্য এই ভ্যালু ব্যবহার করেন, তাহলে ভ্যালু কোয়েরি করার মুহূর্ত থেকে ফিরিয়ে আনার প্রসেস শুরু করার মুহূর্ত পর্যন্ত সময় হিসেব করতে ভুলবেন না।
   • পয়েন্ট-ইন-টাইম রিকভারি: PITR চালু থাকলে, Enabled দেখায়। PITR বন্ধ করা থাকলে, আপনি 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: সবচেয়ে পুরনো PITR ডেটা স্টোর করার টাইমস্ট্যাম্প।
• pointInTimeRecoveryEnablement: PITR চালু থাকলে, POINT_IN_TIME_RECOVERY_ENABLED দেখায়। PITR বন্ধ করা থাকলে, আপনি হয় POINT_IN_TIME_RECOVERY_DISABLED দেখতে পাবেন অথবা pointInTimeRecoveryEnablement ফিল্ডটি দেখানো নাও হতে পারে।
• versionRetentionPeriod: PITR ডেটা মিলিসেকেন্ডে কতক্ষণ ধরে রাখা হয়। PITR বন্ধ করা থাকলে এই ভ্যালু এক ঘণ্টা হতে পারে অথবা PITR চালু করা থাকলে সাত দিন হতে পারে।

ক্লায়েন্ট লাইব্রেরি

  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 রিড সব Cloud Firestore রিড পদ্ধতিতে কাজ করে, যেগুলি হল get, list, batchGet, listCollectionIds, listDocuments, runQuery, runAggregationQuery এবং partitionQuery।

REST পদ্ধতি ব্যবহার করে পড়তে, নিম্নলিখিত বিকল্পগুলির মধ্যে একটি ব্যবহার করে দেখুন:

1. আপনার রিড মেথড অনুরোধে, readOptions মেথডে কাজ করে এমন PITR টাইমস্ট্যাম্প হিসেবে readTime ভ্যালু পাস করুন। PITR টাইমস্ট্যাম্প হয় গত এক ঘণ্টার মধ্যে মাইক্রোসেকেন্ড প্রিসিশন টাইমস্ট্যাম্প অথবা গত এক ঘণ্টার বাইরে পুরো মিনিটের টাইমস্ট্যাম্প হতে পারে, তবে earliestVersionTime-এর আগে নয়।

2. একাধিক PITR রিডের জন্য ReadOnly ট্রানজ্যাকশনের অংশ হিসেবে BeginTransaction পদ্ধতির সাথে readTime প্যারামিটার ব্যবহার করুন।

Apache Beam

Dataflow-এর মাধ্যমে বড় স্কেলে Cloud Firestore ডেটাবেসে ডকুমেন্ট পড়তে বা লিখতে Cloud FirestoreIO Apache Beam কানেক্টর ব্যবহার করুন।

Cloud FirestoreIO কানেক্টরের নিম্নলিখিত রিড পদ্ধতিতে PITR রিড কাজ করে। এই রিড পদ্ধতি withReadTime(@Nullable Instant readTime) পদ্ধতিকে সাপোর্ট করে যা আপনি PITR রিডের জন্য ব্যবহার করতে পারবেন:

• 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 কনসোলে ডেটাবেস ক্লোন করার সুবিধা নেই। আপনি 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: মিনিট গ্র্যানুলারিটিতে RFC 3339 ফর্ম্যাটে PITR টাইমস্ট্যাম্প। যেমন: 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: CMEK এনক্রিপশন ব্যবহার করুন। --kms-key-name আর্গুমেন্টে কী আইডি উল্লেখ করুন।

ক্লোন করা ডেটাবেসের জন্য CMEK এনক্রিপশন কীভাবে কনফিগার করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

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: মিনিট গ্র্যানুলারিটিতে RFC 3339 ফর্ম্যাটে PITR টাইমস্ট্যাম্প। যেমন: 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: CMEK এনক্রিপশন ব্যবহার করুন। --kms-key-name আর্গুমেন্টে কী আইডি উল্লেখ করুন।

ক্লোন করা ডেটাবেসের জন্য CMEK এনক্রিপশন কীভাবে কনফিগার করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

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