नॉलेज कैटलॉग की अहम जानकारी देखना

पूर्वावलोकन

इस प्रॉडक्ट या सुविधा पर, "Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं से जुड़ी शर्तें" लागू होती हैं. ये शर्तें, सेवा की खास शर्तें पेज पर 'सेवा की सामान्य शर्तें' सेक्शन में दी गई हैं. Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाएं, "जैसी हैं वैसी" ही उपलब्ध कराई जाती हैं. ऐसा हो सकता है कि इनके लिए आपको सीमित सहायता ही मिले. ज़्यादा जानने के लिए, लॉन्च के चरणों की जानकारी पढ़ें.

Cloud Firestore के संसाधनों को खोजने और उन्हें मैनेज करने के लिए, Cloud Firestore संसाधनों को Knowledge Catalog का इस्तेमाल किया जा सकता है. यह आपके मेटाडेटा को सेव करने, मैनेज करने, और ऐक्सेस करने का प्लैटफ़ॉर्म है. अपने मेटाडेटा का विश्लेषण करने के लिए, Knowledge Catalog Cloud Firestore का इस्तेमाल किया जा सकता है. साथ ही, इसका इस्तेमाल इन टास्क को पूरा करने में मदद पाने के लिए भी किया जा सकता है:

• विश्लेषण, जिसमें इस्तेमाल के उदाहरण के लिए, निर्भरताएं और सही जानकारी शामिल है
• चेंज मैनेजमेंट
• स्कीमा का क्रमिक विकास

नए और मौजूदा Cloud Firestore डेटाबेस पर, Knowledge Catalog डिफ़ॉल्ट रूप से चालू होता है. साथ ही, यह अपने-आप यह मेटाडेटा वापस पाता है:

संसाधन	टाइप	फ़ील्ड
डेटाबेस	कंट्रोल प्लेन	वर्शन मोड जगह की जानकारी (इसमें मल्टी-रीजन शामिल हैं) प्रोजेक्ट आईडी डेटाबेस का नाम बनाने का समय
डेटाबेस स्कीमा	डेटा प्लेन	नाम कलेक्शन फ़ील्ड - डेटा टाइप स्कीमा

शुरू करने से पहले

Knowledge Catalog API (dataplex.googleapis.com) को चालू करें.

• एपीआई चालू करने के लिए, आपके पास Service Usage Admin IAM की भूमिका roles/serviceusage.serviceUsageAdmin होनी चाहिए. इसमें serviceusage.services.enable की अनुमति शामिल होती है. भूमिकाएं देने का तरीका जानें.
• किसी एपीआई को चालू करने के लिए, एपीआई चालू करना लेख पढ़ें.

Cloud Firestore के साथ Knowledge Catalog की अहम जानकारी का इस्तेमाल करने के लिए, आपके पास Cloud Firestore डेटाबेस होना चाहिए. ज़्यादा जानकारी के लिए, डेटाबेस बनाना और मैनेज करना लेख पढ़ें.

खोज के नतीजों को ऐक्सेस करने के लिए ज़रूरी भूमिकाएं

Knowledge Catalog में Cloud Firestore के मेटाडेटा को खोजने और देखने के लिए, प्रिंसिपल के पास Cloud Firestore संसाधनों को देखने की अनुमतियां होनी चाहिए. इनमें dataplex.projects.search की अनुमति भी शामिल है.

प्रिंसिपल (जैसे कि उपयोगकर्ता, ग्रुप या सेवा खाते) को ये अनुमतियां देने के लिए, उन्हें उस प्रोजेक्ट पर Cloud Datastore Viewer (roles/datastore.viewer) IAM की भूमिका असाइन करें जिसमें Cloud Firestore संसाधन शामिल हैं.

Knowledge Catalog की कार्रवाई	Cloud Firestore संसाधन	ज़रूरी भूमिकाएं या अनुमतियां
Cloud Firestore संसाधन खोजना	डेटाबेस	datastore.databases.getMetadata
	डेटाबेस स्कीमा	datastore.schemas.get

भूमिकाएं देने के बारे में ज़्यादा जानने के लिए, ऐक्सेस मैनेज करना लेख पढ़ें. Cloud Firestore की IAM भूमिकाओं के बारे में ज़्यादा जानने के लिए, Cloud Firestore की भूमिकाएं और अनुमतियां लेख पढ़ें.

एंट्री खोजने के लिए ज़रूरी भूमिकाएं

एंट्री खोजने के लिए, आपके पास उस प्रोजेक्ट पर इनमें से कम से कम एक IAM की भूमिका होनी चाहिए जिसका इस्तेमाल खोज के लिए किया जाता है:

• Dataplex Catalog Admin (roles/dataplex.catalogAdmin)
• Dataplex Catalog Editor (roles/dataplex.catalogEditor)
• Dataplex Catalog Viewer (roles/dataplex.catalogViewer)

खोज के नतीजों पर अनुमतियां, चुने गए प्रोजेक्ट से अलग से देखी जाती हैं. ज़्यादा जानकारी के लिए, Knowledge Catalog की मदद से डेटा ऐसेट खोजना लेख पढ़ें.

मेटाडेटा खोजने के तरीके

Knowledge Catalog में मेटाडेटा खोजने की सुविधा, एक ऑटोमेटेड प्रोसेस है. यह कनेक्ट किए गए डेटा सोर्स (जैसे कि Cloud Firestore) को स्कैन करके, डेटा ऐसेट (जैसे कि कलेक्शन और डेटाबेस) की पहचान करती है. साथ ही, उनके तकनीकी मेटाडेटा (जैसे कि स्कीमा, ब्यौरे, और जगह की जानकारी) को Knowledge Catalog के कैटलॉग में एक्सट्रैक्ट करती है. यह प्रोसेस समय-समय पर चलती है, ताकि कैटलॉग को सोर्स सिस्टम के साथ सिंक रखा जा सके.

अहम जानकारी: Knowledge Catalog में दिखने के लिए, डेटाबेस और कलेक्शन ग्रुप के आईडी, नाम रखने के इस तरीके के मुताबिक होने चाहिए: इनमें सिर्फ़ अक्षर, संख्याएं या ""'-._~%%!$&'()*+,;=@/' में मौजूद वर्ण शामिल होने चाहिए. साथ ही, ये UUID फ़ॉर्मैट में नहीं होने चाहिए और खाली नहीं होने चाहिए. आईडी, स्लैश (/) से शुरू नहीं हो सकते या इनमें लगातार दो स्लैश (//) नहीं हो सकते.

कीवर्ड और आम भाषा में क्वेरी पूछने की सुविधा

Knowledge Catalog में, कीवर्ड और आम भाषा में क्वेरी पूछने की सुविधा उपलब्ध है.

• कीवर्ड खोज की मदद से, खास कीवर्ड, फ़िल्टर, और तय किए गए सिंटैक्स का इस्तेमाल करके संसाधन ढूंढे जा सकते हैं. उदाहरण के लिए, सभी Cloud Firestore डेटाबेस देखने के लिए, आप system=Firestore AND type=Database डाल सकते हैं.
• आम भाषा में क्वेरी पूछने की सुविधा (पूर्वावलोकन) में, सेमैंटिक क्वेरी को समझने के लिए एआई का इस्तेमाल किया जाता है. इसकी मदद से, रोज़मर्रा की भाषा का इस्तेमाल करके संसाधन ढूंढे जा सकते हैं. इसके लिए, जटिल सिंटैक्स की ज़रूरत नहीं होती. उदाहरण के लिए, List all Firestore databases related to sales जैसी क्वेरी डाली जा सकती हैं.

ज़्यादा जानकारी के लिए, Knowledge Catalog के लिए खोज का सिंटैक्स लेख पढ़ें.

उदाहरण: Cloud Firestore कलेक्शन ग्रुप का स्कीमा ढूंढना

मेटाडेटा खोजने की प्रोसेस को समझने के लिए, Cloud Firestore database named user-firestore-database का उदाहरण देखें. इस डेटाबेस में, user-schema नाम का कलेक्शन ग्रुप स्कीमा है.

मेटाडेटा खोजने की प्रोसेस पूरी होने के बाद, इन ऐसेट (user-firestore-database और user-schema) को Google Cloud console के Knowledge Catalog पेज पर या Knowledge Catalog API का इस्तेमाल करके खोजा जा सकता है. इसके बाद, ऐसेट के बारे में जानकारी देखी जा सकती है और उनमें कारोबार या ऑपरेशन से जुड़ा अतिरिक्त मेटाडेटा जोड़ा जा सकता है.

पहलूओं का इस्तेमाल करके मेटाडेटा को बेहतर बनाना

पहलू के टाइप ऐसेट होते हैं जिन्हें फिर से इस्तेमाल किया जा सकता है. इनका इस्तेमाल, पहलुओं के लिए टेंप्लेट के तौर पर किया जा सकता है. पहलू के टाइप की मदद से, काम को दोहराने और अधूरे पहलुओं से बचा जा सकता है. ज़रूरत के मुताबिक पहलू के टाइप बनाने के लिए, Knowledge Catalog का इस्तेमाल किया जा सकता है.

कस्टम पहलू के टाइप बनाने के बाद, आपके Cloud Firestore संसाधनों में पहलू जोड़े जा सकते हैं. अपने संसाधनों में पहलू जोड़ने से, ये काम किए जा सकते हैं:

• ऐसेट में कारोबार का मेटाडेटा जोड़ना
• कारोबार के मेटाडेटा और अन्य कस्टम मेटाडेटा के हिसाब से ऐसेट खोजना

पहलू के टाइप बनाने और Cloud Firestore में पहलू जोड़ने के बारे में ज़्यादा जानने के लिए, पहलू मैनेज करना और मेटाडेटा को बेहतर बनाना लेख पढ़ें.

ऐसेट खोजनाCloud Firestore

ऐसेट खोजने के लिए, Google Cloud console में Knowledge Catalog के खोज पेज का इस्तेमाल करें.Cloud Firestore

1. Knowledge Catalog के खोज पेज पर जाएं.

   खोज पर जाएं

2. **फ़िल्टर** पैनल में, **सिस्टम** पर क्लिक करें. इसके बाद, **Firestore** को चुनें.

3. ज़रूरी नहीं. टाइप के उपनाम में, किसी खास तरह की Cloud Firestore ऐसेट के लिए खोज के नतीजों को फ़िल्टर किया जा सकता है. इसके लिए, टाइप के इन उपनामों में से एक या एक से ज़्यादा को चुनें:

   • डेटाबेस
   • डेटाबेस स्कीमा
   • अन्य

कीवर्ड खोज करने के लिए क्वेरी का इस्तेमाल करना

कीवर्ड खोज की क्वेरी करने के लिए, Knowledge Catalog में खोज फ़ील्ड का इस्तेमाल किया जा सकता है. उदाहरण के लिए, system=Firestore AND type=Database डालकर, सभी Cloud Firestore डेटाबेस देखे जा सकते हैं.

ज़्यादा जानकारी के लिए, Knowledge Catalog के लिए खोज का सिंटैक्स लेख पढ़ें.

सभी Cloud Firestore ऐसेट देखने के लिए, system=Firestore डालें. खास कीवर्ड डाले जा सकते हैं. उदाहरण के लिए, सभी Cloud Firestore डेटाबेस देखने के लिए:

system=Firestore AND type=Database

जटिल एक्सप्रेशन के लिए, ब्रैकेट और लॉजिकल ऑपरेटर AND और OR का भी इस्तेमाल किया जा सकता है. खोज फ़ील्ड में इस्तेमाल किए जा सकने वाले एक्सप्रेशन के बारे में ज़्यादा जानने के लिए, Knowledge Catalog के लिए खोज का सिंटैक्स लेख पढ़ें.

खोज फ़ील्ड में, खास Cloud Firestore ऐसेट के लिए सीधे खोज क्वेरी डाली जा सकती हैं. क्वेरी स्ट्रिंग का फ़ॉर्मैट इस तरह होता है:

type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"

इन्हें बदलें:

• QUERY_STRING: जिस ऐसेट के बारे में क्वेरी करनी है उसके टाइप के आधार पर, क्वेरी स्ट्रिंग की पहचान करने के लिए, इस सूची का इस्तेमाल करें:Cloud Firestore

  • firestore-database
  • firestore-schema

क्वेरी का उदाहरण कुछ इस तरह दिख सकता है:

type="projects/1234567890/locations/global/entryTypes/firestore-schema"

पहलू के टाइप के हिसाब से खोजना

Knowledge Catalog में, पहलू के कुछ ऐसे टाइप शामिल हैं जिनका इस्तेमाल खोज करने के लिए किया जा सकता है.

पहलू के टाइप के हिसाब से खोजने के लिए, यह तरीका अपनाएं:

1. पहलू पैनल में, पहलू के और टाइप जोड़ें मेन्यू पर क्लिक करें.
2. Firestore डालें. इसके बाद, खोज के नतीजों को उस टाइप तक सीमित करने के लिए, पहलू के इन टाइप में से एक या एक से ज़्यादा को चुनें.
   • Cloud Firestore डेटाबेस
   • Cloud Firestore स्कीमा
3. ठीक है पर क्लिक करें.
4. नतीजों की टेबल में, ऐसेट का मेटाडेटा देखने के लिए, ऐसेट के नाम पर क्लिक करें.
5. ज़रूरी नहीं: अपनी ऐसेट को बेहतर बनाएं या देखें. इनमें से कोई भी काम किया जा सकता है:
   • ऐसेट की रिच टेक्स्ट जानकारी जोड़ने के लिए, खास जानकारी में जाकर, जोड़ें पर क्लिक करें .
   • ऐसेट में पहलू जोड़ने के लिए, पहलू में जाकर, जोड़ें पर क्लिक करें .
   • किसी इंस्टेंस के लिए सदस्य डेटाबेस देखने के लिए, एंट्री की सूची टैब पर क्लिक करें. इसके बाद, खोज में सभी चाइल्ड एंट्री दिखाएं पर क्लिक करें.
   • एंट्री की जानकारी में, ऐसेट की पूरी जानकारी देखें. अतिरिक्त एंट्री देखने के लिए, एंट्री के नाम पर क्लिक करें.

Cloud Firestore में आम भाषा में क्वेरी पूछने की सुविधा

आम भाषा में क्वेरी पूछने की सुविधा (पूर्वावलोकन) में, सेमैंटिक क्वेरी को समझने के लिए एआई का इस्तेमाल किया जाता है. इसकी मदद से, रोज़मर्रा की भाषा का इस्तेमाल करके संसाधन ढूंढे जा सकते हैं. इसके लिए, जटिल सिंटैक्स की ज़रूरत नहीं होती. उदाहरण के लिए, List all Firestore collections related to sales जैसी क्वेरी डाली जा सकती हैं.

ज़्यादा जानकारी के लिए, Knowledge Catalog के लिए खोज का सिंटैक्स लेख पढ़ें.

Cloud Firestore में सिंटैक्स के हिसाब से खोजना

कीवर्ड खोज की मदद से, खास कीवर्ड, फ़िल्टर, और तय किए गए सिंटैक्स का इस्तेमाल करके संसाधन ढूंढे जा सकते हैं. उदाहरण के लिए, सभी Cloud Firestore डेटाबेस देखने के लिए, आप system=Firestore AND type=Database डाल सकते हैं.

ज़्यादा जानकारी के लिए, Knowledge Catalog के लिए खोज का सिंटैक्स लेख पढ़ें.

वर्कफ़्लो का उदाहरण: डेटाबेस से स्कीमा तक ड्रिल-डाउन करना

डेटाबेस से स्कीमा तक ड्रिल-डाउन करने के लिए, यह तरीका अपनाएं:

1. Knowledge Catalog के खोज पेज पर जाएं.

   खोज पर जाएं

2. फ़िल्टर पैनल में, सिस्टम को चुनें. इसके बाद, Firestore को चुनें. इसके अलावा, खोज फ़ील्ड में system=Firestore डालें.

3. कोई डेटाबेस चुनें.

4. Firestore की जानकारी पेज पर, एंट्री की सूची टैब पर क्लिक करें. इसके बाद, खोज में सभी चाइल्ड एंट्री दिखाएं पर क्लिक करें.

   ध्यान दें: अगर एंट्री की सूची टैब नहीं है, तो खोज पेज पर वापस जाएं और कोई दूसरा डेटाबेस चुनें.

5. Firestore डेटाबेस की जानकारी पेज पर, एंट्री की सूची टैब पर क्लिक करें. इसके बाद, खोज में सभी चाइल्ड एंट्री दिखाएं पर क्लिक करें. Knowledge Catalog, डेटाबेस में मौजूद कलेक्शन ग्रुप दिखाता है.

6. कलेक्शन ग्रुप का कोई नाम चुनें. इसके बाद, कलेक्शन ग्रुप की जानकारी पेज पर, स्कीमा देखने के लिए स्कीमा पर क्लिक करें.

7. ज़रूरी नहीं: किसी डेटाबेस में पहलू का टाइप जोड़ने के लिए, पहलू जोड़ें बटन पर क्लिक करें.

कीमत

Knowledge Catalog में, Cloud Firestore तकनीकी मेटाडेटा को सेव करने के लिए कोई शुल्क नहीं लिया जाता. एपीआई कॉल और कारोबार के अतिरिक्त मेटाडेटा को बेहतर बनाने के लिए, Knowledge Catalog की सामान्य कीमत लागू होती है. ज़्यादा जानकारी के लिए, Knowledge Catalog की कीमत वाला पेज देखें.

सीमाएं

• 10,000 कलेक्शन ग्रुप शामिल किए जाने के बाद, क्वेरी के नतीजे काट दिए जाते हैं.
• बैच में डेटा शामिल करने के दौरान, आपके डेटाबेस में किए गए अपडेट को Knowledge Catalog में दिखने में 48 घंटे लग सकते हैं.
• लाइव डेटा शामिल करने के दौरान, आपके डेटाबेस में किए गए अपडेट को Knowledge Catalog में दिखने में पांच मिनट लग सकते हैं.
• लाइव डेटा शामिल करने के दौरान, कलेक्शन ग्रुप अपडेट नहीं किए जाते.
• लाइव डेटा शामिल करने के दौरान, कलेक्शन ग्रुप के स्कीमा अपडेट किए जाते हैं. हालांकि, इस अपडेट में वर्णमाला के क्रम में, टॉप-लेवल के सिर्फ़ पहले 100 प्रिमिटिव फ़ील्ड शामिल होते हैं. स्कीमा की बाकी जानकारी, लाइव डेटा शामिल करने के 24 से 48 घंटे बाद अपडेट की जाती है.
• डेटा एक्सट्रैक्ट करने की प्रोसेस में कुछ मिनट लग सकते हैं.

आगे क्या करना है

• Knowledge Catalog में डेटा कैटलॉग मैनेजमेंट के बारे में जानकारी
• Knowledge Catalog की पहचान और ऐक्सेस मैनेजमेंट की भूमिकाएं