Knowledge Catalog का इस्तेमाल करके, Cloud Firestore के संसाधनों को खोजा और मैनेज किया जा सकता है. यह एक ऐसा प्लैटफ़ॉर्म है जहां मेटाडेटा को सेव, मैनेज, और ऐक्सेस किया जा सकता है. Knowledge Catalog का इस्तेमाल करके, Cloud Firestore के मेटाडेटा का विश्लेषण किया जा सकता है. साथ ही, इन कामों में मदद पाई जा सकती है:
- विश्लेषण, जिसमें डिपेंडेंसी और इस्तेमाल के उदाहरण के लिए सही होना शामिल है
- चेंज मैनेजमेंट
- स्कीमा में बदलाव
नॉलेज कैटलॉग की सुविधा, नए और मौजूदा Cloud Firestore डेटाबेस पर डिफ़ॉल्ट रूप से चालू होती है. साथ ही, यह इस मेटाडेटा को अपने-आप हासिल करती है:
| संसाधन | टाइप | फ़ील्ड |
|---|---|---|
| डेटाबेस | कंट्रोल प्लेन |
|
| डेटाबेस स्कीमा | डेटा प्लेन |
|
शुरू करने से पहले
Knowledge Catalog API (dataplex.googleapis.com) को चालू करें.
- एपीआई चालू करने से पहले, आपके पास Service Usage Admin IAM रोल
roles/serviceusage.serviceUsageAdminहोना चाहिए. इसमेंserviceusage.services.enableअनुमति शामिल होती है. भूमिकाएं असाइन करने का तरीका जानें. - किसी एपीआई को चालू करने के लिए, एपीआई चालू करना लेख पढ़ें.
Cloud Firestore के साथ नॉलेज कैटलॉग की अहम जानकारी का इस्तेमाल करने के लिए, आपके पास पहले से Cloud Firestore डेटाबेस होना चाहिए. ज़्यादा जानकारी के लिए, डेटाबेस बनाना और मैनेज करना लेख पढ़ें.
खोज के नतीजे ऐक्सेस करने के लिए ज़रूरी भूमिकाएं
Knowledge Catalog में Cloud Firestore का मेटाडेटा खोजने और देखने के लिए, प्रिंसिपल के पास Cloud Firestore के संसाधनों को देखने की अनुमतियां होनी चाहिए. इसमें dataplex.projects.search अनुमति भी शामिल है.
उपयोगकर्ताओं, ग्रुप या सेवा खातों जैसे मुख्य खातों को ये अनुमतियां देने के लिए, उन्हें उस प्रोजेक्ट पर Cloud Datastore Viewer (roles/datastore.viewer) IAM भूमिका असाइन करें जिसमें Cloud Firestore संसाधन मौजूद हैं.
| नॉलेज कैटलॉग ऑपरेशन | Cloud Firestore संसाधन | ज़रूरी भूमिकाएं या अनुमतियां |
|---|---|---|
| Cloud Firestore संसाधन खोजें | डेटाबेस | datastore.databases.getMetadata |
| डेटाबेस स्कीमा | datastore.schemas.get |
भूमिकाएं देने के बारे में ज़्यादा जानने के लिए, ऐक्सेस मैनेज करना लेख पढ़ें. Cloud Firestore IAM की भूमिकाओं के बारे में ज़्यादा जानने के लिए, Cloud Firestore की भूमिकाएं और अनुमतियां लेख पढ़ें.
एंट्री खोजने के लिए ज़रूरी भूमिकाएं
एंट्री खोजने के लिए, आपके पास खोज के लिए इस्तेमाल किए गए प्रोजेक्ट पर, इनमें से कम से कम एक आईएएम भूमिका होनी चाहिए:
- Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) - Dataplex Catalog Editor (
roles/dataplex.catalogEditor) - Dataplex Catalog Viewer (
roles/dataplex.catalogViewer)
खोज के नतीजों पर अनुमतियों की जांच, चुने गए प्रोजेक्ट से अलग की जाती है. ज़्यादा जानकारी के लिए, Knowledge Catalog की मदद से डेटा ऐसेट खोजना लेख पढ़ें.
मेटाडेटा खोजने के तरीके
नॉलेज कैटलॉग में मेटाडेटा खोजने की सुविधा, एक ऑटोमेटेड प्रोसेस है. यह Cloud Firestore जैसे कनेक्ट किए गए डेटा सोर्स को स्कैन करती है, ताकि डेटा ऐसेट (जैसे, कलेक्शन और डेटाबेस) की पहचान की जा सके. साथ ही, स्कीमा, ब्यौरे, और जगहों की जानकारी जैसे तकनीकी मेटाडेटा को नॉलेज कैटलॉग में एक्सट्रैक्ट किया जा सके. यह प्रोसेस समय-समय पर चलती है, ताकि कैटलॉग को सोर्स सिस्टम के साथ सिंक रखा जा सके.
कीवर्ड और बोलचाल की भाषा में क्वेरी पूछने की सुविधा
नॉलेज कैटलॉग में, कीवर्ड और बोलचाल की भाषा में क्वेरी पूछने की सुविधा काम करती है.
- कीवर्ड सर्च की मदद से, खास कीवर्ड, फ़िल्टर, और तय किए गए सिंटैक्स का इस्तेमाल करके रिसॉर्स ढूंढे जा सकते हैं. उदाहरण के लिए, सभी Cloud Firestore डेटाबेस देखने के लिए,
system=Firestore AND type=Databaseडालें. - बोलचाल की भाषा में क्वेरी पूछने की सुविधा (झलक), सिमैंटिक क्वेरी को समझने के लिए एआई का इस्तेमाल करती है. इसकी मदद से, आम बोलचाल की भाषा का इस्तेमाल करके संसाधन ढूंढे जा सकते हैं. इससे मुश्किल सिंटैक्स की ज़रूरत नहीं पड़ती. उदाहरण के लिए,
List all Firestore databases related to salesजैसी क्वेरी डाली जा सकती हैं.
ज़्यादा जानकारी के लिए, नॉलेज कैटलॉग के लिए खोज सिंटैक्स देखें.
उदाहरण: Cloud Firestore कलेक्शन ग्रुप स्कीमा के बारे में जानें
मेटाडेटा खोजने की प्रोसेस को समझने के लिए, user-firestore-database नाम के Cloud Firestore
डेटाबेस का उदाहरण लें. इस डेटाबेस में, आपके पास user-schema नाम का कलेक्शन ग्रुप स्कीमा है.
डिस्कवरी की प्रोसेस पूरी होने के बाद, इन ऐसेट को खोजा जा सकता है - user-firestore-database
और user-schema - Google Cloud console के नॉलेज कैटलॉग पेज पर या नॉलेज कैटलॉग एपीआई का इस्तेमाल करके.
इसके बाद, ऐसेट की जानकारी देखी जा सकती है. साथ ही, कारोबार या ऑपरेशन से जुड़े अन्य मेटाडेटा की मदद से, ऐसेट को बेहतर बनाया जा सकता है.
आस्पेक्ट का इस्तेमाल करके मेटाडेटा को बेहतर बनाना
आस्पेक्ट टाइप, फिर से इस्तेमाल किए जा सकने वाले ऐसे संसाधन होते हैं जिन्हें आस्पेक्ट के लिए टेंप्लेट के तौर पर इस्तेमाल किया जा सकता है. आस्पेक्ट टाइप की मदद से, डुप्लीकेट काम और अधूरे आस्पेक्ट से बचा जा सकता है. अपनी ज़रूरत के हिसाब से एस्पेक्ट टाइप बनाने के लिए, नॉलेज कैटलॉग का इस्तेमाल किया जा सकता है.
कस्टम एस्पेक्ट टाइप बनाने के बाद, एस्पेक्ट को अपने Cloud Firestore संसाधनों से अटैच किया जा सकता है. अपने संसाधनों में एस्पेक्ट अटैच करने पर, ये काम किए जा सकते हैं:
- ऐसेट में कारोबार का मेटाडेटा जोड़ना
- कारोबार के मेटाडेटा और अन्य कस्टम मेटाडेटा के हिसाब से ऐसेट खोजना
आस्पेक्ट टाइप बनाने और Cloud Firestore में आस्पेक्ट अटैच करने के बारे में ज़्यादा जानने के लिए, आस्पेक्ट मैनेज करना और मेटाडेटा को बेहतर बनाना लेख पढ़ें.
Cloud Firestore ऐसेट खोजें
Cloud Firestore ऐसेट खोजने के लिए, Google Cloud console में नॉलेज कैटलॉग के खोज वाले पेज का इस्तेमाल करें.
Knowledge Catalog के Search पेज पर जाएं.
फ़िल्टर पैनल में, सिस्टम पर क्लिक करें. इसके बाद, Firestore को चुनें.
ज़रूरी नहीं. टाइप के उपनाम में, खोज के नतीजों को किसी खास तरह की Cloud Firestore ऐसेट के हिसाब से फ़िल्टर किया जा सकता है. इसके लिए, नीचे दिए गए टाइप के उपनामों में से एक या उससे ज़्यादा चुनें:
- डेटाबेस
- डेटाबेस स्कीमा
- अन्य
कीवर्ड खोजने के लिए क्वेरी का इस्तेमाल करना
कीवर्ड सर्च क्वेरी करने के लिए, नॉलेज कैटलॉग में खोज फ़ील्ड का इस्तेमाल किया जा सकता है. उदाहरण के लिए, सभी Cloud Firestore डेटाबेस देखने के लिए, system=Firestore AND type=Database डालें.
ज़्यादा जानकारी के लिए, नॉलेज कैटलॉग के लिए खोज सिंटैक्स देखें.
सभी Cloud Firestore ऐसेट देखने के लिए, system=Firestore डालें. आपके पास खास कीवर्ड
डालने का विकल्प है. उदाहरण के लिए, सभी Cloud Firestore डेटाबेस देखने के लिए:
system=Firestore AND type=Database
जटिल एक्सप्रेशन के लिए, ब्रैकेट और लॉजिकल ऑपरेटर AND और OR का भी इस्तेमाल किया जा सकता है. खोज फ़ील्ड में इस्तेमाल किए जा सकने वाले एक्सप्रेशन के बारे में ज़्यादा जानने के लिए, नॉलेज कैटलॉग के लिए खोज सिंटैक्स देखें.
खोज फ़ील्ड में, सीधे तौर पर Cloud Firestore की खास ऐसेट के लिए सर्च क्वेरी डाली जा सकती हैं. क्वेरी स्ट्रिंग का फ़ॉर्मैट इस तरह है:
type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"
इनकी जगह ये डालें:
QUERY_STRING: आपको जिस तरह की Cloud Firestore ऐसेट के बारे में क्वेरी करनी है उसके आधार पर क्वेरी स्ट्रिंग की पहचान करने के लिए, इस सूची का इस्तेमाल करें:firestore-databasefirestore-schema
क्वेरी का एक उदाहरण यहां दिया गया है:
type="projects/1234567890/locations/global/entryTypes/firestore-schema"
आस्पेक्ट टाइप के हिसाब से खोजना
Knowledge Catalog में कुछ पहले से मौजूद एस्पेक्ट टाइप शामिल होते हैं. इनका इस्तेमाल करके, खोज की जा सकती है.
आस्पेक्ट टाइप के हिसाब से खोजने के लिए, यह तरीका अपनाएं:
- आस्पेक्ट पैनल में, ज़्यादा आस्पेक्ट टाइप जोड़ें मेन्यू पर क्लिक करें.
Firestoreडालें. इसके बाद, खोज के नतीजों को उस टाइप तक सीमित करने के लिए, इनमें से एक या उससे ज़्यादा आसपेक्ट टाइप चुनें.- Cloud Firestore डेटाबेस
- Cloud Firestore स्कीमा
- ठीक है पर क्लिक करें.
- नतीजों की टेबल में, ऐसेट का नाम क्लिक करके उस ऐसेट का मेटाडेटा देखें.
- ज़रूरी नहीं: अपनी ऐसेट को बेहतर बनाएं या देखें. इनमें से कोई भी काम किया जा सकता है:
- ऐसेट के लिए रिच टेक्स्ट वाला ब्यौरा जोड़ने के लिए, खास जानकारी में जाकर, जोड़ें पर क्लिक करें .
- ऐसेट में कोई पहलू अटैच करने के लिए, पहलू में जाकर, जोड़ें पर क्लिक करें .
- किसी इंस्टेंस के लिए सदस्य डेटाबेस देखने के लिए, एंट्री लिस्ट टैब पर क्लिक करें. इसके बाद, खोज में सभी चाइल्ड एंट्री दिखाएं पर क्लिक करें.
- एंट्री की जानकारी में, ऐसेट की पूरी जानकारी देखें. अन्य एंट्री देखने के लिए, एंट्री के नाम पर क्लिक करें.
Cloud Firestore में बोलचाल की भाषा में क्वेरी पूछने की सुविधा
बोलचाल की भाषा में क्वेरी पूछने की सुविधा (झलक), सिमैंटिक क्वेरी को समझने के लिए एआई का इस्तेमाल करती है. इसकी मदद से, आम बोलचाल की भाषा का इस्तेमाल करके संसाधन ढूंढे जा सकते हैं. इससे मुश्किल सिंटैक्स की ज़रूरत नहीं पड़ती. उदाहरण के लिए, List all Firestore collections related to sales जैसी क्वेरी डाली जा सकती हैं.
ज़्यादा जानकारी के लिए, नॉलेज कैटलॉग के लिए खोज सिंटैक्स देखें.
Cloud Firestore में सिंटैक्स खोजें
कीवर्ड सर्च की मदद से, खास कीवर्ड, फ़िल्टर, और तय किए गए सिंटैक्स का इस्तेमाल करके रिसॉर्स ढूंढे जा सकते हैं. उदाहरण के लिए, सभी Cloud Firestore डेटाबेस देखने के लिए, system=Firestore AND type=Database डालें.
ज़्यादा जानकारी के लिए, नॉलेज कैटलॉग के लिए खोज सिंटैक्स देखें.
वर्कफ़्लो का उदाहरण: डेटाबेस से स्कीमा तक ड्रिल डाउन करना
डेटाबेस से स्कीमा पर ड्रिल डाउन करने के लिए, यह तरीका अपनाएं:
Knowledge Catalog के Search पेज पर जाएं.
फ़िल्टर पैनल में, सिस्टम और फिर Firestore को चुनें. इसके अलावा, खोज फ़ील्ड में
system=Firestoreडालें.कोई डेटाबेस चुनें.
Firestore की जानकारी पेज पर, एंट्री की सूची टैब पर क्लिक करें. इसके बाद, खोज में सभी चाइल्ड एंट्री दिखाएं पर क्लिक करें.
Firestore डेटाबेस की जानकारी पेज पर, एंट्री की सूची टैब पर क्लिक करें. इसके बाद, खोज में सभी चाइल्ड एंट्री दिखाएं पर क्लिक करें. नॉलेज कैटलॉग, डेटाबेस में मौजूद कलेक्शन ग्रुप दिखाता है.
किसी कलेक्शन ग्रुप का नाम चुनें. इसके बाद, कलेक्शन ग्रुप की जानकारी पेज पर, स्कीमा देखने के लिए स्कीमा पर क्लिक करें.
ज़रूरी नहीं: किसी डेटाबेस में कोई पहलू जोड़ने के लिए, पहलू जोड़ें बटन पर क्लिक करें.
कीमत
नॉलेज कैटलॉग में Cloud Firestore टेक्निकल मेटाडेटा सेव करने के लिए कोई शुल्क नहीं लिया जाता. एपीआई कॉल और कारोबार के अतिरिक्त मेटाडेटा को बेहतर बनाने के लिए, नॉलेज कैटलॉग की स्टैंडर्ड कीमत लागू होती है. ज़्यादा जानकारी के लिए, Knowledge Catalog का कीमत वाला पेज देखें.
सीमाएं
- कलेक्शन के 10,000 ग्रुप शामिल किए जाने के बाद, क्वेरी के नतीजे काट दिए जाते हैं.
- बैच डेटा डालने की प्रोसेस के दौरान, आपके डेटाबेस में किए गए अपडेट को नॉलेज कैटलॉग में दिखने में 48 घंटे लग सकते हैं.
- लाइव डेटा डालने के दौरान, आपके डेटाबेस में किए गए अपडेट को नॉलेज कैटलॉग में दिखने में पांच मिनट लग सकते हैं.
- लाइव डेटा डालने के दौरान, कलेक्शन ग्रुप अपडेट नहीं होते.
- लाइव डेटा डालने के दौरान, कलेक्शन ग्रुप स्कीमा अपडेट किए जाते हैं. हालांकि, इस अपडेट में वर्णमाला के क्रम में, टॉप-लेवल के सिर्फ़ पहले 100 प्रिमिटिव फ़ील्ड शामिल होते हैं. स्कीमा की बाकी जानकारी, लाइव डेटा डालने के 24 से 48 घंटों के बाद अपडेट की जाती है.
- एक्सट्रैक्ट होने में कुछ मिनट लग सकते हैं.
आगे क्या करना है
- Knowledge Catalog में डेटा कैटलॉग मैनेजमेंट के बारे में जानकारी
- Knowledge Catalog के लिए, पहचान और ऐक्सेस मैनेजमेंट की भूमिकाएं