ডেটাবেস ম্যানেজ করুন

এই পৃষ্ঠায় Cloud Firestore ডেটাবেস কীভাবে তৈরি, আপডেট ও মুছে ফেলতে হয় তা বর্ণনা করা হয়েছে। আপনি প্রোজেক্ট পিছু একাধিক Cloud Firestore ডেটাবেস তৈরি করতে পারবেন। আপনি প্রোডাকশন ও টেস্টিং এনভায়রনমেন্ট সেট-আপ করতে, গ্রাহক ডেটা আলাদা করতে এবং ডেটা রিজিওনালাইজেশনের জন্য একাধিক ডেটাবেস ব্যবহার করতে পারবেন।

প্রয়োজনীয় ভূমিকা ও অনুমতি

ডেটাবেস তৈরি ও ম্যানেজ করতে, আপনার নিম্নলিখিত পরিচয় ও অ্যাক্সেস ম্যানেজমেন্ট ভূমিকা থাকতে হবে:

• Cloud Datastore-এর মালিক (roles/datastore.owner)

এই ভূমিকাটি নিম্নলিখিত অনুমতিগুলি প্রদান করে যা আপনাকে ডেটাবেস তৈরি এবং পরিচালনা করতে হবে:

• ডেটাবেস তৈরি করুন: datastore.databases.create
• ডেটাবেস কনফিগারেশন পড়ুন: datastore.databases.getMetadata
• ডেটাবেস কনফিগার করুন: datastore.databases.update
• ডেটাবেস মুছুন: datastore.databases.delete
• ডেটাবেস ক্লোন করুন: datastore.databases.clone

একটি ডেটাবেস তৈরি করুন

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

firebase firestore:databases:create DATABASE_ID \n--location=LOCATION \n[--edition EDITION] \n[--firestore-data-access FIRESTORE_ACCESS] \n[--realtime-updates REALTIME_UPDATES] \n[--delete-protection DELETE_PROTECTION_ENABLEMENT]

resource "google_firestore_database" "database" {
  project     = "project-id"
  name        = DATABASE_ID
  location_id = LOCATION
  type        = DATABASE_TYPE

  // Optional
  delete_protection_state = DELETE_PROTECTION_STATE
}

ডেটাবেসের আইডি

সঠিক ডেটাবেস আইডিকে অবশ্যই এইসব নিয়ম মেনে চলতে হবে:

• শুধুমাত্র অক্ষর, সংখ্যা ও হাইফেন (-) অক্ষর যোগ করুন।
• অক্ষরগুলি ছোট হাতের হতে হবে।
• প্রথম অক্ষরটি অবশ্যই একটি বর্ণ হতে হবে।
• শেষ অক্ষরটি অবশ্যই কোনও বর্ণ বা সংখ্যা হতে হবে।
• কমপক্ষে ৪টি অক্ষর।
• সর্বাধিক ৬৩ অক্ষরের মধ্যে লিখতে হবে।
• UUID বা UUID-এর মতো দেখতে কোনও আইডি ব্যবহার করা যাবে না। যেমন, f47ac10b-58cc-0372-8567-0e02b2c3d479-এর মতো আইডি ব্যবহার করবেন না।

এইসব নিয়মের ক্ষেত্রে একটি ব্যতিক্রম আছে: আপনি নিজে কোনও আইডি না লিখলে, স্ট্যান্ডার্ড এডিশন (default) নামের একটি ডেটাবেস তৈরি করবে।

মনে রাখবেন, কোনও ডেটাবেস মুছে দেওয়ার পরে, আপনি প্রায় ৫ মিনিটের জন্য এটির আইডি আবার ব্যবহার করতে পারবেন না।

সুরক্ষা মুছে দিন

কোনও ডেটাবেস ভুলবশত মুছে ফেলা আটকাতে, 'মুছে ফেলা থেকে সুরক্ষা' ফিচার ব্যবহার করুন। 'মুছে ফেলা থেকে সুরক্ষা' ফিচার চালু করা থাকলে, আপনি কোনও ডেটাবেস মুছে ফেলতে পারবেন না। এটি করতে হলে, আপনাকে প্রথমে 'মুছে ফেলা থেকে সুরক্ষা' ফিচার বন্ধ করতে হবে। ডিফল্ট হিসেবে মুছে ফেলা থেকে সুরক্ষা বন্ধ করা থাকে। মুছে দেওয়া থেকে সুরক্ষা চালু বা বন্ধ করতে আপনি ডেটাবেস কনফিগারেশন আপডেট করতে পারবেন।

আপনার ডেটাবেসের জন্য Cloud Firestore Security Rules সেট-আপ করুন

আপনার প্রতিটি ডেটাবেসে Cloud Firestore Security Rules ডেপ্লয় করতে Firebase CLI ব্যবহার করুন। Cloud Firestore Security Rules ম্যানেজ ও ডিপ্লয় করার গাইড দেখুন।

ক্লায়েন্ট লাইব্রেরির মাধ্যমে নাম দেওয়া ডেটাবেস অ্যাক্সেস করুন

নামযুক্ত ডেটাবেসে (default) নাম নেই এমন যেকোনও ডেটাবেস অন্তর্ভুক্ত থাকে। ডিফল্ট হিসেবে, Firebase SDK এবং Google API ক্লায়েন্ট লাইব্রেরি কোনও প্রোজেক্টের (default) Cloud Firestore ডেটাবেসের সাথে কানেক্ট করে। নাম আছে এমন ডেটাবেসের সাথে কানেক্ট করা ক্লায়েন্ট তৈরি করতে, আপনি ক্লায়েন্ট ইনস্ট্যান্টিয়েট করার সময় ডেটাবেসের আইডি সেট করুন।

ডেটাবেসের তালিকা

আপনার ডেটাবেসের তালিকা তৈরি করতে নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করুন:

gcloud firestore databases list

firebase firestore:databases:list

ডেটাবেসের বিবরণ দেখুন

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

gcloud firestore databases describe --database=DATABASE_ID

firebase firestore:databases:get DATABASE_ID

DATABASE_ID-এর পরিবর্তে ডেটাবেসের আইডি লিখুন।

ডেটাবেস কনফিগারেশন আপডেট করুন

কোনও ডেটাবেসের কনফিগারেশন সেটিংস আপডেট করতে, gcloud firestore databases update কমান্ড ব্যবহার করুন। মুছে ফেলার সুরক্ষা চালু বা বন্ধ করতে এই কমান্ড ব্যবহার করুন।

মুছে ফেলা থেকে সুরক্ষা সংক্রান্ত সেটিং আপডেট করুন

কোনও ডেটাবেসে মুছে ফেলা সংক্রান্ত সুরক্ষা চালু করতে, --delete-protection ফ্ল্যাগ সহ gcloud firestore databases update কমান্ড ব্যবহার করুন। যেমন:

gcloud firestore databases update --database=DATABASE_ID --delete-protection

DATABASE_ID-এর পরিবর্তে ডেটাবেসের আইডি লিখুন।

কোনও ডেটাবেসে মুছে ফেলার সুরক্ষা বন্ধ করতে, --no-delete-protection ফ্ল্যাগ সহ gcloud firestore databases update কমান্ড ব্যবহার করুন। যেমন:

gcloud firestore databases update --database=DATABASE_ID --no-delete-protection

DATABASE_ID-এর পরিবর্তে ডেটাবেসের আইডি লিখুন।

ডেটাবেস মুছে দেওয়া

ডেটাবেস মুছে ফেলতে, কনসোল বা কমান্ড-লাইন টুল ব্যবহার করুন।

ডেটাবেসে মুছে ফেলা থেকে সুরক্ষা সেটিং চালু করা থাকলে, আপনাকে প্রথমে মুছে ফেলা থেকে সুরক্ষা বন্ধ করতে হবে।

ডেটাবেসে App Engine সার্চ ডেটা বা ব্লব এনটিটি থাকলে, আপনাকে প্রথমে সেই ডেটা মুছে ফেলতে হবে।

কোনও ডেটাবেস মুছে দিলে, সেই ডেটাবেসের জন্য কোনও Eventarc ট্রিগার অটোমেটিক মুছে যায় না। ট্রিগার ইভেন্ট ডেলিভার করা বন্ধ করে দেয়, তবে আপনি ট্রিগার মুছে না দেওয়া পর্যন্ত এটি থেকে যায়।

ডেটাবেস মুছে ফেলার জন্য কোনও চার্জ নেওয়া হয় না।

gcloud firestore databases delete --database=DATABASE_ID

ডেটাবেস ক্লোন করা

আপনি একটি নতুন ডেটাবেসে বেছে নেওয়া টাইমস্ট্যাম্পে আগে থেকে থাকা ডেটাবেস ক্লোন করতে পারবেন:

• ক্লোন করা ডেটাবেস হল একটি নতুন ডেটাবেস যা সোর্স ডেটাবেসের মতো একই লোকেশনে তৈরি করা হবে।

  ক্লোন তৈরি করতে, Cloud Firestore সোর্স ডেটাবেসের পয়েন্ট-ইন-টাইম রিকভারি (PITR) ডেটা ব্যবহার করে। ক্লোন করা ডেটাবেসে সব ডেটা ও ইনডেক্স অন্তর্ভুক্ত থাকে।

• ডিফল্ট হিসেবে, ক্লোন করা ডেটাবেস সোর্স ডেটাবেসের মতোই এনক্রিপ্ট করা হবে, Google-এর ডিফল্ট এনক্রিপশন বা CMEK এনক্রিপশন ব্যবহার করে। আপনি অন্য এনক্রিপশন টাইপ নির্দিষ্ট করতে পারেন অথবা CMEK এনক্রিপশনের জন্য অন্য কী ব্যবহার করতে পারেন।

• টাইমস্ট্যাম্পে এক মিনিটের গ্র্যানুলারিটি থাকে এবং এটি অতীতের একটি নির্দিষ্ট সময়কে উল্লেখ করে, যা PITR উইন্ডো দ্বারা নির্ধারিত সময়সীমার মধ্যে পড়ে:

  • আপনার ডেটাবেসের জন্য PITR চালু করা থাকলে, আপনি গত ৭ দিনের (বা PITR ৭ দিনের কম সময় আগে চালু করা হলে, সেই সময়সীমার মধ্যে) যেকোনও মিনিট বেছে নিতে পারবেন।
  • PITR চালু করা না থাকলে, আপনি গত এক ঘণ্টার মধ্যে যেকোনও মিনিট বেছে নিতে পারবেন।
  • আপনি আপনার ডেটাবেসের বিবরণ থেকে বেছে নিতে পারেন এমন সবচেয়ে পুরনো টাইমস্ট্যাম্প চেক করতে পারবেন।

gcloud firestore databases clone \
--source-database='SOURCE_DATABASE' \
--snapshot-time='PITR_TIMESTAMP' \
--destination-database='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'

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

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 firestore:databases:clone \
'SOURCE_DATABASE' \
'DESTINATION_DATABASE' \
--snapshot-time 'PITR_TIMESTAMP'

প্রতিটি ডেটাবেসের জন্য অ্যাক্সেস সংক্রান্ত অনুমতি কনফিগার করুন

আপনি পরিচয় এবং অ্যাক্সেস ম্যানেজমেন্ট শর্তাবলী ব্যবহার করে প্রতি-ডেটাবেস লেভেলে অ্যাক্সেসের অনুমতি কনফিগার করতে পারেন। নিম্নলিখিত উদাহরণগুলি এক বা একাধিক ডেটাবেসের জন্য শর্তসাপেক্ষ অ্যাক্সেস অ্যাসাইন করতে Google Cloud CLI ব্যবহার করে। এছাড়াও, আপনি Google Cloud কনসোলে IAM শর্তাবলী নির্ধারণ করতে পারবেন।

আগে থেকে থাকা IAM নীতি দেখুন

gcloud projects get-iam-policy PROJECT_ID

আপনার প্রোজেক্ট আইডিতে PROJECT_ID সেট করুন।

ডেটাবেসে অ্যাক্সেস মঞ্জুর করা

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name=="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

নিম্নলিখিতগুলি সেট করুন:

• PROJECT_ID: আপনার প্রোজেক্ট আইডি
• EMAIL: একটি ইমেল আইডি যা নির্দিষ্ট Google অ্যাকাউন্টকে বোঝায়। যেমন, alice@example.com।
• DATABASE_ID: ডেটাবেসের আইডি।
• TITLE: এক্সপ্রেশনের জন্য ঐচ্ছিক শীর্ষক।
• DESCRIPTION: এক্সপ্রেশনের ঐচ্ছিক বিবরণ।

একটি ডেটাবেস বাদে সব ডেটাবেসে অ্যাক্সেস দিন

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name!="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

নিম্নলিখিতগুলি সেট করুন:

• PROJECT_ID: আপনার প্রোজেক্ট আইডি
• EMAIL: একটি ইমেল আইডি যা নির্দিষ্ট Google অ্যাকাউন্টকে বোঝায়। যেমন, alice@example.com।
• DATABASE_ID: ডেটাবেসের আইডি।
• TITLE: এক্সপ্রেশনের জন্য ঐচ্ছিক শীর্ষক।
• DESCRIPTION: এক্সপ্রেশনের ঐচ্ছিক বিবরণ।

প্রদত্ত মেম্বার ও ভূমিকার জন্য নীতি সরান

gcloud projects remove-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' --all

নিম্নলিখিতগুলি সেট করুন:

• PROJECT_ID: আপনার প্রোজেক্ট আইডি
• EMAIL: একটি ইমেল আইডি যা নির্দিষ্ট Google অ্যাকাউন্টকে প্রতিনিধিত্ব করে। যেমন, alice@example.com।

Cloud মনিটরিং

দুটি মনিটর করা রিসোর্সের অধীনে Cloud Firestoreটি মেট্রিক রিপোর্ট করা হয়েছে।

• firestore.googleapis.com/Database
• firestore_instance(লিগ্যাসি)

আপনি firestore.googleapis.com/Database-এ দেখে ডেটাবেস লেভেলে মোট মেট্রিক চেক করতে পারবেন। firestore_instance-এর অধীনে রিপোর্ট করা মেট্রিক প্রোজেক্ট লেভেলে একত্রিত করা হয়।

সীমাবদ্ধতা

• প্রতি প্রোজেক্টে সর্বাধিক ১০০টি ডেটাবেস থাকতে পারে। এই সীমা বাড়ানোর অনুরোধ করতে আপনি সহায়তা টিমের সাথে যোগাযোগ করতে পারেন।
• আপনার (default) ডেটাবেসে কোনও GAE সার্চ ডেটা থাকলে, আপনি সেটি মুছতে পারবেন না। GAE সার্চ ডেটা মুছে ফেলতে index delete api ব্যবহার করুন। আপনি সম্প্রতি GAE Search ডেটা মুছে থাকলে, ডেটাবেস মুছে ফেলার আগে আপনাকে হয়ত অপেক্ষা করতে হবে।
• আপনার (default) ডেটাবেসে কোনও ব্লব এনটিটি থাকলে, আপনি সেটি মুছতে পারবেন না। Blobstore ডেটা মুছে ফেলতে Blobstore delete api ব্যবহার করুন। আপনার (default) ডেটাবেসে Blobstore ডেটা আছে কিনা তা চেক করতে, Google Cloud কনসোলে নিম্নলিখিত GQL কোয়েরি রান করুন: SELECT * FROM __BlobInfo__।
• ডেটাবেসের আইডি মুছে দেওয়ার ৫ মিনিট পরে আপনি সেটি আবার ব্যবহার করতে পারবেন।
• Cloud Function v1-এ Firestore Named ডেটাবেস কাজ করে না। নামযুক্ত ডেটাবেসের জন্য ইভেন্ট কনফিগার করতে Cloud Firestore Triggers (2nd Gen) ব্যবহার করুন।
• Firestore ফাংশন ট্রিগার v1 এবং Firestore ইভেন্ট ট্রিগার ডেটাবেস মুছে ফেলার পরে কাজ করা বন্ধ করে দিতে পারে, এমনকি একই নামে একটি নতুন ডেটাবেস তৈরি করা হলেও।

এর পরে কী করতে হবে

• ডেটা যোগ করুন
• ডেটা পান
• ডেটা মুছুন