स्कीमा बनाना और रजिस्टर करना

Google Cloud Search स्कीमा, एक JSON स्ट्रक्चर है. इसमें आपके डेटा को इंडेक्स करने और उस पर क्वेरी करने के लिए इस्तेमाल किए जाने वाले ऑब्जेक्ट, प्रॉपर्टी, और विकल्पों के बारे में बताया जाता है. आपका कॉन्टेंट कनेक्टर, आपकी रिपॉज़िटरी से डेटा पढ़ता है. साथ ही, रजिस्टर किए गए स्कीमा के आधार पर, डेटा को स्ट्रक्चर करता है और उसका इंडेक्स बनाता है.

एपीआई को JSON स्कीमा ऑब्जेक्ट देकर और फिर उसे रजिस्टर करके, स्कीमा बनाया जा सकता है. डेटा को इंडेक्स करने से पहले, आपको हर रिपॉज़िटरी के लिए स्कीमा ऑब्जेक्ट रजिस्टर करना होगा.

ध्यान दें: अगर आपके डेटा रिपॉज़िटरी में सिर्फ़ अनस्ट्रक्चर्ड डेटा है, तो आपको स्कीमा बनाने की ज़रूरत नहीं है. उदाहरण के लिए, अगर आपके पास पहले से तय फ़ाइल टाइप और स्ट्रक्चर के बिना फ़ाइल शेयर करने का बेसिक सिस्टम है, तो आम तौर पर आपको स्कीमा की ज़रूरत नहीं होगी. एपीआई को JSON ऑब्जेक्ट देने के बजाय, SDK का इस्तेमाल करके भी स्कीमा ऑब्जेक्ट बनाया जा सकता है.

इस दस्तावेज़ में स्कीमा बनाने की बुनियादी बातें बताई गई हैं. खोज अनुभव को बेहतर बनाने के लिए, अपने स्कीमा को ट्यून करने का तरीका जानने के लिए, खोज की क्वालिटी को बेहतर बनाना देखें.

स्कीमा बनाएं

Cloud Search स्कीमा बनाने के लिए, यहां दिया गया तरीका अपनाएं:

1. उपयोगकर्ता के संभावित व्यवहार की पहचान करना
2. डेटा सोर्स को शुरू करना
3. स्कीमा बनाना
4. पूरा सैंपल स्कीमा
5. स्कीमा रजिस्टर करना
6. अपना डेटा इंडेक्स करना
7. अपने स्कीमा की जांच करना
8. स्कीमा को ट्यून करना

ध्यान दें: इस दस्तावेज़ में एक काल्पनिक मूवी डेटाबेस के लिए, स्कीमा के स्निपेट का इस्तेमाल किया जाता है. पूरा स्कीमा देखने के लिए, schema.json

पर जाएं

उपयोगकर्ता के संभावित व्यवहार की पहचान करना

यह अनुमान लगाने से कि आपके उपयोगकर्ता किस तरह की क्वेरी करते हैं, आपको स्कीमा बनाने के लिए अपनी रणनीति तय करने में मदद मिलती है.

उदाहरण के लिए, किसी फ़िल्म डेटाबेस के लिए क्वेरी जारी करते समय, हो सकता है कि आप उपयोगकर्ता की क्वेरी का अनुमान लगा सकें. जैसे, "मुझे रॉबर्ट रेडफ़ोर्ड की सभी फ़िल्में दिखाओ." इसलिए, आपके स्कीमा में "किसी खास कलाकार की सभी फ़िल्मों" के आधार पर क्वेरी के नतीजे दिखाने की सुविधा होनी चाहिए.

अपने उपयोगकर्ता के व्यवहार के पैटर्न को दिखाने के लिए, स्कीमा तय करने के लिए, ये काम करें:

1. अलग-अलग उपयोगकर्ताओं की पसंदीदा क्वेरी के अलग-अलग सेट का आकलन करें.
2. उन ऑब्जेक्ट की पहचान करें जिनका इस्तेमाल क्वेरी में किया जा सकता है. ऑब्जेक्ट, मिलते-जुलते डेटा के लॉजिकल सेट होते हैं. जैसे, फ़िल्मों के डेटाबेस में मौजूद कोई फ़िल्म.
3. उन प्रॉपर्टी और वैल्यू की पहचान करें जो ऑब्जेक्ट बनाती हैं और जिनका इस्तेमाल क्वेरी में किया जा सकता है. प्रॉपर्टी, ऑब्जेक्ट के इंडेक्स किए जा सकने वाले एट्रिब्यूट होते हैं. इनमें प्राइमिटिव वैल्यू या अन्य ऑब्जेक्ट शामिल हो सकते हैं. उदाहरण के लिए, किसी मूवी ऑब्जेक्ट में, मूवी के टाइटल और रिलीज़ की तारीख जैसी प्रॉपर्टी, प्राइमिटिव वैल्यू के तौर पर हो सकती हैं. मूवी ऑब्जेक्ट में अन्य ऑब्जेक्ट भी हो सकते हैं. जैसे, कास्ट करने वाले सदस्य जिनकी अपनी प्रॉपर्टी होती हैं, जैसे कि उनका नाम या रोल.
4. प्रॉपर्टी के लिए मान्य वैल्यू के उदाहरण की पहचान करना. वैल्यू वह असल डेटा होता है जिसे किसी प्रॉपर्टी के लिए इंडेक्स किया जाता है. उदाहरण के लिए, आपके डेटाबेस में किसी फ़िल्म का टाइटल "Raiders of the Lost Ark" हो सकता है.
5. अपने उपयोगकर्ताओं के हिसाब से, क्रम से लगाने और रैंकिंग देने के विकल्प तय करें. उदाहरण के लिए, फ़िल्मों के बारे में क्वेरी करते समय, हो सकता है कि उपयोगकर्ता समय के हिसाब से क्रम में लगाना चाहें और दर्शकों की रेटिंग के हिसाब से रैंक करना चाहें. उन्हें टाइटल के हिसाब से, वर्णमाला के क्रम में लगाने की ज़रूरत नहीं है.
6. (ज़रूरी नहीं) इस बात का ध्यान रखें कि क्या आपकी कोई प्रॉपर्टी, किसी ऐसे कॉन्टेक्स्ट को दिखाती है जिसमें खोज की जा सकती है. जैसे, उपयोगकर्ताओं की नौकरी की भूमिका या डिपार्टमेंट. इससे, कॉन्टेक्स्ट के हिसाब से अपने-आप पूरा होने वाले सुझाव दिए जा सकेंगे. उदाहरण के लिए, हो सकता है कि फ़िल्मों का डेटाबेस खोजने वाले लोगों की दिलचस्पी सिर्फ़ किसी खास शैली की फ़िल्मों में हो. उपयोगकर्ता अपनी प्रोफ़ाइल के हिस्से के तौर पर यह तय करेंगे कि वे खोज के लिए किस शैली का कॉन्टेंट देखना चाहते हैं. इसके बाद, जब कोई उपयोगकर्ता फ़िल्मों की क्वेरी टाइप करना शुरू करता है, तब सिर्फ़ उसकी पसंदीदा शैली की फ़िल्मों, जैसे कि "ऐक्शन फ़िल्में" को अपने-आप पूरा होने वाले सुझावों के हिस्से के तौर पर सुझाया जाता है.
7. इन ऑब्जेक्ट, प्रॉपर्टी, और उदाहरण के तौर पर दी गई वैल्यू की सूची बनाएं, जिनका इस्तेमाल खोजों में किया जा सकता है. इस सूची का इस्तेमाल करने के तरीके के बारे में जानने के लिए, ऑपरेटर के विकल्प तय करें सेक्शन देखें.)

डेटा सोर्स को शुरू करना

डेटा सोर्स, किसी ऐसी रिपॉज़िटरी के डेटा को दिखाता है जिसे इंडेक्स किया गया है और Google Cloud में सेव किया गया है. डेटा सोर्स को शुरू करने के निर्देशों के लिए, तीसरे पक्ष के डेटा सोर्स मैनेज करना लेख पढ़ें.

उपयोगकर्ता के खोज के नतीजे, डेटा सोर्स से दिखाए जाते हैं. जब कोई उपयोगकर्ता खोज के नतीजे पर क्लिक करता है, तो Cloud Search, इंडेक्स करने के अनुरोध में दिए गए यूआरएल का इस्तेमाल करके, उपयोगकर्ता को असली आइटम पर ले जाता है.

अपने ऑब्जेक्ट तय करना

स्कीमा में डेटा की बुनियादी इकाई ऑब्जेक्ट होती है. इसे "स्कीमा ऑब्जेक्ट" भी कहा जाता है. यह डेटा का लॉजिकल स्ट्रक्चर होता है. फ़िल्मों के डेटाबेस में, डेटा का एक लॉजिकल स्ट्रक्चर "movie" होता है. मूवी में शामिल कलाकारों और क्रू को दिखाने के लिए, "person" एक और ऑब्जेक्ट हो सकता है.

स्कीमा में मौजूद हर ऑब्जेक्ट में प्रॉपर्टी या एट्रिब्यूट की एक सीरीज़ होती है. इनसे ऑब्जेक्ट के बारे में जानकारी मिलती है. जैसे, किसी फ़िल्म का टाइटल और अवधि या किसी व्यक्ति का नाम और जन्म की तारीख. किसी ऑब्जेक्ट की प्रॉपर्टी में, शुरुआती वैल्यू या अन्य ऑब्जेक्ट शामिल हो सकते हैं.

पहली इमेज में, फ़िल्म और व्यक्ति ऑब्जेक्ट के साथ-साथ उनसे जुड़ी प्रॉपर्टी दिखाई गई हैं.

पहला डायग्राम. दो ऑब्जेक्ट और एक सब-ऑब्जेक्ट दिखाने वाला सैंपल स्कीमा.

Cloud Search स्कीमा, objectDefinitions टैग में बताए गए ऑब्जेक्ट की परिभाषा वाले स्टेटमेंट की सूची होती है. यहां दिया गया स्कीमा स्निपेट, फ़िल्म और व्यक्ति के स्कीमा ऑब्जेक्ट के लिए objectDefinitions स्टेटमेंट दिखाता है.

{
  "objectDefinitions": [
    {
      "name": "movie",
      ...
    },
    {
      "name": "person",
      ...
    }
  ]
}

स्कीमा ऑब्जेक्ट तय करते समय, आपको ऑब्जेक्ट के लिए एक name देना होता है. यह name, स्कीमा के सभी अन्य ऑब्जेक्ट से यूनीक होना चाहिए. आम तौर पर, name वैल्यू का इस्तेमाल किया जाता है, जो ऑब्जेक्ट के बारे में बताती है. जैसे, फ़िल्म ऑब्जेक्ट के लिए movie. स्कीमा सेवा, इंडेक्स किए जा सकने वाले ऑब्जेक्ट के लिए, name फ़ील्ड का इस्तेमाल मुख्य आइडेंटिफ़ायर के तौर पर करती है. name फ़ील्ड के बारे में ज़्यादा जानकारी के लिए, ऑब्जेक्ट की परिभाषा देखें.

ध्यान दें: Cloud Search स्कीमा में, असल में दो टॉप-लेवल सेक्शन होते हैं: objectDefinitions और operationIds. जब आपका स्कीमा इस्तेमाल में होता है और स्कीमा के लिए लंबे समय तक चलने वाले ऑपरेशन (एलआरओ) लंबित होते हैं, तो रजिस्टर किए गए स्कीमा का अनुरोध करने पर, उन एलआरओ का operationIds दिखता है. operationIds को सेट नहीं किया जा सकता. साथ ही, स्कीमा के इस हिस्से को अनदेखा किया जा सकता है.

ऑब्जेक्ट प्रॉपर्टी तय करना

ObjectDefinition के रेफ़रंस में बताए गए तरीके के मुताबिक, ऑब्जेक्ट के नाम के बाद options का एक सेट और propertyDefinitions की सूची आती है. options में, freshnessOptions और displayOptions भी शामिल हो सकते हैं. freshnessOptions का इस्तेमाल, किसी आइटम के नए होने के आधार पर खोज रैंकिंग में बदलाव करने के लिए किया जाता है. displayOptions का इस्तेमाल यह तय करने के लिए किया जाता है कि किसी ऑब्जेक्ट के खोज नतीजों में, खास लेबल और प्रॉपर्टी दिखेंगी या नहीं.

ध्यान दें: खोज के अनुभव को बेहतर बनाने के लिए, freshnessOptions को ट्यून करने के बारे में जानकारी पाने के लिए, खोज की क्वालिटी को बेहतर बनाएं में जाकर, नएपन पर असर डालें पर जाएं.

propertyDefinitions सेक्शन में, किसी ऑब्जेक्ट की प्रॉपर्टी बताई जाती है. जैसे, फ़िल्म का टाइटल और रिलीज़ होने की तारीख.

नीचे दिया गया स्निपेट, दो प्रॉपर्टी के साथ movie ऑब्जेक्ट दिखाता है: movieTitle और releaseDate.

{
  "objectDefinitions": [
    {
      "name": "movie",
      "propertyDefinitions": [
        {
          "name": "movieTitle",
          "isReturnable": true,
          "isWildcardSearchable": true,
          "textPropertyOptions": {
            "retrievalImportance": { "importance": "HIGHEST" },
            "operatorOptions": {
              "operatorName": "title"
            }
          },
          "displayOptions": {
            "displayLabel": "Title"
          }
        },
        {
          "name": "releaseDate",
          "isReturnable": true,
          "isSortable": true,
          "datePropertyOptions": {
            "operatorOptions": {
              "operatorName": "released",
              "lessThanOperatorName": "releasedbefore",
              "greaterThanOperatorName": "releasedafter"
            }
          },
          "displayOptions": {
            "displayLabel": "Release date"
          }
      ...
      ]
    }
  ]
}

ध्यान दें: एक ही ऑब्जेक्ट में तय किए गए प्रॉपर्टी के नाम, सिर्फ़ केस में अंतर होने पर एक जैसे माने जाते हैं. जैसे, movieTitle और movietitle. इससे गड़बड़ी का मैसेज दिखेगा.

PropertyDefinition में ये आइटम शामिल होते हैं:

• name स्ट्रिंग.
• टाइप-एग्नोस्टिक विकल्पों की सूची, जैसे कि पिछले स्निपेट में isReturnable.
• टाइप और उससे जुड़े टाइप के हिसाब से विकल्प, जैसे कि पिछले स्निपेट में textPropertyOptions और retrievalImportance.
• operatorOptions, जिसमें बताया गया हो कि प्रॉपर्टी का इस्तेमाल खोज ऑपरेटर के तौर पर कैसे किया जाता है.
• एक या उससे ज़्यादा displayOptions, जैसे कि पिछले स्निपेट में displayLabel.

किसी प्रॉपर्टी का name, उसमें शामिल ऑब्जेक्ट में यूनीक होना चाहिए. हालांकि, उसी नाम का इस्तेमाल दूसरे ऑब्जेक्ट और सब-ऑब्जेक्ट में किया जा सकता है. पहली इमेज में, मूवी के टाइटल और रिलीज़ की तारीख को दो बार बताया गया है: एक बार movie ऑब्जेक्ट में और फिर person ऑब्जेक्ट के filmography सब-ऑब्जेक्ट में. यह स्कीमा, movieTitle फ़ील्ड का फिर से इस्तेमाल करता है, ताकि स्कीमा दो तरह के सर्च व्यवहार के साथ काम कर सके:

• जब उपयोगकर्ता किसी फ़िल्म का टाइटल खोजते हैं, तब उन्हें फ़िल्म के नतीजे दिखाएं.
• जब उपयोगकर्ता किसी ऐसी फ़िल्म का टाइटल खोजते हैं जिसमें किसी कलाकार ने काम किया है, तो उन्हें लोगों के नतीजे दिखाएं.

इसी तरह, स्कीमा releaseDate फ़ील्ड का फिर से इस्तेमाल करता है, क्योंकि दोनों movieTitle फ़ील्ड के लिए इसका मतलब एक ही होता है.

अपना स्कीमा बनाते समय, देखें कि आपके रिपॉज़िटरी (डेटा स्टोर करने की जगह) में ऐसे मिलते-जुलते फ़ील्ड कैसे हो सकते हैं जिनमें ऐसा डेटा होता है जिसका एलान आपको अपने स्कीमा में एक से ज़्यादा बार करना हो.

ध्यान दें: अगर इंडेक्स करने का अनुरोध, रजिस्टर नहीं किए गए फ़ील्ड या प्रॉपर्टी के साथ किसी आइटम को इंडेक्स करने की कोशिश करता है, जैसे कि releaseDate के बजाय date, तो सिस्टम उस फ़ील्ड को खारिज कर देता है. अगर इंडेक्स करने के अनुरोध में किसी प्रॉपर्टी के लिए गलत डेटा टाइप दिया जाता है, तो सिस्टम पूरे अनुरोध को अस्वीकार कर देता है. जैसे, अवधि वाले फ़ील्ड के लिए कोई पूर्णांक देना. इस फ़ील्ड में टेक्स्ट देना चाहिए, ताकि वह यूनिट के छोटे नामों को मैनेज कर सके.

टाइप के हिसाब से विकल्प जोड़ना

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

• isReturnable - इससे पता चलता है कि प्रॉपर्टी में ऐसे डेटा की पहचान की जाती है जिसे क्वेरी एपीआई के ज़रिए खोज के नतीजों में दिखाया जाना चाहिए. फ़िल्म की उदाहरण के तौर पर दी गई सभी प्रॉपर्टी को लौटाया जा सकता है. नतीजे न दिखाने वाली प्रॉपर्टी का इस्तेमाल, उपयोगकर्ता को नतीजे दिखाए बिना, खोजने या रैंक करने के लिए किया जा सकता है.
• isRepeatable - इससे पता चलता है कि प्रॉपर्टी के लिए एक से ज़्यादा वैल्यू सबमिट की जा सकती हैं या नहीं. उदाहरण के लिए, किसी फ़िल्म की रिलीज़ की सिर्फ़ एक तारीख होती है, लेकिन उसमें कई कलाकार हो सकते हैं.
• isSortable - इससे पता चलता है कि प्रॉपर्टी का इस्तेमाल, क्रम से लगाने के लिए किया जा सकता है. यह बात, दोबारा इस्तेमाल की जा सकने वाली प्रॉपर्टी के लिए सही नहीं है. उदाहरण के लिए, फ़िल्म के नतीजे, रिलीज़ की तारीख या ऑडियंस रेटिंग के हिसाब से क्रम में लगाए जा सकते हैं.
• isFacetable - इससे पता चलता है कि प्रॉपर्टी का इस्तेमाल फ़ेसेट जनरेट करने के लिए किया जा सकता है. फ़ेसेट का इस्तेमाल, खोज के नतीजों को बेहतर बनाने के लिए किया जाता है. इसमें उपयोगकर्ता को शुरुआती नतीजे दिखते हैं. इसके बाद, उन नतीजों को बेहतर बनाने के लिए, वह शर्तें या फ़ेसेट जोड़ता है. यह विकल्प उन प्रॉपर्टी के लिए सही नहीं हो सकता जिनका टाइप ऑब्जेक्ट है और इस विकल्प को सेट करने के लिए, isReturnable का सही होना ज़रूरी है. आखिर में, यह विकल्प सिर्फ़ एनम, बूलियन, और टेक्स्ट प्रॉपर्टी के लिए काम करता है. उदाहरण के लिए, हमारे सैंपल स्कीमा में हम genre, actorName, userRating, और mpaaRating की फ़ेसटेबल बना सकते हैं, ताकि खोज के नतीजों को इंटरैक्टिव तरीके से बेहतर बनाने के लिए उनका इस्तेमाल किया जा सके.
• isWildcardSearchable से पता चलता है कि उपयोगकर्ता इस प्रॉपर्टी के लिए वाइल्डकार्ड खोज कर सकते हैं. यह विकल्प सिर्फ़ टेक्स्ट प्रॉपर्टी पर उपलब्ध है. टेक्स्ट फ़ील्ड पर वाइल्डकार्ड खोज का काम करने का तरीका, exactMatchWithOperator फ़ील्ड में सेट की गई वैल्यू पर निर्भर करता है. अगर exactMatchWithOperator को true पर सेट किया जाता है, तो टेक्स्ट वैल्यू को एक एटमिक वैल्यू के तौर पर टोकन किया जाता है और उसके आधार पर वाइल्डकार्ड खोज की जाती है. उदाहरण के लिए, अगर टेक्स्ट वैल्यू science-fiction है, तो वाइल्डकार्ड क्वेरी science-* इससे मैच करती है. अगर exactMatchWithOperator को false पर सेट किया जाता है, तो टेक्स्ट वैल्यू को टोकन में बदल दिया जाता है और हर टोकन के लिए वाइल्डकार्ड खोज की जाती है. उदाहरण के लिए, अगर टेक्स्ट वैल्यू "साइंस-फ़िक्शन" है, तो वाइल्डकार्ड की क्वेरी sci* या fi* आइटम से मेल खाती हैं, लेकिन science-* इससे मेल नहीं खाती.

खोज की सामान्य सुविधाओं के ये पैरामीटर, सभी बूलियन वैल्यू हैं. इनकी डिफ़ॉल्ट वैल्यू false होती है. इनका इस्तेमाल करने के लिए, इन्हें true पर सेट करना ज़रूरी है.

नीचे दी गई टेबल में वे बूलियन पैरामीटर दिखाए गए हैं जो movie ऑब्जेक्ट की सभी प्रॉपर्टी के लिए, true पर सेट किए गए हैं:

प्रॉपर्टी	isReturnable	isRepeatable	isSortable	isFacetable	isWildcardSearchable
movieTitle	सही				सही
releaseDate	सही		सही
genre	सही	सही		सही
duration	सही
actorName	सही	सही		सही	सही
userRating	सही		सही
mpaaRating	सही			सही

genre और actorName, दोनों के लिए isRepeatable को true पर सेट किया गया है, क्योंकि कोई फ़िल्म एक से ज़्यादा शैलियों में हो सकती है और आम तौर पर उसमें एक से ज़्यादा कलाकार होते हैं. अगर किसी प्रॉपर्टी को दोहराया जा सकता है या वह दोहराए जा सकने वाले किसी सब-ऑब्जेक्ट में शामिल है, तो उसे क्रम से नहीं लगाया जा सकता.

टाइप तय करें

PropertyDefinition के रेफ़रंस सेक्शन में, ऐसे कई xxPropertyOptions दिए गए हैं जहां xx किसी खास टाइप का है, जैसे कि boolean. प्रॉपर्टी का डेटा टाइप सेट करने के लिए, आपको सही डेटा-टाइप ऑब्जेक्ट तय करना होगा. किसी प्रॉपर्टी के लिए डेटा टाइप ऑब्जेक्ट तय करने पर, उस प्रॉपर्टी का डेटा टाइप तय हो जाता है. उदाहरण के लिए, movieTitle प्रॉपर्टी के लिए textPropertyOptions तय करने से पता चलता है कि फ़िल्म का टाइटल टेक्स्ट टाइप का है. नीचे दिया गया स्निपेट, movieTitle प्रॉपर्टी के साथ textPropertyOptions को डेटा टाइप सेट करते हुए दिखाता है.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    ...
  },
  ...
},

ध्यान दें: अगर आपको किसी प्रॉपर्टी के लिए सभी संभावित वैल्यू का पूरा सेट पता है, तो स्ट्रिंग टाइप के बजाय, सूची (enumPropertyOptions) का इस्तेमाल करें. अगर आने वाले वर्शन में ईनम बदलता है, तो स्कीमा की जांच करने के लिए दी गई जानकारी का इस्तेमाल करें और ज़रूरत पड़ने पर इसे अपडेट करें.

किसी प्रॉपर्टी में सिर्फ़ एक तरह का डेटा हो सकता है. उदाहरण के लिए, हमारी फ़िल्म के स्कीमा में, releaseDate सिर्फ़ तारीख हो सकती है (जैसे, 2016-01-13) या स्ट्रिंग (जैसे, January 13, 2016), दोनों नहीं.

यहां डेटा-टाइप ऑब्जेक्ट दिए गए हैं, जिनका इस्तेमाल सैंपल मूवी स्कीमा में प्रॉपर्टी के लिए डेटा टाइप तय करने के लिए किया जाता है:

प्रॉपर्टी	डेटा टाइप ऑब्जेक्ट
movieTitle	textPropertyOptions
releaseDate	datePropertyOptions
genre	enumPropertyOptions
duration	textPropertyOptions
actorName	textPropertyOptions
userRating	integerPropertyOptions
mpaaRating	textPropertyOptions

प्रॉपर्टी के लिए चुना गया डेटा टाइप, आपके इस्तेमाल के उदाहरणों पर निर्भर करता है. इस फ़िल्म स्कीमा की कल्पना की गई स्थिति में, उपयोगकर्ताओं को नतीजों को समय के हिसाब से क्रम में लगाना होगा. इसलिए, releaseDate एक तारीख ऑब्जेक्ट है. उदाहरण के लिए, अगर आपको साल भर में रिलीज़ होने वाली दिसंबर की रिलीज़ की तुलना, जनवरी की रिलीज़ से करनी है, तो स्ट्रिंग फ़ॉर्मैट का इस्तेमाल किया जा सकता है.

टाइप के हिसाब से विकल्प कॉन्फ़िगर करना

PropertyDefinition रेफ़रंस सेक्शन में, हर टाइप के विकल्पों के लिंक होते हैं. टाइप के हिसाब से दिए गए ज़्यादातर विकल्प ज़रूरी नहीं हैं. हालांकि, enumPropertyOptions में possibleValues की सूची को चुनना ज़रूरी है. इसके अलावा, orderedRanking विकल्प की मदद से, वैल्यू को एक-दूसरे के हिसाब से रैंक किया जा सकता है. यहां दिए गए स्निपेट में, movieTitle प्रॉपर्टी को डेटा टाइप textPropertyOptions और टाइप के हिसाब से retrievalImportance विकल्प के साथ दिखाया गया है.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    ...
  },
  ...
}

सैंपल स्कीमा में इस्तेमाल किए जाने वाले, टाइप के हिसाब से कुछ और विकल्प यहां दिए गए हैं:

प्रॉपर्टी	टाइप	टाइप के हिसाब से विकल्प
movieTitle	textPropertyOptions	retrievalImportance
releaseDate	datePropertyOptions
genre	enumPropertyOptions
duration	textPropertyOptions
actorName	textPropertyOptions
userRating	integerPropertyOptions	orderedRanking, maximumValue
mpaaRating	textPropertyOptions

ऑपरेटर के विकल्प तय करना

टाइप के हिसाब से विकल्पों के अलावा, हर टाइप के लिए वैकल्पिक विकल्पों का एक सेट होता हैoperatorOptions इन विकल्पों से पता चलता है कि प्रॉपर्टी का इस्तेमाल खोज ऑपरेटर के तौर पर कैसे किया जाता है. यहां दिया गया स्निपेट, movieTitle प्रॉपर्टी को दिखाता है. इसमें, डेटा टाइप को सेट करने के लिए textPropertyOptions और टाइप के हिसाब से retrievalImportance और operatorOptions विकल्पों का इस्तेमाल किया गया है.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    "operatorOptions": {
      "operatorName": "title"
    }
  },
  ...
}

चेतावनी: जब तक आपको पक्के तौर पर यह न पता हो कि खोज के नतीजों में किसी प्रॉपर्टी की रैंक, अन्य प्रॉपर्टी से बेहतर होनी चाहिए, तो retrievalImportance को DEFAULT पर सेट करें. सेट करने के बाद, इस विकल्प को बदला नहीं जा सकता. उदाहरण के लिए, अगर कोई प्रॉपर्टी किसी टाइटल को दिखाती है, तो उसे HIGHEST अहमियत देना अच्छा रहेगा. हालांकि, अगर किसी प्रॉपर्टी में ऐसे पार्ट नंबर शामिल हैं जो दूसरे पार्ट के रेफ़रंस हैं, लेकिन वे खुद पार्ट नहीं हैं, तो प्रॉपर्टी को कम अहमियत के तौर पर मार्क करें. अगर आपको प्रॉपर्टी के महत्व के बारे में जानकारी नहीं है, तो DEFAULT का इस्तेमाल करें. अगर आपको लगता है कि टेक्स्ट को वापस पाने के लिए इस्तेमाल नहीं किया जाना चाहिए, तो NONE का इस्तेमाल करें. ज़्यादा जानकारी के लिए, अहम जानकारी देखें.

हर operatorOptions का एक operatorName होता है, जैसे कि movieTitle के लिए title. ऑपरेटर का नाम, प्रॉपर्टी के लिए सर्च ऑपरेटर होता है. सर्च ऑपरेटर, वह असल पैरामीटर होता है जिसका इस्तेमाल करके उपयोगकर्ता, खोज के नतीजों को सटीक बनाते हैं. उदाहरण के लिए, फ़िल्मों को उनके टाइटल के हिसाब से खोजने के लिए, उपयोगकर्ता title:movieName टाइप करेगा. यहां movieName, फ़िल्म का नाम है.

यह ज़रूरी नहीं है कि ऑपरेटर के नाम और प्रॉपर्टी का नाम एक ही हो. इसके बजाय, आपको ऑपरेटर के ऐसे नाम इस्तेमाल करने चाहिए जो आपके संगठन के उपयोगकर्ताओं के सबसे ज़्यादा इस्तेमाल किए गए शब्दों से मेल खाते हों. उदाहरण के लिए, अगर आपके उपयोगकर्ता किसी फ़िल्म के टाइटल के लिए "टाइटल" के बजाय "नाम" पसंद करते हैं, तो ऑपरेटर का नाम "name" पर सेट होना चाहिए.

ध्यान दें: उपयोगकर्ताओं को अपने ऑपरेटर के नाम दिखाना ज़रूरी है. ऐसा, आपके खोज इंटरफ़ेस या दस्तावेज़ में विकल्प के तौर पर किया जा सकता है. उपयोगकर्ताओं को यह पता होना चाहिए कि अपनी खोज क्वेरी को बेहतर बनाने के लिए, किन ऑपरेटर का इस्तेमाल करना है.

कई प्रॉपर्टी के लिए एक ही ऑपरेटर नाम का इस्तेमाल किया जा सकता है, बशर्ते सभी प्रॉपर्टी एक ही तरह की हों. क्वेरी के दौरान, शेयर किए गए ऑपरेटर के नाम का इस्तेमाल करने पर, उस ऑपरेटर के नाम का इस्तेमाल करने वाली सभी प्रॉपर्टी वापस लाई जाती हैं. उदाहरण के लिए, मान लें कि फ़िल्म ऑब्जेक्ट में plotSummary और plotSynopsis प्रॉपर्टी थीं और इनमें से हर प्रॉपर्टी में plot की operatorName वैल्यू थी. जब तक ये दोनों प्रॉपर्टी टेक्स्ट (textPropertyOptions) हैं, तब तक plot सर्च ऑपरेटर का इस्तेमाल करके की गई एक क्वेरी, दोनों को वापस लाती है.

operatorName के अलावा, operatorOptions में lessThanOperatorName और greaterThanOperatorName फ़ील्ड, क्रम से लगाई जा सकने वाली प्रॉपर्टी में हो सकते हैं. उपयोगकर्ता इन विकल्पों का इस्तेमाल करके, सबमिट की गई वैल्यू की तुलना के आधार पर क्वेरी बना सकते हैं.

आखिर में, textOperatorOptions में exactMatchWithOperator फ़ील्ड है, जो operatorOptions में है. अगर exactMatchWithOperator को true पर सेट किया जाता है, तो क्वेरी स्ट्रिंग सिर्फ़ टेक्स्ट में ही नहीं, बल्कि प्रॉपर्टी की पूरी वैल्यू से मेल खानी चाहिए. ऑपरेटर खोजों और फ़ेसेट मैच में, टेक्स्ट वैल्यू को एक एटमिक वैल्यू माना जाता है.

उदाहरण के लिए, शैली की प्रॉपर्टी के साथ किताब या फ़िल्म ऑब्जेक्ट को इंडेक्स करें. शैलियों में "साइंस-फ़िक्शन", "साइंस", और "फ़िक्शन" शामिल हो सकते हैं. exactMatchWithOperator को false पर सेट करने या हटाने पर, किसी शैली को खोजने या "विज्ञान" या "फ़िक्शन" फ़ेसेट में से किसी एक को चुनने पर, "साइंस-फ़िक्शन" के लिए भी नतीजे मिलेंगे. ऐसा इसलिए होता है, क्योंकि टेक्स्ट को टोकन में बदल दिया जाता है और "साइंस" और "फ़िक्शन" टोकन, "साइंस-फ़िक्शन" में मौजूद होते हैं. जब exactMatchWithOperator की वैल्यू true होती है, तो टेक्स्ट को एक टोकन माना जाता है. इसलिए, "Science" और "Fiction", दोनों ही "Science-Fiction" से मैच नहीं करते.

(ज़रूरी नहीं) displayOptions सेक्शन जोड़ना

किसी भी propertyDefinition सेक्शन के आखिर में, वैकल्पिक displayOptions सेक्शन होता है. इस सेक्शन में एक displayLabel स्ट्रिंग है. displayLabel, प्रॉपर्टी के लिए सुझाया गया एक ऐसा टेक्स्ट लेबल है जिसे इस्तेमाल करना आसान है. अगर प्रॉपर्टी को ObjectDisplayOptions का इस्तेमाल करके डिसप्ले के लिए कॉन्फ़िगर किया गया है, तो यह लेबल प्रॉपर्टी के सामने दिखता है. अगर प्रॉपर्टी को डिसप्ले के लिए कॉन्फ़िगर किया गया है और displayLabel की वैल्यू तय नहीं की गई है, तो सिर्फ़ प्रॉपर्टी की वैल्यू दिखती है.

नीचे दिया गया स्निपेट, movieTitle प्रॉपर्टी को दिखाता है. इसमें displayLabel को 'टाइटल' पर सेट किया गया है.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    "operatorOptions": {
       "operatorName": "title"
    }
},
  "displayOptions": {
    "displayLabel": "Title"
  }
},

सैंपल स्कीमा में, movie ऑब्जेक्ट की सभी प्रॉपर्टी के लिए, displayLabel वैल्यू नीचे दी गई हैं:

प्रॉपर्टी	displayLabel
movieTitle	Title
releaseDate	Release date
genre	Genre
duration	Run length
actorName	Actor
userRating	Audience score
mpaaRating	MPAA rating

(ज़रूरी नहीं) suggestionFilteringOperators[] सेक्शन जोड़ना

किसी भी propertyDefinition सेक्शन के आखिर में, एक वैकल्पिक suggestionFilteringOperators[] सेक्शन होता है. अपने-आप पूरा होने वाले सुझावों को फ़िल्टर करने के लिए इस्तेमाल की जाने वाली प्रॉपर्टी तय करने के लिए, इस सेक्शन का इस्तेमाल करें. उदाहरण के लिए, उपयोगकर्ता की पसंदीदा फ़िल्म शैली के आधार पर सुझावों को फ़िल्टर करने के लिए, genre का ऑपरेटर तय किया जा सकता है. इसके बाद, जब उपयोगकर्ता अपनी खोज क्वेरी टाइप करता है, तो अपने-आप पूरी होने वाले सुझावों के हिस्से के तौर पर, सिर्फ़ उनकी पसंदीदा शैली से मैच होने वाली फ़िल्में दिखती हैं.

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

अपना स्कीमा रजिस्टर करें

Cloud Search की क्वेरी से स्ट्रक्चर्ड डेटा पाने के लिए, आपको Cloud Search के स्कीमा की सेवा के साथ अपना स्कीमा रजिस्टर करना होगा. स्कीमा को रजिस्टर करने के लिए, डेटा सोर्स को शुरू करना चरण के दौरान मिले डेटा सोर्स आईडी की ज़रूरत होती है.

डेटा सोर्स आईडी का इस्तेमाल करके, अपने स्कीमा को रजिस्टर करने के लिए, UpdateSchema अनुरोध करें.

UpdateSchema के रेफ़रंस पेज पर बताए गए तरीके के मुताबिक, अपने स्कीमा को रजिस्टर करने के लिए, यह एचटीटीपी अनुरोध करें:

PUT https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/schema

आपके अनुरोध के मुख्य हिस्से में यह जानकारी शामिल होनी चाहिए:

{
  "validateOnly": // true or false,
  "schema": {
    // ... Your complete schema object ...
  }
}

अपने स्कीमा को रजिस्टर किए बिना, उसकी पुष्टि करने के लिए validateOnly विकल्प का इस्तेमाल करें.

अपना डेटा इंडेक्स करना

स्कीमा रजिस्टर होने के बाद, Index कॉल का इस्तेमाल करके डेटा सोर्स को पॉप्युलेट करें. आम तौर पर, इंडेक्स करने की प्रोसेस आपके कॉन्टेंट कनेक्टर में की जाती है.

मूवी स्कीमा का इस्तेमाल करके, किसी एक मूवी के लिए REST API का इंडेक्सिंग अनुरोध ऐसा दिखेगा:

{
  "name": "datasource/<data_source_id>/items/titanic",
  "acl": {
    "readers": [
      {
        "gsuitePrincipal": {
          "gsuiteDomain": true
        }
      }
    ]
  },
  "metadata": {
    "title": "Titanic",
    "sourceRepositoryUrl": "http://www.imdb.com/title/tt2234155/?ref_=nv_sr_1",
    "objectType": "movie"
  },
  "structuredData": {
    "object": {
      "properties": [
        {
          "name": "movieTitle",
          "textValues": {
            "values": [
              "Titanic"
            ]
          }
        },
        {
          "name": "releaseDate",
          "dateValues": {
            "values": [
              {
                "year": 1997,
                "month": 12,
                "day": 19
              }
            ]
          }
        },
        {
          "name": "actorName",
          "textValues": {
            "values": [
              "Leonardo DiCaprio",
              "Kate Winslet",
              "Billy Zane"
            ]
          }
        },
        {
          "name": "genre",
          "enumValues": {
            "values": [
              "Drama",
              "Action"
            ]
          }
        },
        {
          "name": "userRating",
          "integerValues": {
            "values": [
              8
            ]
          }
        },
        {
          "name": "mpaaRating",
          "textValues": {
            "values": [
              "PG-13"
            ]
          }
        },
        {
          "name": "duration",
          "textValues": {
            "values": [
              "3 h 14 min"
            ]
          }
        }
      ]
    }
  },
  "content": {
    "inlineContent": "A seventeen-year-old aristocrat falls in love with a kind but poor artist aboard the luxurious, ill-fated R.M.S. Titanic.",
    "contentFormat": "TEXT"
  },
  "version": "01",
  "itemType": "CONTENT_ITEM"
}

ध्यान दें कि objectType फ़ील्ड में मौजूद movie की वैल्यू, स्कीमा में मौजूद ऑब्जेक्ट डेफ़िनिशन के नाम से कैसे मेल खाती है. इन दोनों वैल्यू को मैच करके, Cloud Search को पता चलता है कि इंडेक्स करने के दौरान किस स्कीमा ऑब्जेक्ट का इस्तेमाल करना है.

यह भी ध्यान दें कि स्कीमा प्रॉपर्टी releaseDate को इंडेक्स करने के लिए, year, month, और day की उन सब-प्रॉपर्टी का इस्तेमाल कैसे किया जाता है जिन्हें यह इनहेरिट करती है. ऐसा इसलिए होता है, क्योंकि इसे datePropertyOptions का इस्तेमाल करके date डेटा टाइप के तौर पर परिभाषित किया जाता है. हालांकि, स्कीमा में year, month, और day की जानकारी नहीं दी गई है.इसलिए, इनमें से किसी एक प्रॉपर्टी के लिए क्वेरी नहीं की जा सकती. उदाहरण के लिए, year) को अलग-अलग सेट किया जा सकता है.

साथ ही, ध्यान दें कि वैल्यू की सूची का इस्तेमाल करके, दोहराई जा सकने वाली प्रॉपर्टी actorName को कैसे इंडेक्स किया जाता है.

ध्यान दें: इंडेक्स करने के अनुरोध में प्रॉपर्टी का नाम, स्कीमा में मौजूद प्रॉपर्टी के केस से मेल खाना चाहिए. ऐसा न होने पर, इंडेक्स करने के अनुरोध का कुछ हिस्सा, रजिस्टर नहीं की गई प्रॉपर्टी के तौर पर हटा दिया जाता है.

इंडेक्स करने से जुड़ी संभावित समस्याओं की पहचान करना

स्कीमा और इंडेक्स करने से जुड़ी दो सबसे सामान्य समस्याएं ये हैं:

• इंडेक्स करने के आपके अनुरोध में, स्कीमा ऑब्जेक्ट या प्रॉपर्टी का ऐसा नाम है जिसे स्कीमा सेवा के साथ रजिस्टर नहीं किया गया था. इस समस्या की वजह से प्रॉपर्टी या ऑब्जेक्ट को अनदेखा कर दिया जाता है.

• इंडेक्स करने के आपके अनुरोध में, प्रॉपर्टी की टाइप वैल्यू, स्कीमा में रजिस्टर की गई टाइप वैल्यू से अलग है. इस समस्या की वजह से, इंडेक्स करने के समय Cloud Search गड़बड़ी का मैसेज दिखाता है.

अलग-अलग तरह की क्वेरी की मदद से अपने स्कीमा की जांच करना

प्रोडक्शन डेटा के एक बड़े रिपॉज़िटरी (डेटा स्टोर करने की जगह) के लिए अपने स्कीमा को रजिस्टर करने से पहले, टेस्ट डेटा को स्टोर करने की छोटी सी जगह की मदद से टेस्ट करें. टेस्ट के लिए डेटा स्टोर करने की छोटी जगह का इस्तेमाल करके, अपने स्कीमा में तेज़ी से बदलाव किए जा सकते हैं. साथ ही, इंडेक्स किए गए डेटा को मिटाया जा सकता है. इससे, बड़े इंडेक्स या मौजूदा प्रोडक्शन इंडेक्स पर असर नहीं पड़ता. टेस्ट डेटा रिपॉज़िटरी के लिए, ऐसा एसीएल बनाएं जो सिर्फ़ टेस्ट उपयोगकर्ता को अनुमति देता हो. इससे अन्य उपयोगकर्ताओं को Search के नतीजों में यह डेटा नहीं दिखेगा.

खोज क्वेरी की पुष्टि करने वाला खोज इंटरफ़ेस बनाने के लिए, खोज इंटरफ़ेस देखें

इस सेक्शन में, कई अलग-अलग उदाहरण क्वेरी दी गई हैं. इनका इस्तेमाल, मूवी स्कीमा की जांच करने के लिए किया जा सकता है.

सामान्य क्वेरी से टेस्ट करें

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

किसी ऑपरेटर से जांच करना

क्वेरी में ऑपरेटर जोड़ने से, नतीजे सिर्फ़ उन आइटम तक सीमित हो जाते हैं जो ऑपरेटर की वैल्यू से मैच करते हैं. उदाहरण के लिए, किसी खास कलाकार की सभी फ़िल्में ढूंढने के लिए, actor ऑपरेटर का इस्तेमाल किया जा सकता है. खोज इंटरफ़ेस का इस्तेमाल करके, ऑपरेटर क्वेरी को ऑपरेटर=वैल्यू जोड़े के तौर पर टाइप करके खोजा जा सकता है. जैसे, "actor:Zane". इसके बाद, Enter दबाएं. खोज के नतीजों में, ऐसी सभी फ़िल्में दिखनी चाहिए जिनमें ज़ेन ने अभिनय किया है.

अपने स्कीमा को ट्यून करना

स्कीमा और डेटा के इस्तेमाल के बाद, इस बात पर नज़र रखें कि आपके उपयोगकर्ताओं के लिए कौनसी चीज़ें काम कर रही हैं और कौनसी नहीं. आपको इन स्थितियों के लिए अपने स्कीमा में बदलाव करना चाहिए:

• किसी ऐसे फ़ील्ड को इंडेक्स करना जिसे पहले इंडेक्स नहीं किया गया था. उदाहरण के लिए, हो सकता है कि आपके उपयोगकर्ता, निर्देशक के नाम के आधार पर बार-बार फ़िल्में खोजें. इसलिए, अपने स्कीमा में बदलाव करके, निर्देशक के नाम को ऑपरेटर के तौर पर इस्तेमाल किया जा सकता है.
• उपयोगकर्ताओं के सुझावों के आधार पर, खोज ऑपरेटर के नाम बदले जा रहे हैं. ऑपरेटर के नाम, उपयोगकर्ता के लिए आसान होने चाहिए. अगर आपके उपयोगकर्ता लगातार गलत ऑपरेटर का नाम "याद" करते हैं, तो आप उसे बदलने पर विचार कर सकते हैं.

ध्यान दें: स्कीमा अपडेट या मिटाए जाने पर, खोज ऐप्लिकेशन भी अपडेट हो जाता है. उदाहरण के लिए, अगर किसी स्कीमा ऑपरेटर का नाम बदला जाता है, तो खोज ऐप्लिकेशन कॉन्फ़िगरेशन में भी उसका नाम बदल दिया जाता है. अगर स्कीमा अपडेट, खोज ऐप्लिकेशन के साथ काम नहीं करता और खोज ऐप्लिकेशन को अपडेट नहीं किया जा सकता, तो स्कीमा अपडेट नहीं हो पाता और अपडेट के जवाब में गड़बड़ी का मैसेज भेजा जाता है.

स्कीमा बदलने के बाद पेज को फिर से इंडेक्स करना

अपने स्कीमा में इनमें से किसी भी वैल्यू को बदलने पर, आपको अपने डेटा को फिर से इंडेक्स करने की ज़रूरत नहीं पड़ती. इसके लिए, आपको बस एक नया UpdateSchema अनुरोध सबमिट करना होगा. इसके बाद, आपका इंडेक्स काम करता रहेगा:

• ऑपरेटर के नाम.
• पूर्णांक की कम से कम और ज़्यादा से ज़्यादा वैल्यू.
• पूर्णांक और ईनम के हिसाब से क्रम में लगाई गई रैंकिंग.
• डेटा रीफ़्रेश करने के विकल्प.
• डिसप्ले के विकल्प

इन बदलावों के बाद, पहले से इंडेक्स किया गया डेटा, पहले से रजिस्टर किए गए स्कीमा के मुताबिक काम करता रहेगा. हालांकि, अपडेट किए गए स्कीमा के आधार पर बदलाव देखने के लिए, आपको मौजूदा एंट्री को फिर से इंडेक्स करना होगा. ऐसा तब करना होगा, जब स्कीमा में ये बदलाव हों:

• नई प्रॉपर्टी या ऑब्जेक्ट जोड़ना या हटाना
• isReturnable, isFacetable या isSortable को false से true में बदला जा रहा है.

अगर आपके पास इस्तेमाल का कोई उदाहरण और ज़रूरत है, तो आपको isFacetable या isSortable को true सिर्फ़ पर सेट करना चाहिए.

आखिर में, किसी प्रॉपर्टी को isSuggestable के तौर पर मार्क करके अपना स्कीमा अपडेट करने पर, आपको अपने डेटा को फिर से इंडेक्स करना होगा. इससे उस प्रॉपर्टी के लिए, अपने-आप पूरा होने की सुविधा का इस्तेमाल करने में देरी होती है.

इन प्रॉपर्टी में बदलाव करने की अनुमति नहीं है

स्कीमा में कुछ बदलाव करने की अनुमति नहीं है. भले ही, आपने अपने डेटा को फिर से इंडेक्स किया हो, क्योंकि इन बदलावों से इंडेक्स खराब हो जाएगा या खोज के खराब या अलग-अलग नतीजे मिलेंगे. इनमें ये बदलाव शामिल हैं:

• प्रॉपर्टी का डेटा टाइप.
• प्रॉपर्टी का नाम.
• exactMatchWithOperator सेटिंग.
• retrievalImportance सेटिंग.

हालांकि, इस सीमा का एक तरीका है.

स्कीमा में कोई जटिल बदलाव करना

ऐसे बदलावों से बचने के लिए जिनसे खोज के खराब नतीजे या खोज का इंडेक्स ठीक से काम न करता हो, डेटा स्टोर करने की जगह को इंडेक्स किए जाने के बाद, Cloud Search कुछ तरह के बदलावों को रोकता है. ये बदलाव UpdateSchema के अनुरोधों में किए जाते हैं. उदाहरण के लिए, किसी प्रॉपर्टी का डेटा टाइप या नाम सेट होने के बाद, उसे बदला नहीं जा सकता. ये बदलाव, सिर्फ़ UpdateSchema अनुरोध की मदद से नहीं किए जा सकते. भले ही, आपने डेटा को फिर से इंडेक्स किया हो.

ऐसी स्थितियों में, जब आपको अपने स्कीमा में कोई अनुमति नहीं है बदलाव करने की ज़रूरत होती है, तो आप अक्सर अनुमति दिए गए बदलावों की एक सीरीज़ कर सकते हैं जो एक जैसा असर दे सकते हैं. आम तौर पर, इसमें पहले इंडेक्स की गई प्रॉपर्टी को किसी पुरानी ऑब्जेक्ट परिभाषा से नई परिभाषा पर माइग्रेट करना शामिल होता है. इसके बाद, इंडेक्स करने का ऐसा अनुरोध भेजना होता है जिसमें सिर्फ़ नई प्रॉपर्टी का इस्तेमाल किया जाता है.

यहां किसी प्रॉपर्टी का डेटा टाइप या नाम बदलने का तरीका बताया गया है:

1. अपने स्कीमा में ऑब्जेक्ट की परिभाषा में नई प्रॉपर्टी जोड़ें. उस प्रॉपर्टी के नाम से अलग नाम का इस्तेमाल करें जिसे बदलना है.
2. UpdateSchema अनुरोध को नई परिभाषा के हिसाब से जारी करें. अनुरोध में पूरा स्कीमा भेजना न भूलें. इसमें नई और पुरानी, दोनों प्रॉपर्टी शामिल होनी चाहिए.

3. डेटा रिपॉज़िटरी से इंडेक्स को बैकफ़िल करें. इंडेक्स बैकफ़िल करने के लिए, नई प्रॉपर्टी का इस्तेमाल करके इंडेक्स करने के सभी अनुरोध भेजें, लेकिन पुरानी प्रॉपर्टी का इस्तेमाल न करें. ऐसा करने से, क्वेरी के मैच की गिनती दो बार हो जाएगी.

   1. डेटा बैकफ़िल करने के दौरान, नई प्रॉपर्टी की जांच करें और अलग-अलग तरह के व्यवहार से बचने के लिए, डिफ़ॉल्ट रूप से पुरानी प्रॉपर्टी पर सेट करें.
   2. बैकफ़िल पूरा होने के बाद, पुष्टि करने के लिए टेस्ट क्वेरी चलाएं.

4. पुरानी प्रॉपर्टी मिटाएं. पुरानी प्रॉपर्टी के नाम के बिना, UpdateSchema का एक और अनुरोध करें. साथ ही, आने वाले समय में इंडेक्स करने के अनुरोधों में, पुरानी प्रॉपर्टी के नाम का इस्तेमाल बंद करें.

5. पुरानी प्रॉपर्टी के इस्तेमाल को नई प्रॉपर्टी में माइग्रेट करें. उदाहरण के लिए, अगर आपने प्रॉपर्टी का नाम क्रिएटर से बदलकर लेखक कर दिया है, तो आपको अपने क्वेरी कोड को अपडेट करना होगा, ताकि जहां पहले क्रिएटर का रेफ़रंस दिया गया था वहां लेखक का इस्तेमाल किया जा सके.

Cloud Search, मिटाई गई किसी भी प्रॉपर्टी या ऑब्जेक्ट का रिकॉर्ड 30 दिनों तक रखता है. ऐसा इसलिए किया जाता है, ताकि उसे फिर से इस्तेमाल न किया जा सके. इससे, इंडेक्स करने के दौरान अनचाहे नतीजे मिलने से बचा जा सकता है. आपको 30 दिनों के अंदर, मिटाए गए ऑब्जेक्ट या प्रॉपर्टी के सभी इस्तेमाल को माइग्रेट कर देना चाहिए. साथ ही, आने वाले समय में इंडेक्स करने के अनुरोधों से भी उन्हें हटा देना चाहिए. इससे यह पक्का होता है कि अगर बाद में उस प्रॉपर्टी या ऑब्जेक्ट को फिर से शामिल करने का फ़ैसला लिया जाता है, तो ऐसा इस तरह किया जा सकता है कि आपके इंडेक्स में कोई गड़बड़ी न हो.

फ़ाइल के साइज़ की सीमाओं के बारे में जानकारी

Cloud Search, स्ट्रक्चर्ड डेटा ऑब्जेक्ट और स्कीमा के साइज़ की सीमाएं लागू करता है. ये सीमाएं हैं:

• टॉप-लेवल ऑब्जेक्ट की संख्या ज़्यादा से ज़्यादा 10 हो सकती है.
• स्ट्रक्चर्ड डेटा की हैरारकी में ज़्यादा से ज़्यादा 10 लेवल हो सकते हैं.
• किसी ऑब्जेक्ट में फ़ील्ड की कुल संख्या 1,000 तक सीमित होती है. इसमें प्राइमिटिव फ़ील्ड की संख्या के साथ-साथ, नेस्ट किए गए हर ऑब्जेक्ट में फ़ील्ड की संख्या का योग शामिल होता है.

अगले चरण

यहां कुछ ऐसे तरीके दिए गए हैं जिनका इस्तेमाल करके, इस समस्या को हल किया जा सकता है:

1. अपने स्कीमा की जांच करने के लिए, सर्च इंटरफ़ेस बनाएं.

2. खोज क्वालिटी को बेहतर बनाने के लिए, अपने स्कीमा को ट्यून करें.

3. क्वेरी को बेहतर तरीके से समझने के लिए स्कीमा का स्ट्रक्चर तैयार करें.

4. अपनी कंपनी में आम तौर पर इस्तेमाल होने वाले शब्दों के लिए, मिलते-जुलते शब्द तय करने के लिए, _dictionaryEntry स्कीमा का फ़ायदा पाने का तरीका जानें. _dictionaryEntry स्कीमा का इस्तेमाल करने के लिए, समानार्थी शब्द तय करना लेख पढ़ें.

5. कोई कनेक्टर बनाएं.