يمكنك البحث عن مواردك وإدارتها باستخدام "كتالوج المعارف"، وهو منصة لتخزين البيانات الوصفية وإدارتها والوصول إليها.Cloud Firestore يمكنك استخدام "كتالوج المعارف" لتحليل البيانات الوصفية في Cloud Firestore والمساعدة في مهام مثل:
- التحليل، بما في ذلك التبعيات ومدى ملاءمة حالة استخدام
- إدارة التغييرات
- تطوّر المخطط
يكون "كتالوج المعارف" مفعَّلاً تلقائيًا في قواعد بيانات Cloud Firestore الجديدة والحالية، ويسترجع تلقائيًا البيانات الوصفية التالية:
| المورد | النوع | الحقول |
|---|---|---|
| قاعدة البيانات | لوحة التحكّم |
|
| مخطط قاعدة البيانات | لوحة البيانات |
|
قبل البدء
لاستخدام إحصاءات "كتالوج المعارف" مع 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)
يتم التحقّق من الأذونات في نتائج البحث بشكلٍ مستقل عن المشروع المحدّد. لمزيد من المعلومات، يُرجى الاطّلاع على البحث عن مواد عرض البيانات باستخدام "كتالوج المعارف".
أنواع اكتشاف البيانات الوصفية
إنّ عملية اكتشاف البيانات الوصفية في "كتالوج المعارف" هي عملية تلقائية تفحص مصادر البيانات المرتبطة، مثل 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 Console أو باستخدام Knowledge Catalog API.
يمكنك بعد ذلك عرض تفاصيل مواد العرض وإثراءها ببيانات وصفية إضافية خاصة بالنشاط التجاري أو التشغيل.
إثراء البيانات الوصفية باستخدام الجوانب
أنواع الجوانب هي موارد قابلة لإعادة الاستخدام يمكنك استخدامها كقوالب للجوانب. تساعدك أنواع الجوانب في تجنُّب تكرار العمل والجوانب غير المكتملة. يمكنك استخدام "كتالوج المعارف" لإنشاء أنواع الجوانب التي تحتاج إليها.
بعد إنشاء أنواع جوانب مخصّصة، يمكنك إرفاق جوانب بمواردك Cloud Firestore. يتيح لك إرفاق الجوانب بمواردك إجراء ما يلي:
- إضافة بيانات وصفية خاصة بالنشاط التجاري إلى مواد العرض
- البحث عن مواد العرض حسب البيانات الوصفية الخاصة بالنشاط التجاري والبيانات الوصفية المخصّصة الأخرى
لمزيد من المعلومات عن إنشاء أنواع الجوانب وإرفاق الجوانب بـ Cloud Firestore، يُرجى الاطّلاع على إدارة الجوانب وإثراء البيانات الوصفية.
البحث عن مواد عرض Cloud Firestore
استخدِم صفحة البحث في "كتالوج المعارف" في Google Cloud Console للبحث عن مواد عرض 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 في "كتالوج المعارف". تنطبق الأسعار العادية لـ "كتالوج المعارف" على طلبات واجهة برمجة التطبيقات وإثراء البيانات الوصفية الإضافية الخاصة بالنشاط التجاري. لمزيد من المعلومات، يُرجى الاطّلاع على صفحة أسعار "كتالوج المعارف".
القيود
- يتم اقتطاع نتائج طلب البحث بعد استيعاب 10,000 مجموعة تجميع.
- أثناء عملية الاستيعاب المجمّع، قد يستغرق ظهور التعديلات التي يتم إجراؤها على قاعدة البيانات في "كتالوج المعارف" مدة تصل إلى 48 ساعة.
- أثناء عملية الاستيعاب المباشر، قد يستغرق ظهور التعديلات التي يتم إجراؤها على قاعدة البيانات في "كتالوج المعارف" مدة تصل إلى 5 دقائق.
- لا يتم تعديل مجموعات التجميع أثناء عملية الاستيعاب المباشر.
- يتم تعديل مخططات حزم المجموعات أثناء عملية الاستيعاب المباشر، ولكن لا يشمل هذا التعديل سوى أول 100 حقل أساسي من المستوى الأعلى بالترتيب الأبجدي. يتم تعديل معلومات المخطط المتبقية بعد 24 إلى 48 ساعة من عملية الاستيعاب المباشر.
- قد تستغرق عملية الاستخراج عدة دقائق.
الخطوات التالية
- لمحة عن إدارة كتالوج البيانات في "كتالوج المعارف"
- أدوار إدارة الهوية وإمكانية الوصول في "كتالوج المعارف"