ডাটাবেস পরিচালনা করুন

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

(default) ডাটাবেস

আপনি যদি কোনো ডেটাবেস নির্দিষ্ট না করেন, তাহলে Cloud Firestore ক্লায়েন্ট লাইব্রেরি এবং গুগল ক্লাউড সিএলআই ডিফল্টরূপে (default) ডেটাবেসের সাথে সংযোগ স্থাপন করে।

প্রয়োজনীয় ভূমিকা

ডাটাবেস তৈরি ও পরিচালনা করার জন্য আপনার Owner অথবা Datastore Owner Identity and Access Management রোলটি প্রয়োজন। এই রোলগুলো প্রয়োজনীয় অনুমতি প্রদান করে।

প্রয়োজনীয় অনুমতি

ডাটাবেস পরিচালনা করার জন্য আপনার নিম্নলিখিত অনুমতিগুলো প্রয়োজন:

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

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

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

firebase firestore:databases:create DATABASE_ID \
--location=LOCATION \
[--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
}

ডাটাবেস আইডি

বৈধ ডাটাবেস আইডিগুলোর মধ্যে রয়েছে (default) এবং নিম্নলিখিত শর্ত পূরণকারী আইডিগুলো:

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

যদি আপনি কোনো ডেটাবেস মুছে ফেলেন, তাহলে ৫ মিনিট অতিবাহিত না হওয়া পর্যন্ত আপনি তাৎক্ষণিকভাবে ডেটাবেস আইডিটি পুনরায় ব্যবহার করতে পারবেন না।

সুরক্ষা মুছুন

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

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

আপনার প্রতিটি ডেটাবেসে Cloud Firestore Security Rules প্রয়োগ করতে Firebase সিএলআই (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) ডেটা ব্যবহার করে। ক্লোন করা ডেটাবেসে সমস্ত ডেটা এবং ইনডেক্স অন্তর্ভুক্ত থাকে।

• ডিফল্টরূপে, ক্লোন করা ডেটাবেসটি সোর্স ডেটাবেসের মতোই এনক্রিপ্ট করা হবে, যেখানে গুগলের ডিফল্ট এনক্রিপশন অথবা 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) ব্যবহার করা হয়েছে। এছাড়াও আপনি গুগল ক্লাউড কনসোলে আইএএম (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 : একটি ইমেল ঠিকানা যা একটি নির্দিষ্ট গুগল অ্যাকাউন্টকে প্রতিনিধিত্ব করে। উদাহরণস্বরূপ, 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 : একটি ইমেল ঠিকানা যা একটি নির্দিষ্ট গুগল অ্যাকাউন্টকে প্রতিনিধিত্ব করে। উদাহরণস্বরূপ, 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 : একটি ইমেল ঠিকানা যা একটি নির্দিষ্ট গুগল অ্যাকাউন্টকে প্রতিনিধিত্ব করে। উদাহরণস্বরূপ, alice@example.com ।

ক্লাউড মনিটরিং

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

• firestore.googleapis.com/Database
• ফায়ারস্টোর_ইনস্ট্যান্স (লেগ্যাসি)

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

সীমাবদ্ধতা

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

এরপর কী?

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