می‌توانید منابع Cloud Firestore را بااستفاده از Knowledge Catalog جستجو و مدیریت کنید. Knowledge Catalog پلاتفرمی برای ذخیره، مدیریت، و دسترسی به فراداده‌های شما است. می‌توانید از Knowledge Catalog برای تجزیه‌وتحلیل فراداده‌های Cloud Firestore و کمک به انجام کارهایی مثل موارد زیر استفاده کنید:
- تجزیه‌وتحلیل، ازجمله وابستگی‌ها و مناسب بودن برای یک مورد استفاده
- مدیریت تغییر
- تکامل طرحواره
«کاتالوگ دانش» به‌طور پیش‌فرض در پایگاه‌های داده جدید و موجود Cloud Firestore فعال است و فراداده‌های زیر را به‌طور خودکار بازیابی می‌کند:
| منبع | نوع | فیلدها |
|---|---|---|
| پایگاه داده | صفحه کنترل |
|
| طرح پایگاه داده | صفحه داده |
|
قبل از شروع
Knowledge Catalog API (dataplex.googleapis.com) را فعال کنید.
- قبل‌از اینکه بتوانید میاناهای برنامه‌سازی کاربردی را فعال کنید، به نقش IAM «سرپرست استفاده از سرویس»
roles/serviceusage.serviceUsageAdminنیاز دارید، که حاوی اجازهserviceusage.services.enableاست. با نحوه اعطای نقش آشنا شوید. - برای فعال کردن میانای برنامه‌سازی کاربردی، فعال کردن میانای برنامه‌سازی کاربردی را ببینید.
برای استفاده از اطلاعات آماری «کاتالوگ دانش» با Cloud Firestore، باید ابتدا پایگاه داده Cloud Firestore داشته باشید. برای اطلاعات بیشتر، ایجاد و مدیریت پایگاه‌های داده را ببینید.
نقش‌های لازم برای دسترسی به نتایج جستجو
برای جستجو و مشاهده فراداده‌های Cloud Firestore در
Knowledge Catalog، مدیران باید برای مشاهده منابع Cloud Firestore،
ازجمله اجازه dataplex.projects.search،
اجازه داشته باشند.
برای اعطای این اجازه‌ها به مدیران - مانند کاربران،
گروه‌ها، یا حساب‌های سرویس - نقش IAM
Cloud Datastore Viewer (roles/datastore.viewer)
را در پروژه‌ای که حاوی منابع Cloud Firestore است
به آن‌ها اختصاص دهید.
| عملیات کاتالوگ دانش | Cloud Firestore منبع | نقش‌ها یا اجازه‌های لازم |
|---|---|---|
| جستجوی منابع Cloud Firestore | پایگاه داده | datastore.databases.getMetadata |
| طرح پایگاه داده | datastore.schemas.get |
برای اطلاعات بیشتر درباره اعطای نقش‌ها، مدیریت دسترسی را ببینید. برای اطلاعات بیشتر درباره نقش‌های IAM Cloud Firestore، نقش‌ها و اجازه‌های Cloud Firestore را ببینید.
نقش‌های لازم برای جستجوی ورودی‌ها
برای جستجوی ورودی‌ها، به حداقل یکی از نقش‌های IAM زیر در پروژه‌ای که برای جستجو استفاده می‌شود نیاز دارید:
- Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) - Dataplex Catalog Editor (
roles/dataplex.catalogEditor) - Dataplex Catalog Viewer (
roles/dataplex.catalogViewer)
اجازه‌های نتایج جستجو مستقل از پروژه انتخاب‌شده بررسی می‌شود. برای اطلاعات بیشتر، جستجوی دارایی‌های داده با Knowledge Catalog را ببینید.
انواع کاوش فراداده
شناسایی فراداده‌های «کاتالوگ دانش» فرایندی خودکار است که منابع داده متصل (مانند Cloud Firestore) را اسکن می‌کند تا دارایی‌های داده (مانند مجموعه‌ها و پایگاه‌های داده) را شناسایی کند و فراداده‌های فنی آن‌ها (مانند طرح‌واره‌ها، توضیحات، و مکان‌ها) را در کاتالوگ «کاتالوگ دانش» استخراج کند. این فرایند به‌طور دوره‌ای اجرا می‌شود تا کاتالوگ با سیستم‌های منبع همگام‌سازی شود.
جستجوی کلیدواژه و زبان طبیعی
«کاتالوگ دانش» از جستجوی کلیدواژه‌ای و زبان طبیعی پشتیبانی می‌کند.
- جستجوی کلیدواژه به شما امکان می‌دهد منابع را بااستفاده از کلیدواژه‌های خاص، فیلترها، و نحو تعریف‌شده پیدا کنید. برای مثال، می‌توانید
system=Firestore AND type=Databaseرا وارد کنید تا همه پایگاه‌های داده Cloud Firestore را مشاهده کنید. - «جستجو به زبان طبیعی» (پیش‌نمایش) از هوش مصنوعی برای درک پُرسمان‌های معنایی استفاده می‌کند. این ابزار به شما امکان می‌دهد منابع را بااستفاده از زبان روزمره پیدا کنید و نیاز به نحو پیچیده را ازبین می‌برد. برای مثال، می‌توانید پُرسمان‌هایی مثل
List all Firestore databases related to salesرا وارد کنید.
برای اطلاعات بیشتر، نحو جستجو برای Knowledge Catalog را ببینید.
مثال: کاوش طرحواره گروه مجموعه Cloud Firestore
برای درک فرایند کشف فراداده، Cloud Firestore
پایگاه داده‌ای به‌نام user-firestore-database را درنظر بگیرید. در این پایگاه داده،
طرحواره گروه مجموعه‌ای با نام user-schema دارید.
پس‌از تکمیل کاوش، می‌توانید این دارایی‌ها - user-firestore-database
و user-schema - را در صفحه «کاتالوگ دانش»
کنسول Google Cloud یا بااستفاده از Knowledge Catalog API جستجو کنید.
سپس می‌توانید جزئیات مربوط به دارایی‌ها را مشاهده کنید و آن‌ها را با فراداده‌های تجاری یا عملیاتی اضافی غنی کنید.
غنی‌سازی فراداده بااستفاده از جنبه‌ها
انواع جنبه منابع قابل‌استفاده مجددی هستند که می‌توانید به‌عنوان الگو برای جنبه‌ها استفاده کنید. انواع جنبه به شما کمک می‌کند از تکرار کار و جنبه‌های ناقص اجتناب کنید. می‌توانید از Knowledge Catalog برای ایجاد انواع جنبه‌های موردنیازتان استفاده کنید.
پس‌از ایجاد انواع جنبه‌های سفارشی، می‌توانید جنبه‌ها را به منابع Cloud Firestore خود پیوست کنید. پیوست کردن جنبه‌ها به منابعتان به شما امکان می‌دهد کارهای زیر را انجام دهید:
- فراداده کسب‌وکار را به دارایی‌ها اضافه کنید
- جستجوی دارایی‌ها براساس فراداده کسب‌وکار و سایر فراداده‌های سفارشی
برای کسب اطلاعات بیشتر درباره ایجاد انواع جنبه و پیوست کردن جنبه‌ها به Cloud Firestore، مدیریت جنبه‌ها و غنی‌سازی فراداده را ببینید.
جستجوی دارایی‌های Cloud Firestore
از صفحه جستجوی «کاتالوگ دانش» در کنسول Google Cloud برای جستجوی دارایی‌های Cloud Firestore استفاده کنید.
به صفحه جستجوی کاتالوگ دانش بروید.
در پانل فیلترها، روی سیستم‌ها کلیک کنید و سپس Firestore را انتخاب کنید.
اختیاری است. در نام‌های مستعار نوع، می‌توانید نتایج جستجو را به نوع خاصی از دارایی Cloud Firestore فیلتر کنید، با انتخاب یک یا چند نام مستعار نوع زیر:
- پایگاه داده
- طرح پایگاه داده
- غیره
از پُرسمان‌ها برای جستجوی کلیدواژه استفاده کند
می‌توانید از فیلد جستجو در «کاتالوگ دانش» برای انجام
پرسمان‌های جستجوی کلیدواژه استفاده کنید. برای مثال، می‌توانید
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-databasefirestore-schema
یک پُرسمان نمونه ممکن است شبیه به این باشد:
type="projects/1234567890/locations/global/entryTypes/firestore-schema"
جستجو براساس نوع جنبه
«کاتالوگ دانش» شامل چند نوع جنبه داخلی است که می‌توانید از آن‌ها برای انجام جستجو استفاده کنید.
برای جستجو براساس نوع جنبه، این مراحل را دنبال کنید:
- در پانل جنبه‌ها، روی منو افزودن انواع جنبه‌های بیشتر کلیک کنید.
Firestoreرا وارد کنید، سپس یک یا چند نوع جنبه زیر را انتخاب کنید تا نتایج جستجو به آن نوع محدود شود.- پایگاه داده Cloud Firestore
- طرحواره Cloud Firestore
- روی تأیید کلیک کنید.
- در جدول نتایج، روی نام دارایی کلیک کنید تا فراداده آن دارایی را مشاهده کنید.
- اختیاری: دارایی‌هایتان را بهبود دهید یا مشاهده کنید. می‌توانید هرکدام از کارهای زیر را انجام دهید:
- برای افزودن شرح نوشتار غنی‌شده از دارایی، در نمای کلی، روی افزودن کلیک کنید .
- برای پیوست کردن یک جنبه به دارایی، در جنبه‌ها، روی افزودن کلیک کنید .
- برای مشاهده پایگاه‌های داده عضو برای یک نمونه، روی برگه فهرست ورودی کلیک کنید، و سپس روی نمایش همه ورودی‌های فرزند در جستجو کلیک کنید.
- در جزئیات ورودی، جزئیات کامل دارایی را مشاهده کنید. روی نام ورودی کلیک کنید تا به ورودی‌های دیگر بروید.
جستجو به زبان طبیعی در Cloud Firestore
«جستجو به زبان طبیعی» (پیش‌نمایش) از هوش مصنوعی برای درک پُرسمان‌های معنایی استفاده می‌کند. این ابزار به شما امکان می‌دهد منابع را بااستفاده از زبان روزمره پیدا کنید و نیاز به نحو پیچیده را ازبین می‌برد. برای مثال، می‌توانید پُرسمان‌هایی مثل
List all Firestore collections related to sales را وارد کنید.
برای اطلاعات بیشتر، نحو جستجو برای Knowledge Catalog را ببینید.
جستجوی نحو در Cloud Firestore
جستجوی کلیدواژه به شما امکان می‌دهد منابع را بااستفاده از کلیدواژه‌های خاص، فیلترها، و نحو تعریف‌شده پیدا کنید. برای مثال، می‌توانید system=Firestore AND type=Database را وارد کنید
تا همه پایگاه‌های داده Cloud Firestore را مشاهده کنید.
برای اطلاعات بیشتر، نحو جستجو برای Knowledge Catalog را ببینید.
نمونه گردش کار: بررسی دقیق از پایگاه داده تا طرحواره
برای رفتن از پایگاه داده به طرحواره، این مراحل را دنبال کنید:
به صفحه جستجوی کاتالوگ دانش بروید.
در پانل فیلترها، سیستم‌ها و سپس Firestore را انتخاب کنید. یا
system=Firestoreرا در فیلد جستجو وارد کنید.پایگاه داده‌ای را انتخاب کنید.
در صفحه جزئیات Firestore، روی برگه فهرست ورودی کلیک کنید، و سپس روی نمایش همه ورودی‌های فرزند در جستجو کلیک کنید.
در صفحه جزئیات پایگاه داده Firestore، روی برگه فهرست ورودی کلیک کنید، و سپس روی نمایش همه ورودی‌های فرزند در جستجو کلیک کنید. Knowledge Catalog گروه‌های مجموعه را در پایگاه داده نمایش می‌دهد.
نام گروه مجموعه را انتخاب کنید، و سپس در صفحه جزئیات گروه مجموعه، روی طرح کلیک کنید تا طرح را ببینید.
اختیاری: برای افزودن نوع جنبه به پایگاه داده، روی دکمه افزودن جنبه کلیک کنید.
قیمت‌گذاری
هزینه‌ای برای ذخیره کردن فراداده فنی Cloud Firestore در Knowledge Catalog دریافت نمی‌شود. قیمت‌گذاری استاندارد Knowledge Catalog برای فراخوانی‌های میانای برنامه‌سازی کاربردی و غنی‌سازی فراداده‌های کسب‌وکار اضافی اعمال می‌شود. برای اطلاعات بیشتر، به صفحه قیمت‌گذاری Knowledge Catalog مراجعه کنید.
محدودیت‌ها
- نتایج پُرسمان پس‌از دریافت ۱۰٬۰۰۰ گروه مجموعه کوتاه می‌شود.
- درطول انتقال دسته‌ای، ممکن است تا ۴۸ ساعت طول بکشد تا به‌روزرسانی‌های پایگاه داده شما در «کاتالوگ دانش» منعکس شود.
- درطول استخراج زنده، ممکن است تا ۵ دقیقه طول بکشد تا به‌روزرسانی‌های پایگاه داده شما در «کاتالوگ دانش» منعکس شود.
- گروه‌های مجموعه درطول انتقال زنده به‌روز نمی‌شوند.
- طرح‌های گروه مجموعه درطول انتقال زنده به‌روزرسانی می‌شوند، اما این به‌روزرسانی فقط ۱۰۰ فیلد اولیه سطح بالا را به‌ترتیب حروف الفبا پوشش می‌دهد. اطلاعات طرحواره باقی‌مانده ۲۴ تا ۴۸ ساعت پس‌از دریافت زنده به‌روز می‌شود.
- فرایند استخراج ممکن است چند دقیقه طول بکشد.