রপ্তানি এবং আমদানি তথ্য

দুর্ঘটনাক্রমে ডেটা মুছে ফেলার ঘটনা পুনরুদ্ধার করতে এবং অফলাইন প্রক্রিয়াকরণের জন্য ডেটা রপ্তানি করতে আপনি Cloud Firestore পরিচালিত রপ্তানি এবং আমদানি পরিষেবা ব্যবহার করতে পারেন। আপনি সমস্ত নথি বা শুধুমাত্র নির্দিষ্ট সংগ্রহ রপ্তানি করতে পারেন। একইভাবে, আপনি একটি রপ্তানি বা শুধুমাত্র নির্দিষ্ট সংগ্রহ থেকে সমস্ত ডেটা আমদানি করতে পারেন। একটি Cloud Firestore ডাটাবেস থেকে রপ্তানি করা ডেটা অন্য Cloud Firestore ডাটাবেসে আমদানি করা যেতে পারে। আপনি Cloud Firestore রপ্তানিগুলি BigQuery এ লোড করতে পারেন।

এই পৃষ্ঠাটি পরিচালিত রপ্তানি এবং আমদানি পরিষেবা এবং Cloud Storage ব্যবহার করে Cloud Firestore ডকুমেন্টগুলি কীভাবে রপ্তানি এবং আমদানি করতে হয় তা বর্ণনা করে। Cloud Firestore পরিচালিত রপ্তানি এবং আমদানি পরিষেবা gcloud কমান্ড-লাইন টুল এবং Cloud Firestore API ( REST , RPC ) এর মাধ্যমে উপলব্ধ।

শুরু করার আগে

পরিচালিত রপ্তানি এবং আমদানি পরিষেবা ব্যবহার করার আগে, আপনাকে নিম্নলিখিত কাজগুলি সম্পন্ন করতে হবে:

1. আপনার Google Cloud প্রোজেক্টের জন্য বিলিং সক্ষম করুন। বিলিং সক্ষম থাকা Google Cloud প্রোজেক্টগুলিই কেবল রপ্তানি এবং আমদানি কার্যকারিতা ব্যবহার করতে পারবে।
2. আপনার Cloud Firestore ডাটাবেস অবস্থানের কাছাকাছি একটি স্থানে আপনার প্রকল্পের জন্য একটি Cloud Storage বাকেট তৈরি করুন । আপনি রপ্তানি এবং আমদানি কার্যক্রমের জন্য একটি অনুরোধকারী পে বাকেট ব্যবহার করতে পারবেন না।

3. নিশ্চিত করুন যে আপনার অ্যাকাউন্টে Cloud Firestore এবং Cloud Storage জন্য প্রয়োজনীয় অনুমতি রয়েছে। আপনি যদি প্রকল্পের মালিক হন, তাহলে আপনার অ্যাকাউন্টে প্রয়োজনীয় অনুমতি রয়েছে। অন্যথায়, নিম্নলিখিত ভূমিকাগুলি রপ্তানি এবং আমদানি কার্যক্রম এবং Cloud Storage অ্যাক্সেসের জন্য প্রয়োজনীয় অনুমতি প্রদান করে:

   • Cloud Firestore ভূমিকা: Owner , Cloud Datastore Owner , অথবা Cloud Datastore Import Export Admin

   • Cloud Storage ভূমিকা: Owner বা Storage Admin

পরিষেবা এজেন্টের অনুমতি

Cloud Storage অপারেশন অনুমোদনের জন্য Cloud Firestore পরিষেবা এজেন্ট ব্যবহার করে রপ্তানি এবং আমদানি কার্যক্রম। Cloud Firestore পরিষেবা এজেন্ট নিম্নলিখিত নামকরণ পদ্ধতি ব্যবহার করে:

Cloud Firestore সার্ভিস এজেন্ট

service- PROJECT_NUMBER @gcp-sa-firestore.iam.gserviceaccount.com

পরিষেবা এজেন্টদের সম্পর্কে আরও জানতে, পরিষেবা এজেন্ট দেখুন।

Cloud Firestore সার্ভিস এজেন্টের রপ্তানি বা আমদানি কার্যক্রমে ব্যবহৃত Cloud Storage বাকেটের অ্যাক্সেস প্রয়োজন। যদি আপনার Cloud Storage বাকেটটি আপনার Cloud Firestore ডাটাবেসের মতো একই প্রকল্পে থাকে, তাহলে Cloud Firestore সার্ভিস এজেন্ট ডিফল্টরূপে বাকেটটি অ্যাক্সেস করতে পারবে ।

যদি Cloud Storage বাকেটটি অন্য কোনও প্রকল্পে থাকে, তাহলে আপনাকে অবশ্যই Cloud Firestore পরিষেবা এজেন্টকে Cloud Storage বাকেটের অ্যাক্সেস দিতে হবে।

পরিষেবা এজেন্টকে ভূমিকা অর্পণ করুন

আপনি gsutil কমান্ড-লাইন টুল ব্যবহার করে নিচের যেকোনো একটি ভূমিকা নির্ধারণ করতে পারেন। উদাহরণস্বরূপ, Cloud Firestore সার্ভিস এজেন্টকে স্টোরেজ অ্যাডমিন ভূমিকা নির্ধারণ করতে, নিম্নলিখিতটি চালান:

gsutil iam ch serviceAccount:service-PROJECT_NUMBER@gcp-sa-firestore.iam.gserviceaccount.com:roles/storage.admin \
    gs://[BUCKET_NAME]

PROJECT_NUMBER এর পরিবর্তে আপনার প্রোজেক্ট নম্বর দিন, যা আপনার Cloud Firestore পরিষেবা এজেন্টের নামকরণের জন্য ব্যবহৃত হয়। পরিষেবা এজেন্টের নাম দেখতে, পরিষেবা এজেন্টের নাম দেখুন ।

বিকল্পভাবে, আপনি Google Cloud কনসোল ব্যবহার করে এই ভূমিকাটি নির্ধারণ করতে পারেন।

পরিষেবা এজেন্টের নাম দেখুন

আপনার আমদানি ও রপ্তানি কার্যক্রম Google ক্লাউড কনসোলের আমদানি/রপ্তানি পৃষ্ঠা থেকে অনুরোধ অনুমোদনের জন্য যে অ্যাকাউন্টটি ব্যবহার করে তা আপনি দেখতে পারেন। আপনার ডাটাবেস Cloud Firestore পরিষেবা এজেন্ট ব্যবহার করে নাকি লিগ্যাসি App Engine পরিষেবা অ্যাকাউন্ট ব্যবহার করে তাও আপনি দেখতে পারেন।

1. "ইম্পোর্ট/এক্সপোর্ট জবস" লেবেল হিসেবে চালানোর পাশে অনুমোদন অ্যাকাউন্টটি দেখুন।

রপ্তানি বা আমদানি কার্যক্রমের জন্য Cloud Storage বাকেট ব্যবহারের জন্য পরিষেবা এজেন্টের Storage Admin ভূমিকা প্রয়োজন।

আপনার প্রকল্পের জন্য gcloud সেট আপ করুন

আপনি গুগল ক্লাউড কনসোল অথবা gcloud কমান্ড-লাইন টুলের মাধ্যমে আমদানি এবং রপ্তানি কার্যক্রম শুরু করতে পারেন। gcloud ব্যবহার করতে, কমান্ড-লাইন টুল সেট আপ করুন এবং নিম্নলিখিত উপায়গুলির মধ্যে একটিতে আপনার প্রকল্পের সাথে সংযোগ করুন:

• Cloud Shell ব্যবহার করে গুগল ক্লাউড প্ল্যাটফর্ম কনসোল থেকে gcloud অ্যাক্সেস করুন।

  Cloud Shell শুরু করুন

  নিশ্চিত করুন যে gcloud সঠিক প্রকল্পের জন্য কনফিগার করা আছে:

  gcloud config set project [PROJECT_ID]
  

• গুগল ক্লাউড এসডিকে ইনস্টল এবং আরম্ভ করুন।

ডেটা রপ্তানি করুন

একটি এক্সপোর্ট অপারেশন আপনার ডাটাবেসের ডকুমেন্টগুলিকে Cloud Storage বাকেটের ফাইলের একটি সেটে কপি করে। মনে রাখবেন যে এক্সপোর্ট হল এক্সপোর্ট শুরুর সময় নেওয়া একটি সঠিক ডাটাবেস স্ন্যাপশট নয়। এক্সপোর্টে অপারেশন চলাকালীন করা পরিবর্তনগুলি অন্তর্ভুক্ত থাকতে পারে।

সমস্ত নথি রপ্তানি করুন

  gcloud firestore export gs://[BUCKET_NAME] \
  --database=[DATABASE]

নির্দিষ্ট সংগ্রহ রপ্তানি করুন

gcloud firestore export gs://[BUCKET_NAME] \
--collection-ids=[COLLECTION_ID_1],[COLLECTION_ID_2],[SUBCOLLECTION_ID_1] \
--database=[DATABASE]

gcloud firestore export gs://[BUCKET_NAME] \
--collection-ids=restaurants,reviews \
--database='cymbal'

PITR টাইমস্ট্যাম্প থেকে রপ্তানি করুন

আপনি PITR ডেটা থেকে আপনার ডাটাবেস Cloud Storage রপ্তানি করতে পারেন। আপনি PITR ডেটা রপ্তানি করতে পারেন যেখানে টাইমস্ট্যাম্পটি গত সাত দিনের মধ্যে পুরো মিনিটের টাইমস্ট্যাম্প, কিন্তু earliestVersionTime এর আগে নয়। যদি নির্দিষ্ট টাইমস্ট্যাম্পে ডেটা আর বিদ্যমান না থাকে, তাহলে রপ্তানি কার্যক্রম ব্যর্থ হয়।

PITR এক্সপোর্ট অপারেশন সমস্ত ফিল্টার সমর্থন করে, যার মধ্যে সমস্ত নথি এক্সপোর্ট করা এবং নির্দিষ্ট সংগ্রহ এক্সপোর্ট করা অন্তর্ভুক্ত।

PITR ডেটা রপ্তানি করার আগে নিম্নলিখিত বিষয়গুলি লক্ষ্য করুন:

• RFC 3339 ফর্ম্যাটে টাইমস্ট্যাম্প নির্দিষ্ট করুন। উদাহরণস্বরূপ, 2023-05-26T10:20:00.00Z ।
• নিশ্চিত করুন যে আপনার নির্দিষ্ট করা টাইমস্ট্যাম্পটি গত সাত দিনের মধ্যে একটি সম্পূর্ণ মিনিটের টাইমস্ট্যাম্প, কিন্তু earliestVersionTime এর আগের নয়। যদি নির্দিষ্ট টাইমস্ট্যাম্পে ডেটা আর বিদ্যমান না থাকে, তাহলে একটি ত্রুটি তৈরি হবে।
• ব্যর্থ PITR রপ্তানির জন্য আপনাকে কোনও চার্জ করা হবে না।

gcloud firestore export gs://[BUCKET_NAME_PATH] \
    --snapshot-time=[PITR_TIMESTAMP]

ডেটা আমদানি করুন

Cloud Storage এক্সপোর্ট ফাইল তৈরি হয়ে গেলে, আপনি সেই ফাইলগুলিতে থাকা ডকুমেন্টগুলি আপনার প্রোজেক্টে বা অন্য প্রোজেক্টে আবার ইমপোর্ট করতে পারবেন। ইমপোর্ট অপারেশন সম্পর্কে নিম্নলিখিত বিষয়গুলি লক্ষ্য করুন:

• যখন আপনি ডেটা আমদানি করেন, তখন আপনার ডাটাবেসের বর্তমান সূচক সংজ্ঞা ব্যবহার করে প্রয়োজনীয় সূচকগুলি আপডেট করা হয়। একটি রপ্তানিতে সূচক সংজ্ঞা থাকে না।

• আমদানিতে নতুন ডকুমেন্ট আইডি বরাদ্দ করা হয় না। আমদানিতে রপ্তানির সময় ক্যাপচার করা আইডি ব্যবহার করা হয়। যখন একটি ডকুমেন্ট আমদানি করা হচ্ছে, তখন আইডি সংঘর্ষ রোধ করার জন্য এর আইডি সংরক্ষিত থাকে। যদি একই আইডি সহ একটি ডকুমেন্ট ইতিমধ্যেই বিদ্যমান থাকে, তাহলে আমদানি বিদ্যমান ডকুমেন্টটিকে ওভাররাইট করে।

• যদি আপনার ডাটাবেসের কোন ডকুমেন্ট আমদানির দ্বারা প্রভাবিত না হয়, তাহলে আমদানির পরেও এটি আপনার ডাটাবেসে থাকবে।

• আমদানি কার্যক্রম ক্লাউড ফাংশনগুলিকে ট্রিগার করে না। স্ন্যাপশট শ্রোতারা আমদানি কার্যক্রম সম্পর্কিত আপডেটগুলি পান।

• .overall_export_metadata ফাইলের নামটি অবশ্যই তার মূল ফোল্ডারের নামের সাথে মিলবে:

  gs://BUCKET_NAME/OPTIONAL_NAMESPACE_PATH/ PARENT_FOLDER_NAME / PARENT_FOLDER_NAME .overall_export_metadata

  যদি আপনি কোন এক্সপোর্টের আউটপুট ফাইলগুলি সরান বা অনুলিপি করেন, তাহলে PARENT_FOLDER_NAME এবং .overall_export_metadata ফাইলের নাম একই রাখুন।

একটি এক্সপোর্ট থেকে সমস্ত নথি আমদানি করুন

gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ --database=[DATABASE]

gcloud firestore import gs://my-bucket/2017-05-25T23:54:39_76544/ --database='cymbal'

নির্দিষ্ট সংগ্রহগুলি আমদানি করুন

  gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ \
  --collection-ids=[COLLECTION_ID_1],[COLLECTION_ID_2],[SUBCOLLECTION_ID_1] \
  --database=[DATABASE]

একটি PITR রপ্তানি আমদানি করুন

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

আমদানি ও রপ্তানি কার্যক্রম পরিচালনা করা

আপনি যখন কোনও রপ্তানি বা আমদানি কার্যক্রম শুরু করেন, তখন Cloud Firestore অপারেশনটিকে একটি অনন্য নাম দেয়। আপনি অপারেশন নামটি ব্যবহার করে অপারেশনটি মুছে ফেলতে, বাতিল করতে বা স্থিতি পরীক্ষা করতে পারেন।

অপারেশনের নামগুলি projects/[PROJECT_ID]/databases/(default)/operations/ এর সাথে পূর্বে যুক্ত করা হয়, উদাহরণস্বরূপ:

projects/my-project/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg

তবে, describe , cancel , এবং delete কমান্ডের জন্য একটি অপারেশন নাম নির্দিষ্ট করার সময় আপনি উপসর্গটি বাদ দিতে পারেন।

সমস্ত রপ্তানি এবং আমদানি কার্যক্রম তালিকাভুক্ত করুন।

gcloud firestore operations list

অপারেশনের অবস্থা পরীক্ষা করুন

gcloud firestore operations describe [OPERATION_NAME]

সমাপ্তির সময় অনুমান করুন

দীর্ঘমেয়াদী অপারেশনের স্থিতির জন্য একটি অনুরোধ workEstimated এবং workCompleted মেট্রিক্স ফেরত পাঠায়। এই প্রতিটি মেট্রিক্স বাইট সংখ্যা এবং সত্তার সংখ্যা উভয় ক্ষেত্রেই ফেরত পাঠানো হয়:

• workEstimated একটি অপারেশন কত বাইট এবং ডকুমেন্ট প্রক্রিয়া করবে তার আনুমানিক সংখ্যা দেখায়। Cloud Firestore যদি অনুমান করতে না পারে তবে এই মেট্রিকটি বাদ দিতে পারে।

• workCompleted এখন পর্যন্ত প্রক্রিয়াকৃত বাইট এবং ডকুমেন্টের সংখ্যা দেখায়। অপারেশন সম্পন্ন হওয়ার পরে, মানটি আসলে প্রক্রিয়াকৃত বাইট এবং ডকুমেন্টের মোট সংখ্যা দেখায়, যা workEstimated এর মানের চেয়ে বেশি হতে পারে।

workCompleted ভাগ করুন workEstimated মাধ্যমে সম্পন্ন একটি মোটামুটি অগ্রগতি অনুমানের জন্য অনুমান করা হয়েছে। এই অনুমানটি ভুল হতে পারে, কারণ এটি বিলম্বিত পরিসংখ্যান সংগ্রহের উপর নির্ভর করে।

একটি অপারেশন বাতিল করুন

gcloud firestore operations cancel [OPERATION_NAME]

একটি চলমান অপারেশন বাতিল করলেও অপারেশনটি পূর্বাবস্থায় ফেরানো হয় না। একটি বাতিল করা এক্সপোর্ট অপারেশন ইতিমধ্যেই Cloud Storage রপ্তানি করা ডকুমেন্টগুলি রেখে দেবে এবং একটি বাতিল করা ইমপোর্ট অপারেশন আপনার ডাটাবেসে ইতিমধ্যেই করা আপডেটগুলি রেখে দেবে। আপনি আংশিকভাবে সম্পন্ন এক্সপোর্ট আমদানি করতে পারবেন না।

একটি অপারেশন মুছে ফেলুন

সাম্প্রতিক ক্রিয়াকলাপের তালিকা থেকে কোনও অপারেশন সরাতে gcloud firestore operations delete কমান্ডটি ব্যবহার করুন। এই কমান্ডটি Cloud Storage থেকে এক্সপোর্ট ফাইলগুলি মুছে ফেলবে না।

gcloud firestore operations delete [OPERATION_NAME]

আমদানি ও রপ্তানি কার্যক্রমের জন্য বিলিং এবং মূল্য নির্ধারণ

পরিচালিত রপ্তানি এবং আমদানি পরিষেবা ব্যবহার করার আগে আপনাকে আপনার Google Cloud প্রকল্পের জন্য বিলিং সক্ষম করতে হবে।

Cloud Firestore মূল্য নির্ধারণে তালিকাভুক্ত হারে ডকুমেন্ট পঠন এবং লেখার জন্য রপ্তানি এবং আমদানি কার্যক্রম চার্জ করা হয়। রপ্তানি কার্যক্রমের জন্য প্রতিটি ডকুমেন্ট রপ্তানি করার জন্য একটি পঠন অপারেশন প্রয়োজন। আমদানি কার্যক্রমের জন্য প্রতিটি ডকুমেন্ট আমদানি করার জন্য একটি লেখা অপারেশন প্রয়োজন।

Cloud Storage সংরক্ষিত আউটপুট ফাইলগুলি আপনার Cloud Storage ডেটা স্টোরেজ খরচের মধ্যে গণনা করা হয়।

এক্সপোর্ট বা ইমপোর্ট অপারেশনগুলি সম্পূর্ণ না হওয়া পর্যন্ত আপনার Google Cloud বাজেট সতর্কতা ট্রিগার করবে না। এক্সপোর্ট এবং ইমপোর্ট অপারেশনগুলি কনসোলের ব্যবহার বিভাগে দেখানো ব্যবহারকে প্রভাবিত করবে না।

রপ্তানি এবং আমদানি খরচ দেখা

রপ্তানি এবং আমদানি কার্যক্রম বিল করা কার্যক্রমের ক্ষেত্রে goog-firestoremanaged:exportimport লেবেল প্রয়োগ করে। ক্লাউড বিলিং রিপোর্ট পৃষ্ঠায় , আপনি আমদানি এবং রপ্তানি কার্যক্রমের সাথে সম্পর্কিত খরচ দেখতে এই লেবেলটি ব্যবহার করতে পারেন:

BigQuery-তে রপ্তানি করুন

আপনি Cloud Firestore এক্সপোর্ট থেকে ডেটা BigQuery তে লোড করতে পারেন, তবে শুধুমাত্র যদি আপনি একটি collection-ids ফিল্টার নির্দিষ্ট করে থাকেন। Cloud Firestore এক্সপোর্ট থেকে ডেটা লোড হচ্ছে দেখুন।

BigQuery কলামের সীমা

BigQuery প্রতি টেবিলে ১০,০০০ কলামের সীমা আরোপ করে। Cloud Firestore এক্সপোর্ট অপারেশন প্রতিটি সংগ্রহ গ্রুপের জন্য একটি BigQuery টেবিল স্কিমা তৈরি করে। এই স্কিমায়, একটি সংগ্রহ গ্রুপের মধ্যে প্রতিটি অনন্য ক্ষেত্রের নাম একটি স্কিমা কলামে পরিণত হয়।

যদি কোনও সংগ্রহ গোষ্ঠীর BigQuery স্কিমা ১০,০০০ কলাম অতিক্রম করে, তাহলে Cloud Firestore এক্সপোর্ট অপারেশন ম্যাপ ফিল্ডগুলিকে বাইট হিসেবে বিবেচনা করে কলামের সীমার মধ্যে থাকার চেষ্টা করে। যদি এই রূপান্তর কলামের সংখ্যা ১০,০০০ এর নিচে নিয়ে আসে, তাহলে আপনি BigQuery এ ডেটা লোড করতে পারবেন, কিন্তু আপনি ম্যাপ ফিল্ডের মধ্যে থাকা সাবফিল্ডগুলিকে কোয়েরি করতে পারবেন না। যদি কলামের সংখ্যা এখনও ১০,০০০ এর বেশি হয়, তাহলে এক্সপোর্ট অপারেশন সংগ্রহ গোষ্ঠীর জন্য একটি BigQuery স্কিমা তৈরি করে না এবং আপনি এর ডেটা BigQuery এ লোড করতে পারবেন না।

ফর্ম্যাট এবং মেটাডেটা ফাইল রপ্তানি করুন

একটি পরিচালিত রপ্তানির আউটপুট LevelDB লগ ফর্ম্যাট ব্যবহার করে।

মেটাডেটা ফাইল

একটি এক্সপোর্ট অপারেশন আপনার নির্দিষ্ট করা প্রতিটি সংগ্রহ গোষ্ঠীর জন্য একটি মেটাডেটা ফাইল তৈরি করে। মেটাডেটা ফাইলগুলিকে সাধারণত ALL_NAMESPACES_KIND_[COLLECTION_GROUP_ID].export_metadata নামে ডাকা হয়।

মেটাডেটা ফাইলগুলি হল প্রোটোকল বাফার এবং আপনি protoc প্রোটোকল কম্পাইলার দিয়ে সেগুলি ডিকোড করতে পারেন। উদাহরণস্বরূপ, আপনি একটি মেটাডেটা ফাইল ডিকোড করতে পারেন যাতে এক্সপোর্ট ফাইলগুলিতে কোন সংগ্রহ গোষ্ঠী রয়েছে তা নির্ধারণ করা যায়:

protoc --decode_raw < export0.export_metadata

সার্ভিস এজেন্ট মাইগ্রেশন

Cloud Firestore App Engine পরিষেবা অ্যাকাউন্ট ব্যবহার করার পরিবর্তে আমদানি এবং রপ্তানি কার্যক্রম অনুমোদনের জন্য একটি Cloud Firestore পরিষেবা এজেন্ট ব্যবহার করে। পরিষেবা এজেন্ট এবং পরিষেবা অ্যাকাউন্ট নিম্নলিখিত নামকরণের নিয়মাবলী ব্যবহার করে:

Cloud Firestore সার্ভিস এজেন্ট

service- PROJECT_NUMBER @gcp-sa-firestore.iam.gserviceaccount.com

Cloud Firestore পূর্বে Cloud Firestore পরিষেবা এজেন্টের পরিবর্তে App Engine ডিফল্ট পরিষেবা অ্যাকাউন্ট ব্যবহার করত। যদি আপনার ডাটাবেস এখনও ডেটা আমদানি বা রপ্তানি করার জন্য App Engine পরিষেবা অ্যাকাউন্ট ব্যবহার করে, তাহলে আমরা আপনাকে Cloud Firestore পরিষেবা এজেন্ট ব্যবহার করে মাইগ্রেট করার জন্য এই বিভাগের নির্দেশাবলী অনুসরণ করার পরামর্শ দিচ্ছি।

App Engine পরিষেবা অ্যাকাউন্ট

PROJECT_ID @appspot.gserviceaccount.com

Cloud Firestore পরিষেবা এজেন্টটি পছন্দনীয় কারণ এটি Cloud Firestore জন্য নির্দিষ্ট। App Engine পরিষেবা অ্যাকাউন্টটি একাধিক পরিষেবা দ্বারা ভাগ করা হয়।

অনুমোদন অ্যাকাউন্ট দেখুন

গুগল ক্লাউড কনসোলের আমদানি/রপ্তানি পৃষ্ঠা থেকে আপনার আমদানি এবং রপ্তানি কার্যক্রম কোন অ্যাকাউন্ট ব্যবহার করে অনুরোধ অনুমোদন করে তা আপনি দেখতে পারবেন। আপনার ডাটাবেস ইতিমধ্যেই Cloud Firestore পরিষেবা এজেন্ট ব্যবহার করে কিনা তাও আপনি দেখতে পারবেন।

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

   ডাটাবেসে যান

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

3. নেভিগেশন মেনুতে, আমদানি/রপ্তানি ক্লিক করুন।

4. "ইম্পোর্ট/এক্সপোর্ট জবস" লেবেল হিসেবে চালানোর পাশে অনুমোদন অ্যাকাউন্টটি দেখুন।

যদি আপনার প্রকল্পটি Cloud Firestore পরিষেবা এজেন্ট ব্যবহার না করে, তাহলে আপনি এই কৌশলগুলির যেকোনো একটি ব্যবহার করে Cloud Firestore পরিষেবা এজেন্টে স্থানান্তর করতে পারেন:

• Cloud Storage বাকেট অনুমতিগুলি পরীক্ষা করে এবং আপডেট করে একটি প্রকল্প স্থানান্তর করুন (প্রস্তাবিত) ।
• প্রতিষ্ঠান-ব্যাপী নীতিগত সীমাবদ্ধতা যোগ করুন যা প্রতিষ্ঠানের মধ্যে সমস্ত প্রকল্পকে প্রভাবিত করে।

এই কৌশলগুলির মধ্যে প্রথমটি পছন্দনীয় কারণ এটি একটি একক Cloud Firestore প্রকল্পের প্রভাবের সুযোগকে স্থানীয়করণ করে। দ্বিতীয় কৌশলটি পছন্দনীয় নয় কারণ এটি বিদ্যমান Cloud Storage বাকেট অনুমতিগুলিকে স্থানান্তর করে না। তবে, এটি প্রতিষ্ঠানের স্তরে সুরক্ষা সম্মতি প্রদান করে।

Cloud Storage বাকেট অনুমতিগুলি পরীক্ষা করে এবং আপডেট করে মাইগ্রেট করুন

মাইগ্রেশন প্রক্রিয়ার দুটি ধাপ রয়েছে:

1. Cloud Storage বাকেটের অনুমতি আপডেট করুন। বিস্তারিত জানার জন্য নিম্নলিখিত বিভাগটি দেখুন।
2. Cloud Firestore পরিষেবা এজেন্টে স্থানান্তর নিশ্চিত করুন।

সার্ভিস এজেন্ট বাকেট অনুমতি

অন্য কোনও প্রকল্পে Cloud Storage বাকেট ব্যবহার করে যে কোনও রপ্তানি বা আমদানি কার্যক্রমের জন্য, আপনাকে অবশ্যই Cloud Firestore পরিষেবা এজেন্টকে সেই বাকেটের জন্য অনুমতি দিতে হবে। উদাহরণস্বরূপ, অন্য কোনও প্রকল্পে ডেটা স্থানান্তরিত করার জন্য সেই অন্য প্রকল্পের একটি বাকেট অ্যাক্সেস করতে হবে। অন্যথায়, Cloud Firestore পরিষেবা এজেন্টে স্থানান্তরিত হওয়ার পরে এই কার্যক্রমগুলি ব্যর্থ হয়।

একই প্রকল্পের মধ্যে থাকা আমদানি এবং রপ্তানি কর্মপ্রবাহের জন্য অনুমতি পরিবর্তনের প্রয়োজন হয় না। Cloud Firestore পরিষেবা এজেন্ট ডিফল্টরূপে একই প্রকল্পের বাকেট অ্যাক্সেস করতে পারে।

অন্যান্য প্রকল্প থেকে Cloud Storage বাকেটের জন্য অনুমতি আপডেট করুন যাতে service- PROJECT_NUMBER @gcp-sa-firestore.iam.gserviceaccount.com পরিষেবা এজেন্ট। পরিষেবা এজেন্টকে Firestore Service Agent ভূমিকা প্রদান করুন।

Firestore Service Agent ভূমিকা Cloud Storage বাকেটের জন্য পড়ার এবং লেখার অনুমতি দেয়। যদি আপনার কেবল পড়ার বা কেবল লেখার অনুমতি দেওয়ার প্রয়োজন হয়, তাহলে একটি কাস্টম ভূমিকা ব্যবহার করুন।

নিম্নলিখিত বিভাগে বর্ণিত মাইগ্রেশন প্রক্রিয়া আপনাকে Cloud Storage বাকেটগুলি সনাক্ত করতে সাহায্য করবে যার জন্য অনুমতি আপডেটের প্রয়োজন হতে পারে।

ফায়ারস্টোর সার্ভিস এজেন্টের কাছে একটি প্রকল্প স্থানান্তর করুন

App Engine পরিষেবা অ্যাকাউন্ট থেকে Cloud Firestore পরিষেবা এজেন্টে স্থানান্তর করতে নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন। একবার সম্পন্ন হলে, স্থানান্তরটি পূর্বাবস্থায় ফেরানো যাবে না।

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

   ডাটাবেসে যান

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

3. নেভিগেশন মেনুতে, আমদানি/রপ্তানি ক্লিক করুন।

4. যদি আপনার প্রকল্পটি এখনও Cloud Firestore পরিষেবা এজেন্টে স্থানান্তরিত না হয়, তাহলে আপনি মাইগ্রেশন বর্ণনা করে একটি ব্যানার এবং একটি চেক বাকেট স্ট্যাটাস বোতাম দেখতে পাবেন। পরবর্তী পদক্ষেপটি আপনাকে সম্ভাব্য অনুমতি ত্রুটিগুলি সনাক্ত করতে এবং ঠিক করতে সহায়তা করবে।

   বাকেট স্ট্যাটাস চেক করুন এ ক্লিক করুন।

   আপনার মাইগ্রেশন সম্পূর্ণ করার বিকল্প এবং Cloud Storage বাকেটের একটি তালিকা সহ একটি মেনু প্রদর্শিত হবে। তালিকাটি লোড হতে কয়েক মিনিট সময় লাগতে পারে।

   এই তালিকায় এমন বাকেট রয়েছে যা সম্প্রতি আমদানি ও রপ্তানি কার্যক্রমে ব্যবহৃত হয়েছে, কিন্তু বর্তমানে Cloud Firestore পরিষেবা এজেন্টকে পঠন এবং লেখার অনুমতি দেয় না।

5. আপনার প্রকল্পের Cloud Firestore পরিষেবা এজেন্টের মূল নামটি লক্ষ্য করুন। লেবেলে অ্যাক্সেস দেওয়ার জন্য পরিষেবা এজেন্টের নামটি পরিষেবা এজেন্টের নীচে প্রদর্শিত হবে।

6. তালিকার যেকোনো বাকেটের জন্য যা আপনি ভবিষ্যতে আমদানি বা রপ্তানি কার্যক্রমের জন্য ব্যবহার করবেন, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

   1. এই বাকেটের টেবিল সারিতে, Fix এ ক্লিক করুন। এটি একটি নতুন ট্যাবে সেই বাকেটের অনুমতি পৃষ্ঠাটি খুলবে।

   2. যোগ করুন ক্লিক করুন।
   3. নতুন প্রিন্সিপালস ক্ষেত্রে, আপনার Cloud Firestore পরিষেবা এজেন্টের নাম লিখুন।
   4. "একটি ভূমিকা নির্বাচন করুন" ক্ষেত্রে, পরিষেবা এজেন্ট > ফায়ারস্টোর পরিষেবা এজেন্ট নির্বাচন করুন।
   5. সংরক্ষণ করুন ক্লিক করুন।
   6. Cloud Firestore আমদানি/রপ্তানি পৃষ্ঠা সহ ট্যাবে ফিরে যান।
   7. তালিকার অন্যান্য বাকেটের জন্য এই ধাপগুলি পুনরাবৃত্তি করুন। তালিকার সমস্ত পৃষ্ঠা দেখতে ভুলবেন না।

7. "মাইগ্রেট টু ফায়ারস্টোর সার্ভিস এজেন্ট" এ ক্লিক করুন। যদি আপনার এখনও অনুমতি পরীক্ষায় ব্যর্থতার বাকেট থাকে, তাহলে আপনাকে "মাইগ্রেট" এ ক্লিক করে আপনার মাইগ্রেশন নিশ্চিত করতে হবে।

   আপনার মাইগ্রেশন সম্পূর্ণ হলে একটি সতর্কতা আপনাকে জানিয়ে দেবে। মাইগ্রেশন পূর্বাবস্থায় ফেরানো যাবে না।

মাইগ্রেশন স্ট্যাটাস দেখুন

আপনার প্রকল্পের মাইগ্রেশন স্ট্যাটাস যাচাই করতে:

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

   ডাটাবেসে যান

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

3. নেভিগেশন মেনুতে, আমদানি/রপ্তানি ক্লিক করুন।

4. লেবেল হিসেবে চালানো আমদানি/রপ্তানি কাজের পাশে মূল অক্ষরটি খুঁজুন।

   যদি প্রিন্সিপালটি service- PROJECT_NUMBER @gcp-sa-firestore.iam.gserviceaccount.com হয়, তাহলে আপনার প্রকল্পটি ইতিমধ্যেই Cloud Firestore পরিষেবা এজেন্টে স্থানান্তরিত হয়েছে। স্থানান্তরটি পূর্বাবস্থায় ফেরানো যাবে না।

   যদি প্রকল্পটি স্থানান্তরিত না হয়ে থাকে, তাহলে পৃষ্ঠার উপরে একটি ব্যানার প্রদর্শিত হবে যেখানে "চেক বাকেট স্ট্যাটাস" বোতাম থাকবে। স্থানান্তর সম্পূর্ণ করতে "ফায়ারস্টোর সার্ভিস এজেন্টে মাইগ্রেট করুন" দেখুন।

একটি প্রতিষ্ঠান-ব্যাপী নীতিগত সীমাবদ্ধতা যোগ করুন

• আপনার প্রতিষ্ঠানের নীতিতে নিম্নলিখিত সীমাবদ্ধতাগুলি সেট করুন:

  আমদানি/রপ্তানির জন্য ফায়ারস্টোর সার্ভিস এজেন্ট প্রয়োজন ( firestore.requireP4SAforImportExport )।

  এই সীমাবদ্ধতার জন্য অনুরোধ অনুমোদনের জন্য Cloud Firestore পরিষেবা এজেন্ট ব্যবহার করে আমদানি এবং রপ্তানি কার্যক্রম পরিচালনা করতে হবে। এই সীমাবদ্ধতা সেট করতে, প্রতিষ্ঠানের নীতি তৈরি এবং পরিচালনা দেখুন।

এই সাংগঠনিক নীতিগত সীমাবদ্ধতা প্রয়োগ করলে Cloud Firestore পরিষেবা এজেন্টের জন্য উপযুক্ত Cloud Storage বাকেট অনুমতি স্বয়ংক্রিয়ভাবে মঞ্জুর হয় না।

যদি কোনও আমদানি বা রপ্তানি কর্মপ্রবাহের জন্য সীমাবদ্ধতা অনুমতি ত্রুটি তৈরি করে, তাহলে আপনি ডিফল্ট পরিষেবা অ্যাকাউন্ট ব্যবহার করে ফিরে যেতে এটি অক্ষম করতে পারেন। Cloud Storage বাকেট অনুমতিগুলি পরীক্ষা এবং আপডেট করার পরে, আপনি আবার সীমাবদ্ধতা সক্ষম করতে পারেন।