يمكنك البحث عن موارد Cloud Firestore وإدارتها باستخدام Knowledge Catalog، وهي منصة لتخزين البيانات الوصفية وإدارتها والوصول إليها. يمكنك استخدام Knowledge Catalog لتحليل بيانات Cloud Firestore الوصفية والمساعدة في مهام مثل:
- التحليل، بما في ذلك التبعيات ومدى ملاءمة حالة الاستخدام
- إدارة التغييرات
- تطوّر المخطط
تكون ميزة Knowledge Catalog مفعَّلة تلقائيًا في قواعد بيانات Cloud Firestore الجديدة والحالية، وتسترد تلقائيًا البيانات الوصفية التالية:
| المورد | النوع | الحقول |
|---|---|---|
| قاعدة البيانات | لوحة التحكّم |
|
| مخطط قاعدة البيانات | مستوى البيانات |
|
قبل البدء
لاستخدام إحصاءات Knowledge Catalog مع Cloud Firestore، يجب أولاً أن يكون لديك قاعدة بيانات Cloud Firestore. لمزيد من المعلومات، راجِع إنشاء قواعد البيانات وإدارتها.
الأدوار المطلوبة للوصول إلى نتائج البحث
للبحث عن البيانات الوصفية Cloud Firestore وعرضها في "كتالوج المعرفة"، يجب أن يكون لدى الجهات الرئيسية أذونات لعرض موارد Cloud Firestore، بما في ذلك إذن dataplex.projects.search.
لمنح هذه الأذونات للمدراء، مثل المستخدمين أو المجموعات أو حسابات الخدمة، يجب منحهم دور مُشاهد Cloud Datastore (roles/datastore.viewer) في إدارة الهوية وإمكانية الوصول (IAM) في المشروع الذي يحتوي على موارد Cloud Firestore.
| عملية "كتالوج المعارف" | 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.
أنواع استكشاف بيانات التعريف
اكتشاف البيانات الوصفية في "كتالوج المعرفة" هو عملية مبرمَجة تفحص مصادر البيانات المرتبطة، مثل Cloud Firestore، لتحديد أصول البيانات (مثل المجموعات وقواعد البيانات) واستخراج البيانات الوصفية الفنية الخاصة بها، مثل المخططات والأوصاف والمواقع الجغرافية، إلى كتالوج "كتالوج المعرفة". يتم تنفيذ هذه العملية بشكل دوري للحفاظ على مزامنة الكتالوج مع الأنظمة المصدر.
البحث بالكلمات الرئيسية واللغة الطبيعية
يتيح "كتالوج المعرفة" البحث باستخدام الكلمات الرئيسية واللغة الطبيعية.
- يتيح لك البحث عن الكلمات الرئيسية العثور على مراجع باستخدام كلمات رئيسية وفلاتر وبنية محددة. على سبيل المثال، يمكنك إدخال
system=Firestore AND type=Databaseللاطّلاع على جميع قواعد بيانات Cloud Firestore. - تستخدِم ميزة "البحث باللغة الطبيعية" (معاينة) الذكاء الاصطناعي لفهم طلبات البحث الدلالية، ما يتيح لك العثور على المراجع باستخدام اللغة اليومية، وبالتالي لن تحتاج إلى استخدام صيغة معقّدة. على سبيل المثال، يمكنك إدخال طلبات بحث مثل
List all Firestore databases related to sales.
لمزيد من المعلومات، اطّلِع على بنية البحث في "كتالوج المعرفة".
مثال: اكتشاف مخطط حزمة المجموعات Cloud Firestore
لفهم عملية البحث عن البيانات الوصفية، لنفترض أنّ هناك Cloud Firestore
قاعدة بيانات باسم user-firestore-database. في قاعدة البيانات هذه، لديك مخطط حزمة المجموعات يُسمى user-schema.
بعد اكتمال عملية الاكتشاف، يمكنك البحث عن هذه الأصول - user-firestore-database
وuser-schema - في صفحة "كتالوج المعرفة" ضمن
وحدة تحكّم Google Cloud أو باستخدام واجهة برمجة التطبيقات Knowledge Catalog API.
يمكنك بعد ذلك الاطّلاع على تفاصيل حول الأصول وإضافة بيانات وصفية إضافية خاصة بالنشاط التجاري أو التشغيل إليها.
إثراء البيانات الوصفية باستخدام الجوانب
أنواع السمات هي موارد قابلة لإعادة الاستخدام يمكنك استخدامها كقوالب للسمات، وهي تساعدك في تجنُّب تكرار العمل والسمات غير المكتملة. يمكنك استخدام "كتالوج المعرفة" لإنشاء أنواع السمات التي تحتاج إليها.
بعد إنشاء أنواع سمات مخصّصة، يمكنك ربط السمات بمواردك Cloud Firestore. يتيح لك ربط السمات بمواردك إجراء ما يلي:
- إضافة بيانات وصفية خاصة بالنشاط التجاري إلى مواد العرض
- البحث عن مواد العرض حسب البيانات الوصفية للمؤسسة وغيرها من البيانات الوصفية المخصّصة
لمزيد من المعلومات حول إنشاء أنواع السمات وإرفاق السمات بـ Cloud Firestore، يُرجى الاطّلاع على إدارة السمات وإثراء البيانات الوصفية.
البحث عن مواد عرض Cloud Firestore
استخدِم صفحة البحث في "كتالوج المعرفة" ضمن وحدة تحكّم Google Cloud للبحث عن أصول Cloud Firestore.
انتقِل إلى صفحة البحث في "كتالوج المعارف".
في لوحة الفلاتر، انقر على الأنظمة، ثم اختَر Firestore.
اختياريّ. في أسماء أنواع، يمكنك فلترة نتائج البحث لتقتصر على نوع معيّن من أصول Cloud Firestore من خلال اختيار اسم نوع واحد أو أكثر مما يلي:
- قاعدة البيانات
- مخطط قاعدة البيانات
- غير ذلك
استخدام طلبات البحث لإجراء بحث عن الكلمات الرئيسية
يمكنك استخدام حقل البحث في "كتالوج المعرفة" لتنفيذ طلبات بحث عن كلمات رئيسية. على سبيل المثال، يمكنك إدخال
system=Firestore AND type=Database لعرض جميع قواعد بيانات Cloud Firestore.
لمزيد من المعلومات، اطّلِع على بنية البحث في "كتالوج المعرفة".
للاطّلاع على جميع مواد عرض 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"
البحث حسب نوع الجانب
يتضمّن "كتالوج المعرفة" بعض أنواع الجوانب المضمّنة التي يمكنك استخدامها لإجراء عمليات بحث.
للبحث حسب نوع السمة، اتّبِع الخطوات التالية:
- في لوحة الجوانب، انقر على قائمة إضافة المزيد من أنواع الجوانب.
- أدخِل
Firestore، ثم اختَر نوعًا واحدًا أو أكثر من أنواع الجوانب التالية لحصر نتائج البحث بهذا النوع.- Cloud Firestore قاعدة البيانات
- Cloud Firestore المخطط
- انقر على موافق.
- في جدول النتائج، انقر على اسم مادة العرض للاطّلاع على البيانات الوصفية الخاصة بها.
- اختياري: تحسين مواد العرض أو عرضها يمكنك تنفيذ أيّ من الإجراءات التالية:
- لإضافة وصف بتنسيق النص المنسّق لمادة العرض، انقر على إضافة في نظرة عامة .
- لإرفاق مظهر بالأصل، انقر على إضافة في المظاهر .
- لعرض قواعد بيانات الأعضاء في مثيل، انقر على علامة التبويب قائمة الإدخالات، ثم انقر على عرض جميع إدخالات العناصر التابعة في البحث.
- في تفاصيل الإدخال، اطّلِع على التفاصيل الكاملة لمادة العرض. انقر على اسم الإدخال للوصول إلى إدخالات إضافية.
البحث باللغة الطبيعية في Cloud Firestore
تستخدِم ميزة "البحث باللغة الطبيعية" (معاينة) الذكاء الاصطناعي لفهم طلبات البحث الدلالية، ما يتيح لك العثور على المراجع باستخدام اللغة اليومية، وبالتالي لا تحتاج إلى استخدام صيغة معقّدة. على سبيل المثال، يمكنك إدخال طلبات بحث مثل List all Firestore collections related to sales.
لمزيد من المعلومات، اطّلِع على بنية البحث في "كتالوج المعرفة".
البحث عن البنية في Cloud Firestore
يتيح لك البحث عن الكلمات الرئيسية العثور على مراجع باستخدام كلمات رئيسية وفلاتر وبنية محددة. على سبيل المثال، يمكنك إدخال system=Firestore AND type=Database
للاطّلاع على جميع قواعد بيانات Cloud Firestore.
لمزيد من المعلومات، اطّلِع على بنية البحث في "كتالوج المعرفة".
مثال على سير العمل: الانتقال من قاعدة البيانات إلى المخطّط
للانتقال من قاعدة بيانات إلى مخطط، اتّبِع الخطوات التالية:
انتقِل إلى صفحة البحث في "كتالوج المعارف".
في لوحة الفلاتر، اختَر الأنظمة ثم Firestore. بدلاً من ذلك، أدخِل
system=Firestoreفي حقل البحث.اختَر قاعدة بيانات.
في صفحة تفاصيل Firestore، انقر على علامة التبويب قائمة الإدخالات، ثم انقر على عرض جميع إدخالات العناصر التابعة في البحث.
في صفحة تفاصيل قاعدة بيانات Firestore، انقر على علامة التبويب قائمة الإدخالات، ثم انقر على عرض جميع إدخالات العناصر التابعة في البحث. يعرض "كتالوج المعرفة" مجموعات العناصر في قاعدة البيانات.
اختَر اسم مجموعة مجموعات، ثم انقر على المخطط في صفحة تفاصيل مجموعة المجموعات لعرض المخطط.
اختياري: لإضافة نوع سمة إلى قاعدة بيانات، انقر على الزر إضافة سمة.
الأسعار
لا يتم تحصيل أي رسوم مقابل تخزين البيانات الوصفية الفنية Cloud Firestore في Knowledge Catalog. يتم تطبيق أسعار Knowledge Catalog العادية على طلبات البيانات من واجهة برمجة التطبيقات وعمليات إثراء البيانات الوصفية الإضافية الخاصة بالأنشطة التجارية. لمزيد من المعلومات، يُرجى الاطّلاع على صفحة أسعار Knowledge Catalog.
القيود
- يتم اقتطاع نتائج طلب البحث بعد استيعاب 10,000 مجموعة من مجموعات البيانات.
- أثناء عملية الاستيعاب المجمّع، قد يستغرق ظهور التعديلات التي تم إجراؤها على قاعدة البيانات في "كتالوج المعرفة" مدة تصل إلى 48 ساعة.
- أثناء عملية الاستيعاب المباشر، قد يستغرق ظهور التعديلات التي أجريتها على قاعدة البيانات في "كتالوج المعرفة" مدة تصل إلى 5 دقائق.
- لا يتم تعديل مجموعات الحزم أثناء عملية النقل المباشر.
- يتم تعديل مخططات حزمة المجموعات أثناء عملية النقل المباشر، ولكن لا يشمل هذا التعديل سوى أول 100 حقل أساسي من المستوى الأعلى بالترتيب الأبجدي. يتم تعديل معلومات المخطط المتبقية بعد 24 إلى 48 ساعة من عملية النقل المباشر.
- قد تستغرق عملية الاستخراج عدة دقائق.
الخطوات التالية
- لمحة عن إدارة كتالوج البيانات في "كتالوج المعرفة"
- أدوار إدارة الهوية وإمكانية الوصول في "كتالوج المعرفة"