Knowledge Catalog का इस्तेमाल करके, Cloud Firestore संसाधनों को खोजा और मैनेज किया जा सकता है. यह एक ऐसा प्लैटफ़ॉर्म है जहां मेटाडेटा को सेव, मैनेज, और ऐक्सेस किया जा सकता है. Knowledge Catalog का इस्तेमाल करके, आप अपने Cloud Firestore मेटाडेटा का विश्लेषण कर सकते हैं. इससे इन जैसे टास्क पूरे करने में मदद मिलती है:
- विश्लेषण, जिसमें इस्तेमाल के उदाहरण के लिए, निर्भरताएं और सही जानकारी शामिल है
- चेंज मैनेजमेंट
- स्कीमा का क्रमिक विकास
नए और मौजूदा Cloud Firestore डेटाबेस पर, Knowledge Catalog डिफ़ॉल्ट रूप से चालू होता है. यह अपने-आप इन मेटाडेटा को वापस पाता है:
| संसाधन | टाइप | फ़ील्ड |
|---|---|---|
| डेटाबेस | कंट्रोल प्लेन |
|
| डेटाबेस स्कीमा | डेटा प्लेन |
|
शुरू करने से पहले
Knowledge Catalog API (dataplex.googleapis.com) को चालू करें.
- एपीआई चालू करने के लिए, आपके पास 'सेवा उपयोग एडमिन' की आईएएम भूमिका
roles/serviceusage.serviceUsageAdminहोनी चाहिए. इसमेंserviceusage.services.enableअनुमति शामिल होती है. भूमिकाएं देने का तरीका जानें. - किसी एपीआई को चालू करने के लिए, एपीआई चालू करना लेख पढ़ें.
Cloud Firestore के साथ Knowledge Catalog की अहम जानकारी का इस्तेमाल करने के लिए, आपके पास Cloud Firestore डेटाबेस होना चाहिए. ज़्यादा जानकारी के लिए, डेटाबेस बनाना और मैनेज करना लेख पढ़ें.
खोज के नतीजे ऐक्सेस करने के लिए ज़रूरी भूमिकाएं
Knowledge Catalog में Cloud Firestore के मेटाडेटा को खोजने और देखने के लिए, प्रिंसिपल के पास Cloud Firestore के संसाधनों को देखने की अनुमतियां होनी चाहिए. इनमें dataplex.projects.search अनुमति भी शामिल है.
प्रिंसिपल (जैसे कि उपयोगकर्ता,
ग्रुप या सेवा खाते) को ये अनुमतियां देने के लिए, उन्हें
Cloud Datastore व्यूअर (roles/datastore.viewer)
की आईएएम भूमिका उस प्रोजेक्ट पर असाइन करें जिसमें Cloud Firestore
संसाधन हैं.
| Knowledge Catalog की कार्रवाई | Cloud Firestore संसाधन | ज़रूरी भूमिकाएं या अनुमतियां |
|---|---|---|
| Cloud Firestore संसाधन खोजना | डेटाबेस | datastore.databases.getMetadata |
| डेटाबेस स्कीमा | datastore.schemas.get |
भूमिकाएं देने के बारे में ज़्यादा जानने के लिए, ऐक्सेस मैनेज करना लेख पढ़ें. Cloud Firestore की आईएएम भूमिकाओं के बारे में ज़्यादा जानने के लिए, Cloud Firestore की भूमिकाएं और अनुमतियां लेख पढ़ें.
एंट्री खोजने के लिए ज़रूरी भूमिकाएं
एंट्री खोजने के लिए, आपके पास खोज के लिए इस्तेमाल किए जा रहे प्रोजेक्ट पर, इनमें से कम से कम एक आईएम भूमिका होनी चाहिए:
- Dataplex कैटलॉग एडमिन (
roles/dataplex.catalogAdmin) - Dataplex कैटलॉग एडिटर (
roles/dataplex.catalogEditor) - Dataplex कैटलॉग व्यूअर (
roles/dataplex.catalogViewer)
खोज के नतीजों पर अनुमतियां, चुने गए प्रोजेक्ट से अलग से देखी जाती हैं. ज़्यादा जानकारी के लिए, Knowledge Catalog की मदद से डेटा ऐसेट खोजना लेख पढ़ें.
मेटाडेटा खोजने के तरीके
Knowledge Catalog में मेटाडेटा खोजने की सुविधा, एक ऑटोमेटेड प्रोसेस है. यह कनेक्ट किए गए डेटा सोर्स (जैसे, Cloud Firestore) को स्कैन करके, डेटा ऐसेट (जैसे, कलेक्शन और डेटाबेस) की पहचान करती है. साथ ही, उनके तकनीकी मेटाडेटा (जैसे, स्कीमा, ब्यौरे, और जगह की जानकारी) को Knowledge Catalog के कैटलॉग में एक्सट्रैक्ट करती है. यह प्रोसेस समय-समय पर चलती है, ताकि कैटलॉग को सोर्स सिस्टम के साथ सिंक रखा जा सके.
कीवर्ड और आम भाषा में क्वेरी पूछने की सुविधा
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
Knowledge Catalog के खोज पेज पर जाएं.
**फ़िल्टर** पैनल में, **सिस्टम** पर क्लिक करें. इसके बाद, **Firestore** को चुनें.
ज़रूरी नहीं. टाइप के उपनाम में, किसी खास तरह की Cloud Firestore ऐसेट के लिए खोज के नतीजों को फ़िल्टर किया जा सकता है. इसके लिए, टाइप के इन उपनामों में से एक या एक से ज़्यादा को चुनें:
- डेटाबेस
- डेटाबेस स्कीमा
- अन्य
कीवर्ड की मदद से खोज करने के लिए, क्वेरी का इस्तेमाल करना
कीवर्ड की मदद से खोज करने के लिए, Knowledge Catalog में खोज फ़ील्ड का इस्तेमाल किया जा सकता है. उदाहरण के लिए, सभी Cloud Firestore डेटाबेस देखने के लिए,
system=Firestore AND type=Database डाला जा सकता है.
ज़्यादा जानकारी के लिए, 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 Firestorefirestore-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 जैसी क्वेरी डाली जा सकती हैं.
ज़्यादा जानकारी के लिए, Knowledge Catalog के लिए खोज का सिंटैक्स लेख पढ़ें.
Cloud Firestore में सिंटैक्स की मदद से खोजना
कीवर्ड की मदद से खोज करने पर, खास कीवर्ड, फ़िल्टर, और तय किए गए सिंटैक्स का इस्तेमाल करके संसाधन ढूंढे जा सकते हैं. उदाहरण के लिए, सभी Cloud Firestore डेटाबेस देखने के लिए, system=Firestore AND type=Database
डाला जा सकता है.
ज़्यादा जानकारी के लिए, Knowledge Catalog के लिए खोज का सिंटैक्स लेख पढ़ें.
वर्कफ़्लो का उदाहरण: डेटाबेस से स्कीमा तक ड्रिल-डाउन करना
किसी डेटाबेस से स्कीमा तक ड्रिल-डाउन करने के लिए, यह तरीका अपनाएं:
Knowledge Catalog के खोज पेज पर जाएं.
फ़िल्टर पैनल में, सिस्टम को चुनें. इसके बाद, Firestore को चुनें. इसके अलावा, खोज फ़ील्ड में
system=Firestoreडालें.कोई डेटाबेस चुनें.
Firestore की जानकारी पेज पर, एंट्री की सूची टैब पर क्लिक करें. इसके बाद, खोज में सभी चाइल्ड एंट्री दिखाएं पर क्लिक करें.
Firestore डेटाबेस की जानकारी पेज पर, एंट्री की सूची टैब पर क्लिक करें. इसके बाद, खोज में सभी चाइल्ड एंट्री दिखाएं पर क्लिक करें. Knowledge Catalog, डेटाबेस में मौजूद कलेक्शन ग्रुप दिखाता है.
कलेक्शन ग्रुप का कोई नाम चुनें. इसके बाद, कलेक्शन ग्रुप की जानकारी पेज पर, स्कीमा देखने के लिए स्कीमा पर क्लिक करें.
ज़रूरी नहीं: किसी डेटाबेस में पहलू का कोई टाइप जोड़ने के लिए, पहलू जोड़ें बटन पर क्लिक करें.
कीमत
Knowledge Catalog में, Cloud Firestore तकनीकी मेटाडेटा को सेव करने के लिए कोई शुल्क नहीं लिया जाता. एपीआई कॉल और कारोबार के अतिरिक्त मेटाडेटा को बेहतर बनाने के लिए, Knowledge Catalog की सामान्य कीमत लागू होती है. ज़्यादा जानकारी के लिए, Knowledge Catalog की कीमत वाला पेज देखें.
सीमाएं
- 10,000 कलेक्शन ग्रुप को शामिल करने के बाद, क्वेरी के नतीजे काट दिए जाते हैं.
- बैच में डेटा शामिल करने के दौरान, Knowledge Catalog में आपके डेटाबेस में किए गए अपडेट दिखने में 48 घंटे लग सकते हैं.
- लाइव डेटा शामिल करने के दौरान, Knowledge Catalog में आपके डेटाबेस में किए गए अपडेट दिखने में पांच मिनट लग सकते हैं.
- लाइव डेटा शामिल करने के दौरान, कलेक्शन ग्रुप अपडेट नहीं किए जाते.
- लाइव डेटा शामिल करने के दौरान, कलेक्शन ग्रुप के स्कीमा अपडेट किए जाते हैं. हालांकि, इस अपडेट में वर्णमाला के क्रम में, टॉप-लेवल के सिर्फ़ पहले 100 प्रिमिटिव फ़ील्ड शामिल होते हैं. लाइव डेटा शामिल करने के 24 से 48 घंटे बाद, स्कीमा की बाकी जानकारी अपडेट की जाती है.
- डेटा एक्सट्रैक्ट करने की प्रोसेस में कुछ मिनट लग सकते हैं.
आगे क्या करना है
- Knowledge Catalog में डेटा कैटलॉग मैनेजमेंट के बारे में जानकारी
- Knowledge Catalog की पहचान और ऐक्सेस मैनेजमेंट की भूमिकाएं