ক্লাউড ফায়ারস্টোর এন্টারপ্রাইজ সংস্করণের সূচী সম্পর্কে আরও জানতে, সূচীর ওভারভিউ দেখুন।
শুরু করার আগে
Cloud Firestore একটি সূচক তৈরি করার আগে, নিশ্চিত করুন যে আপনাকে নিম্নলিখিত ভূমিকাগুলির মধ্যে যেকোনো একটি অর্পণ করা হয়েছে:
-
roles/datastore.owner -
roles/datastore.indexAdmin -
roles/editor -
roles/owner
একটি ভূমিকা প্রদান করতে, একটি একক ভূমিকা প্রদান দেখুন। Cloud Firestore ভূমিকা এবং সংশ্লিষ্ট অনুমতি সম্পর্কে আরও তথ্যের জন্য, পূর্বনির্ধারিত ভূমিকা দেখুন।
যদি আপনার কাস্টম ভূমিকা সংজ্ঞায়িত থাকে, তাহলে সূচী তৈরি করার জন্য নিম্নলিখিত সমস্ত অনুমতি বরাদ্দ করুন:
-
datastore.indexes.create -
datastore.indexes.delete -
datastore.indexes.get -
datastore.indexes.list -
datastore.indexes.update
একটি সূচক তৈরি করুন
একটি সূচক তৈরি করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:
Firebase কনসোল
Firebase কনসোলে, ফায়ারস্টোর ডাটাবেস পৃষ্ঠায় যান।
- ডাটাবেসের তালিকা থেকে একটি ডাটাবেস নির্বাচন করুন।
- ইনডেক্স ট্যাবে, ইনডেক্স তৈরি করুন এ ক্লিক করুন।
- একটি সংগ্রহ আইডি লিখুন।
- এক বা একাধিক ফিল্ড পাথ যোগ করুন এবং প্রতিটির জন্য একটি সূচক বিকল্প নির্বাচন করুন।
- একটি ক্ষেত্রের উপস্থিতি বিকল্প নির্বাচন করুন, হয় অ-বিচ্ছিন্ন অথবা বিচ্ছিন্ন।
- তৈরি করুন ক্লিক করুন।
- আপনার নতুন সূচী সূচকের তালিকায় প্রদর্শিত হবে এবং Cloud Firestore আপনার সূচী তৈরি করা শুরু করবে। আপনার সূচী তৈরি হয়ে গেলে, আপনি সূচীর পাশে একটি সবুজ চেক চিহ্ন দেখতে পাবেন। যদি সূচী তৈরি না করা হয়, তাহলে সম্ভাব্য কারণগুলির জন্য সূচী তৈরির ত্রুটিগুলি দেখুন।
gcloud CLI
একটি সূচক তৈরি করতে, gcloud firestore indexes composite create কমান্ডটি ব্যবহার করুন।
gcloud firestore indexes composite create \ --database='DATABASE_ID' \ --collection-group=COLLECTION \ --field-config=FIELD_CONFIGURATION \ --query-scope=collection-group \ --density=dense
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
- DATABASE_ID : একটি ডাটাবেস আইডি।
- COLLECTION : একটি সংগ্রহের নাম।
- FIELD_CONFIGURATION : একটি ফিল্ড কনফিগারেশন। প্রতিটি ফিল্ডের জন্য,
--field-config=field-path=যোগ করুন। উদাহরণস্বরূপ:--field-config=field-path=user-id,order=descending \ --field-config=field-path=score,order=descendingএই ক্ষেত্রগুলি কনফিগার করার বিষয়ে আরও তথ্যের জন্য,
--field-configদেখুন।
একটি স্পার্স ইনডেক্স তৈরি করতে, --density=sparse-any সেট করুন।
একটি অনন্য সূচক তৈরি করতে, --unique পতাকা যোগ করুন।
টেরাফর্ম
google_firestore_index রিসোর্সটি ব্যবহার করুন।
resource "google_firestore_index" "index" { database = "DATABASE_ID" collection = "COLLECTION" query_scope = "COLLECTION_GROUP" // You can include multiple field blocks fields { field_path = "FIELD_PATH" order = "ORDER" } // Optional multikey = true density = "DENSITY" }
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
- DATABASE_ID : আপনার নির্বাচিত ডাটাবেসের জন্য ডাটাবেস আইডি।
- COLLECTION : সূচীতে সংগ্রহের নাম
- FIELD_PATH : সূচী করার ক্ষেত্রের নাম
- ORDER :
ASCENDINGবাDESCENDINGমধ্যে একটি - DENSITY :
SPARSE_ANYবাDENSEমধ্যে একটি
একটি সূচক মুছুন
একটি সূচক মুছে ফেলার জন্য, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:
Firebase কনসোল
Firebase কনসোলে, ফায়ারস্টোর ডাটাবেস পৃষ্ঠায় যান।
- ডাটাবেসের তালিকা থেকে একটি ডাটাবেস নির্বাচন করুন।
- ইনডেক্সেস ট্যাবে ক্লিক করুন।
- সূচীর তালিকায়, আপনি বোতাম থেকে Delete নির্বাচন করুন।
- সূচী মুছুন ক্লিক করুন।
gcloud CLI
সূচকের নাম খুঁজে পেতে,
gcloud firestore indexes composite listকমান্ডটি ব্যবহার করুন।gcloud firestore indexes composite list \ --database='DATABASE_ID'
DATABASE_ID ডাটাবেস আইডি দিয়ে প্রতিস্থাপন করুন।
ইনডেক্স মুছে ফেলার জন্য,
gcloud firestore indexes composite deleteকমান্ডটি ব্যবহার করুন।gcloud firestore indexes composite delete INDEX_NAME \ --database='DATABASE_ID'
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
- INDEX_NAME : একটি সূচকের নাম
- DATABASE_ID : একটি ডাটাবেস আইডি
সূচক তৈরির সময়
একটি সূচক তৈরি করতে, Cloud Firestore অবশ্যই সূচক তৈরি করতে হবে এবং তারপরে বিদ্যমান ডেটা দিয়ে সূচক এন্ট্রিগুলি ব্যাকফিল করতে হবে। একটি সূচক তৈরি করতে প্রয়োজনীয় সময় নিম্নলিখিত দ্বারা নির্ধারিত হয়:
একটি সূচকের জন্য সর্বনিম্ন নির্মাণ সময় কয়েক মিনিট, এমনকি একটি খালি ডাটাবেসের জন্যও।
সূচক এন্ট্রিগুলি ব্যাকফিল করতে কত সময় লাগে তা নির্ভর করে নতুন সূচকে বিদ্যমান ডেটা কতটা অন্তর্ভুক্ত তার উপর। সূচকের সংজ্ঞার সাথে যত বেশি ক্ষেত্রের মান মেলে, সূচক এন্ট্রিগুলি ব্যাকফিল করতে তত বেশি সময় লাগে।
দীর্ঘমেয়াদী কার্যক্রম পরিচালনা করুন
ইনডেক্স বিল্ডগুলি দীর্ঘমেয়াদী অপারেশন । নিম্নলিখিত বিভাগগুলি সূচকের জন্য দীর্ঘমেয়াদী অপারেশনগুলির সাথে কীভাবে কাজ করতে হয় তা বর্ণনা করে।
আপনি একটি সূচক তৈরি শুরু করার পরে, Cloud Firestore অপারেশনটিকে একটি অনন্য নাম দেয়। অপারেশনের নামগুলি projects/ PROJECT_ID /databases/ DATABASE_ID /operations/ এর সাথে পূর্বে যুক্ত করা হয়, উদাহরণস্বরূপ:
projects/PROJECT_ID/databases/DATABASE_ID/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg
describe কমান্ডের জন্য একটি অপারেশন নাম নির্দিষ্ট করার সময় আপনি উপসর্গটি বাদ দিতে পারেন।
দীর্ঘমেয়াদী সকল কার্যক্রমের তালিকা তৈরি করুন।
দীর্ঘমেয়াদী অপারেশন তালিকাভুক্ত করতে, gcloud firestore operations list কমান্ডটি ব্যবহার করুন। এই কমান্ডটি চলমান এবং সম্প্রতি সম্পন্ন অপারেশনগুলির তালিকা করে। সমাপ্তির কয়েক দিনের জন্য অপারেশনগুলি তালিকাভুক্ত করা হয়:
gcloud firestore operations list
অপারেশনের অবস্থা পরীক্ষা করুন
দীর্ঘমেয়াদী সমস্ত ক্রিয়াকলাপ তালিকাভুক্ত করার পরিবর্তে, আপনি একটি একক ক্রিয়াকলাপের বিবরণ তালিকাভুক্ত করতে পারেন:
gcloud firestore operations describe operation-name
সমাপ্তির সময় অনুমান করা
আপনার অপারেশন চলাকালীন, অপারেশনের সামগ্রিক অবস্থা জানতে state ফিল্ডের মান দেখুন।
দীর্ঘমেয়াদী অপারেশনের স্থিতির জন্য একটি অনুরোধ workEstimated এবং workCompleted মেট্রিক্সও ফেরত পাঠায়। workEstimated একটি অপারেশন প্রক্রিয়া করবে এমন আনুমানিক মোট ডকুমেন্টের সংখ্যা দেখায়। workCompleted এখন পর্যন্ত প্রক্রিয়াকৃত ডকুমেন্টের সংখ্যা দেখায়। অপারেশন সম্পন্ন হওয়ার পরে, workCompleted আসলে প্রক্রিয়াকৃত ডকুমেন্টের মোট সংখ্যা প্রতিফলিত করে, যা workEstimated এর মানের চেয়ে ভিন্ন হতে পারে।
একটি অপারেশনের অগ্রগতি অনুমান করতে, workCompleted workEstimated দ্বারা ভাগ করুন।
একটি সূচক তৈরির অগ্রগতির একটি উদাহরণ নিচে দেওয়া হল:
{
"operations": [
{
"name": "projects/project-id/operations/AyAyMDBiM2U5NTgwZDAtZGIyYi0zYjc0LTIzYWEtZjg1ZGdWFmZWQHEjF0c2Flc3UtcmV4ZWRuaS1uaW1kYRUKSBI",
"metadata": {
"@type": "type.googleapis.com/google.firestore.admin.v1.IndexOperationMetadata",
"common": {
"operationType": "CREATE_INDEX",
"startTime": "2020-06-23T16:52:25.697539Z",
"state": "PROCESSING"
},
"progressDocuments": {
"workCompleted": "219327",
"workEstimated": "2198182"
}
},
},
...
যখন একটি অপারেশন সম্পন্ন হবে, তখন অপারেশনের বর্ণনায় "done": true । অপারেশনের ফলাফলের জন্য state ফিল্ডের মান দেখুন। যদি প্রতিক্রিয়ায় done ফিল্ড সেট না করা থাকে, তাহলে অপারেশনটি সম্পন্ন হয়নি।