इंडेक्स मैनेज करना

MongoDB API

टेक्स्ट इंडेक्स बनाने के लिए, createIndex() तरीके का इस्तेमाल करें. नीचे दिए गए उदाहरण में, जब किसी दस्तावेज़ को cities कलेक्शन में लिखा जाता है, तो country या food फ़ील्ड भर जाते हैं. इन फ़ील्ड को खोजने के लिए इंडेक्स किया जाता है.

db.cities.createIndex({"country": "text", "food": "text"})

इंडेक्स किए जाने के लिए, फ़ील्ड को स्ट्रिंग या स्ट्रिंग का कलेक्शन होना चाहिए. अरे इंडेक्स, खोज के लिए इंडेक्स नहीं किए जाते. इस वजह से, a.1.b को इंडेक्स करने पर, something को {a: {1: {b: something}}} में इंडेक्स किया जाएगा, लेकिन {a: [one, {b: something}]} में नहीं.

db.runCommand() की मदद से भी इंडेक्स बनाए जा सकते हैं. हर कलेक्शन के लिए सिर्फ़ एक टेक्स्ट इंडेक्स हो सकता है. हालांकि, एक db.runCommand() में अलग-अलग तरह के कई इंडेक्स बनाए जा सकते हैं. टेक्स्ट इंडेक्स बनाने के लिए, इस उदाहरण में db.runCommand() का इस्तेमाल किया गया है:

db.runCommand({
  createIndexes: "cities",
  indexes: [
    {
      key: { "country": "text", "food": "text" },
      name: "country_text_food_text"
    }
  ]
})

डिफ़ॉल्ट भाषा तय करना

आपके पास डिफ़ॉल्ट भाषा या अपने दस्तावेज़ में फ़ील्ड पाथ तय करने का विकल्प भी होता है. इसमें डिफ़ॉल्ट भाषा शामिल होगी.

यहां दिए गए उदाहरण में, myLanguageField को language_override के तौर पर तय किया गया है. जब cities कलेक्शन में मौजूद किसी दस्तावेज़ में myLanguageField नाम का कोई फ़ील्ड होता है, तो उस फ़ील्ड की वैल्यू का इस्तेमाल उस दस्तावेज़ के लिए country फ़ील्ड को इंडेक्स करने की भाषा तय करने के लिए किया जाता है. यह वैल्यू, french की डिफ़ॉल्ट भाषा को बदल देती है.

db.cities.createIndex({"country": "text"}, {"default_language": "french", "language_override": "myLanguageField"})

• भाषा को उसके पूरे नाम (english) या दो अक्षरों वाले आईएसओ भाषा कोड (en) के तौर पर डाला जा सकता है.
• अगर डिफ़ॉल्ट भाषा सेट नहीं की जाती है, तो Cloud Firestore डिफ़ॉल्ट रूप से अंग्रेज़ी पर सेट हो जाता है.
• भाषा बदलने वाला फ़ील्ड, टॉप-लेवल फ़ील्ड होना चाहिए. अगर इस नीति को सेट नहीं किया जाता है, तो भाषा बदलने वाला फ़ील्ड डिफ़ॉल्ट रूप से language पर सेट हो जाता है.
• अगर आपने डिफ़ॉल्ट भाषा को null वर्ण पर सेट किया है, तो Cloud Firestore किसी भी फ़ील्ड का इस्तेमाल, भाषा बदलने के लिए नहीं करता.

टेक्स्ट इंडेक्स को बांटना

किसी फ़ील्ड का इस्तेमाल करके, इंडेक्स को भी बांटा जा सकता है, ताकि क्वेरी को किसी फ़ील्ड की वैल्यू के हिसाब से फ़िल्टर किया जा सके. इस कॉन्फ़िगरेशन की मदद से, बेहतर परफ़ॉर्मेंस वाली क्वेरी चलाई जा सकती हैं. ऐसा तब किया जा सकता है, जब आपको उस इंडेक्स में हमेशा किसी खास फ़ील्ड को फ़िल्टर करना हो जिसमें क्वेरी की जा रही है.

पार्टिशन के साथ इंडेक्स बनाने के लिए, firestoreOptions फ़ील्ड को इस तरह कॉन्फ़िगर करें:

db.runCommand({
  createIndexes: "cities",
  indexes: [
    {
      key: { "country": "text", "food": "text"},
      name: "country_text_food_text"
      firestoreOptions: {"customPartitionFields": ["PARTITIONED_FIELD"]
    }
  ]
})

जगह:

• PARTITIONED_FIELD उस फ़ील्ड का नाम है जिसका इस्तेमाल, डेटा को सेगमेंट में बांटने के लिए किया जाता है. यह वैल्यू, एक स्ट्रिंग होनी चाहिए और टॉप-लेवल फ़ील्ड से जुड़ी होनी चाहिए. हिस्सों में बांटे गए इंडेक्स पर क्वेरी चलाने पर, इस फ़ील्ड की वैल्यू के आधार पर नतीजों को फ़िल्टर किया जा सकता है. उदाहरण के लिए, city का इस्तेमाल करके, इंडेक्स को अलग-अलग हिस्सों में बांटा जा सकता है. अगर आपके टेक्स्ट इंडेक्स में city फ़ील्ड तय किया गया है, तो उपयोगकर्ता किसी खास शहर के लिए क्वेरी कर सकते हैं.

  पार्टिशन में सिर्फ़ एक फ़ील्ड होना चाहिए. अगर किसी इंडेक्स को पार्टिशन किया जाता है, तो सिर्फ़ ऐसी क्वेरी चलाई जा सकती हैं जिनमें पार्टिशन किया गया फ़ील्ड तय किया गया हो.

सीमाएं

• एक अनुरोध में सिर्फ़ एक इंडेक्स बनाया जा सकता है.
• MongoDB API की मदद से इंडेक्स बनाने के लिए, ऑडिट लॉग में google.firestore.admin.v1.FirestoreAdmin.CreateIndex तरीके का इस्तेमाल किया जाता है.
• इंडेक्स के लिए उपलब्ध विकल्पों के बारे में जानने के लिए, इंडेक्स और इंडेक्स की प्रॉपर्टी देखें.

Firebase कंसोल

1. Firebase कंसोल में, Firestore Database पेज पर जाएं.

   Firestore डेटाबेस पर जाएं

2. डेटाबेस की सूची में से कोई डेटाबेस चुनें.

3. इंडेक्स टैब में, इंडेक्स बनाएं पर क्लिक करें.

4. कलेक्शन आईडी डालें.

5. एक या उससे ज़्यादा फ़ील्ड पाथ जोड़ें और हर एक के लिए इंडेक्स का विकल्प चुनें.

6. बनाएं पर क्लिक करें.

7. आपका नया इंडेक्स, इंडेक्स की सूची में दिखता है. साथ ही, MongoDB के साथ काम करने वाले ऑपरेशन, आपका इंडेक्स बनाना शुरू कर देते हैं. इंडेक्स बन जाने के बाद, आपको इंडेक्स के बगल में हरे रंग का सही का निशान दिखेगा. अगर इंडेक्स नहीं बनाया गया है, तो इसकी वजह जानने के लिए इंडेक्स बनाने से जुड़ी गड़बड़ियां देखें.

gcloud CLI

टेक्स्ट इंडेक्स बनाने के लिए, gcloud firestore indexes composite create कमांड का इस्तेमाल करें. --api-scope को mongodb-compatible-api पर सेट करें.

gcloud firestore indexes composite create \
  --database='DATABASE_ID' \
  --collection-group=COLLECTION_GROUP \
  --field-config=field-path=FIELD_NAME,search-config='{"text-spec": {"index-specs": [{"index-type": "tokenized", "match-type": "match-globally"}]}}' \
  --api-scope=mongodb-compatible-api \
  --search-index-options=text-language=en \
  --async

इनकी जगह ये डालें:

• DATABASE_ID: डेटाबेस आईडी.
• COLLECTION_GROUP: इंडेक्स किए जाने वाले कलेक्शन का आईडी.
• FIELD_NAME: इंडेक्स किए जाने वाले फ़ील्ड का नाम.

--async फ़्लैग, बैकग्राउंड में इंडेक्स बनाने की प्रोसेस को चलाता है.

MongoDB API

इंडेक्स बनाने के लिए, createIndex() मेथड का इस्तेमाल करें. उदाहरण के लिए:

db.restaurants.createIndex({"location" : "2dsphere", "region": "2dsphere"})

db.runCommand() के साथ इंडेक्स बनाने की सुविधा भी काम करती है. हालांकि, इसके लिए ज़्यादा से ज़्यादा एक इंडेक्स होना चाहिए:

db.runCommand({
  createIndexes: "restaurants",
  indexes: [
    {
      key: { "location": "2dsphere", "region": "2dsphere" },
      name: "location_2dsphere_region_2dsphere"
    }
  ]
})

2dsphere इंडेक्स को पार्टिशन करना

किसी फ़ील्ड का इस्तेमाल करके, इंडेक्स को भी बांटा जा सकता है, ताकि क्वेरी को किसी फ़ील्ड की वैल्यू के हिसाब से फ़िल्टर किया जा सके. इस कॉन्फ़िगरेशन की मदद से, बेहतर परफ़ॉर्मेंस वाली क्वेरी चलाई जा सकती हैं. ऐसा तब किया जा सकता है, जब आपको उस इंडेक्स में हमेशा किसी खास फ़ील्ड को फ़िल्टर करना हो जिसमें क्वेरी की जा रही है.

पार्टिशन के साथ इंडेक्स बनाने के लिए, firestoreOptions फ़ील्ड को इस तरह कॉन्फ़िगर करें:

db.runCommand({
  createIndexes: "restaurants",
  indexes: [
    {
      key: { "location": "2dsphere", "region": "2dsphere" },
      name: "location_2dsphere_region_2dsphere"
      firestoreOptions: {"customPartitionFields": ["PARTITIONED_FIELD"]
    }
  ]
})

जगह:

• PARTITIONED_FIELD उस फ़ील्ड का नाम है जिसका इस्तेमाल, डेटा को सेगमेंट में बांटने के लिए किया जाता है. हिस्सों में बांटे गए इंडेक्स पर क्वेरी चलाने पर, इस फ़ील्ड की वैल्यू के आधार पर नतीजों को फ़िल्टर किया जा सकता है. उदाहरण के लिए, अगर आपके इंडेक्स में क्षेत्रीय जगहों के लिए region फ़ील्ड है, तो region का इस्तेमाल करके अपने इंडेक्स को बांटा जा सकता है. इससे उपयोगकर्ता अपने इलाके के रेस्टोरेंट के बारे में क्वेरी कर सकते हैं.

  अगर किसी इंडेक्स को पार्टिशन किया जाता है, तो सिर्फ़ ऐसी क्वेरी चलाई जा सकती हैं जिनमें पार्टिशन किया गया फ़ील्ड मौजूद हो.

सीमाएं

• एक अनुरोध में सिर्फ़ एक इंडेक्स बनाया जा सकता है.
• MongoDB API की मदद से इंडेक्स बनाने के लिए, ऑडिट लॉग में google.firestore.admin.v1.FirestoreAdmin.CreateIndex तरीके का इस्तेमाल किया जाता है.
• इंडेक्स के लिए उपलब्ध विकल्पों के बारे में जानने के लिए, इंडेक्स और इंडेक्स की प्रॉपर्टी देखें.

Firebase कंसोल

1. Firebase कंसोल में, Firestore Database पेज पर जाएं.

   Firestore डेटाबेस पर जाएं

2. डेटाबेस की सूची में से कोई डेटाबेस चुनें.

3. इंडेक्स टैब में, इंडेक्स बनाएं पर क्लिक करें.

4. कलेक्शन आईडी डालें.

5. एक या उससे ज़्यादा फ़ील्ड पाथ जोड़ें और हर एक के लिए इंडेक्स का विकल्प चुनें.

6. बनाएं पर क्लिक करें.

7. आपका नया इंडेक्स, इंडेक्स की सूची में दिखता है. साथ ही, MongoDB के साथ काम करने वाले ऑपरेशन, आपका इंडेक्स बनाना शुरू कर देते हैं. इंडेक्स बन जाने के बाद, आपको इंडेक्स के बगल में हरे रंग का सही का निशान दिखेगा. अगर इंडेक्स नहीं बनाया गया है, तो इसकी वजह जानने के लिए इंडेक्स बनाने से जुड़ी गड़बड़ियां देखें.

gcloud CLI

2dsphere इंडेक्स बनाने के लिए, gcloud firestore indexes composite create कमांड का इस्तेमाल करें. --api-scope को mongodb-compatible-api पर सेट करें.

gcloud firestore indexes composite create \
  --database='DATABASE_ID' \
  --collection-group=COLLECTION_GROUP \
  --field-config=field-path=FIELD_NAME,search-config='{"geo-spec": {}}' \
  --api-scope=mongodb-compatible-api \
  --async

इनकी जगह ये डालें:

• DATABASE_ID: डेटाबेस आईडी.
• COLLECTION_GROUP: इंडेक्स किए जाने वाले कलेक्शन का आईडी.
• FIELD_NAME: इंडेक्स किए जाने वाले फ़ील्ड का नाम.

--async फ़्लैग, बैकग्राउंड में इंडेक्स बनाने की प्रोसेस को चलाता है.