عرض إحصاءات "كتالوج المعارف"

يمكنك البحث عن موارد "Cloud Firestore" وإدارتها باستخدام Knowledge Catalog، وهو منصة لتخزين البيانات الوصفية وإدارتها والوصول إليها. يمكنك استخدام Knowledge Catalog لتحليل بياناتك الوصفية في Cloud Firestore والمساعدة في تنفيذ مهام مثل:

  • التحليل، بما في ذلك التبعيات ومدى ملاءمة حالة الاستخدام
  • إدارة التغييرات
  • تطوّر المخطط

يتم تفعيل ميزة "كتالوج المعرفة" تلقائيًا في قواعد بيانات Cloud Firestore الجديدة والحالية، وتسترد تلقائيًا البيانات الوصفية التالية:

المورد النوع الحقول
قاعدة البيانات مستوى التحكّم
  • الإصدار
  • الأوضاع
  • الموقع الجغرافي (بما في ذلك المناطق المتعددة)
  • رقم تعريف المشروع
  • اسم قاعدة البيانات
  • وقت الإنشاء
مخطط قاعدة البيانات مستوى البيانات
  • الاسم
  • التجميع
  • الحقل - أنواع البيانات
  • المخطط

قبل البدء

فعِّل واجهة برمجة التطبيقات Knowledge Catalog API ‏ (dataplex.googleapis.com).
  • قبل تفعيل واجهات برمجة التطبيقات، يجب أن يكون لديك دور "مشرف استخدام الخدمة" في "إدارة الهوية وإمكانية الوصول" roles/serviceusage.serviceUsageAdmin، الذي يتضمّن إذن serviceusage.services.enable. كيفية منح الأدوار
  • لتفعيل واجهة برمجة تطبيقات، يُرجى الاطّلاع على تفعيل واجهات برمجة التطبيقات.

لاستخدام إحصاءات "كتالوج المعرفة" مع "Cloud Firestore"، يجب أولاً أن يكون لديك قاعدة بيانات "Cloud Firestore". لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء قواعد البيانات وإدارتها.

الأدوار المطلوبة للوصول إلى نتائج البحث

للبحث عن البيانات الوصفية لـ "Cloud Firestore" وعرضها في Knowledge Catalog، يجب أن يكون لدى المستخدمين الأساسيين أذونات لعرض موارد "Cloud Firestore"، بما في ذلك إذن "dataplex.projects.search".

لمنح هذه الأذونات للمستخدمين المصرَّح لهم، مثل المستخدمين أو المجموعات أو حسابات الخدمة، يجب منحهم دور مُشاهد Cloud Datastore (roles/datastore.viewer) ضمن "إدارة الهوية وإمكانية الوصول" في المشروع الذي يحتوي على موارد Cloud Firestore.

عملية "كتالوج المعارف" مورد واحد (Cloud Firestore) الأدوار أو الأذونات المطلوبة
البحث عن موارد Cloud Firestore قاعدة البيانات datastore.databases.getMetadata
مخطط قاعدة البيانات datastore.schemas.get

لمزيد من المعلومات حول منح الأدوار، يُرجى الاطّلاع على إدارة أذونات الوصول. لمزيد من المعلومات عن أدوار "إدارة الهوية وإمكانية الوصول" في "Cloud Firestore"، يُرجى الاطّلاع على أدوار وأذونات "Cloud Firestore".

الأدوار المطلوبة للبحث عن الإدخالات

للبحث عن الإدخالات، يجب أن يكون لديك على الأقل أحد أدوار إدارة الهوية وإمكانية الوصول التالية في المشروع المستخدَم للبحث:

يتم التحقّق من الأذونات في نتائج البحث بشكل مستقل عن المشروع المحدّد. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة البحث عن مواد عرض البيانات باستخدام Knowledge Catalog.

أنواع استكشاف البيانات الوصفية

إنّ ميزة "اكتشاف البيانات الوصفية" في Knowledge Catalog هي عملية مبرمَجة تفحص مصادر البيانات المرتبطة، مثل Cloud Firestore، لتحديد أصول البيانات (مثل المجموعات وقواعد البيانات) واستخراج بياناتها الوصفية الفنية، مثل المخططات والأوصاف والمواقع الجغرافية، إلى دليل Knowledge Catalog. يتم تنفيذ هذه العملية بشكل دوري لمزامنة الكتالوج مع الأنظمة المصدر.

يتيح Knowledge Catalog عمليات البحث باستخدام الكلمات الرئيسية واللغة الطبيعية.

  • يتيح لك البحث عن الكلمات الرئيسية العثور على الموارد باستخدام كلمات رئيسية وفلاتر محدّدة وبنية محدّدة. على سبيل المثال، يمكنك إدخال 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، في صفحة Knowledge Catalog ضمن وحدة تحكّم Google Cloud أو باستخدام Knowledge Catalog API. يمكنك بعد ذلك الاطّلاع على تفاصيل حول مواد العرض وإثرائها ببيانات وصفية إضافية تجارية أو تشغيلية.

إثراء البيانات الوصفية باستخدام الجوانب

أنواع الجوانب هي موارد قابلة لإعادة الاستخدام يمكنك استخدامها كنماذج للجوانب. تساعدك أنواع الجوانب في تجنُّب تكرار العمل والجوانب غير المكتملة. يمكنك استخدام Knowledge Catalog لإنشاء أنواع الجوانب التي تحتاج إليها.

بعد إنشاء أنواع جوانب مخصّصة، يمكنك إرفاق جوانب بموارد Cloud Firestore. يتيح لك إرفاق الجوانب بمواردك إجراء ما يلي:

  • إضافة بيانات وصفية خاصة بالمؤسسة إلى مواد العرض
  • البحث عن مواد العرض حسب البيانات الوصفية للنشاط التجاري والبيانات الوصفية المخصّصة الأخرى

لمزيد من المعلومات حول إنشاء أنواع الجوانب وإرفاق الجوانب بـ Cloud Firestore، يُرجى الاطّلاع على إدارة الجوانب وإثراء البيانات الوصفية.

البحث عن مواد عرض "Cloud Firestore"

استخدِم صفحة البحث في Knowledge Catalog ضمن وحدة تحكّم Google Cloud للبحث عن مواد عرض "Cloud Firestore".

  1. انتقِل إلى صفحة البحث في "كتالوج المعارف".

    الانتقال إلى "بحث Google"

  2. في لوحة الفلاتر، انقر على الأنظمة، ثم اختَر Firestore.

  3. اختياريّ. في الأسماء البديلة للأنواع، يمكنك فلترة نتائج البحث حسب نوع معيّن من مواد عرض 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-database
    • firestore-schema

قد يبدو نموذج الاستعلام كما يلي:

type="projects/1234567890/locations/global/entryTypes/firestore-schema"

البحث حسب نوع الجانب

يتضمّن Knowledge Catalog بعض أنواع الجوانب المضمّنة التي يمكنك استخدامها لإجراء عمليات البحث.

للبحث حسب نوع الجانب، اتّبِع الخطوات التالية:

  1. في لوحة الجوانب، انقر على قائمة إضافة المزيد من أنواع الجوانب.
  2. أدخِل Firestore، ثم اختَر نوعًا واحدًا أو أكثر من أنواع الجوانب التالية لحصر نتائج البحث في هذا النوع.
    • قاعدة بيانات "Cloud Firestore"
    • مخطط Cloud Firestore
  3. انقر على موافق.
  4. في جدول النتائج، انقر على اسم مادة العرض لعرض البيانات الوصفية الخاصة بها.
  5. اختياري: يمكنك تحسين مواد العرض أو عرضها. يمكنك تنفيذ أيٍّ ممّا يلي:
    • لإضافة وصف نص منسق لمادة العرض، انقر على إضافة في نظرة عامة .
    • لإرفاق جانب بمادة العرض، انقر على إضافة في الجوانب .
    • لعرض قواعد بيانات الأعضاء لمثيل معيّن، انقر على علامة التبويب قائمة الإدخالات، ثم انقر على عرض جميع الإدخالات الفرعية في البحث.
    • في تفاصيل الإدخال، اطّلِع على التفاصيل الكاملة لمادة العرض. انقر على اسم الإدخال للانتقال إلى إدخالات إضافية.

البحث باللغة الطبيعية في Cloud Firestore

يستخدم البحث باللغة الطبيعية (نسخة حصرية) الذكاء الاصطناعي لفهم طلبات البحث الدلالية. تتيح لك هذه الميزة العثور على المراجع باستخدام لغة بسيطة، ما يغنيك عن استخدام الصيغ المعقّدة. على سبيل المثال، يمكنك إدخال طلبات بحث مثل List all Firestore collections related to sales.

لمزيد من المعلومات، يُرجى الاطّلاع على بنية البحث في Knowledge Catalog.

البحث في البنية في Cloud Firestore

يتيح لك البحث عن الكلمات الرئيسية العثور على الموارد باستخدام كلمات رئيسية وفلاتر محدّدة وبنية محدّدة. على سبيل المثال، يمكنك إدخال system=Firestore AND type=Database لعرض جميع قواعد بيانات Cloud Firestore.

لمزيد من المعلومات، يُرجى الاطّلاع على بنية البحث في Knowledge Catalog.

مثال على سير العمل: الانتقال من قاعدة البيانات إلى المخطّط

للانتقال من قاعدة بيانات إلى مخطط، اتّبِع الخطوات التالية:

  1. انتقِل إلى صفحة البحث في "كتالوج المعارف".

    الانتقال إلى "بحث Google"

  2. في لوحة الفلاتر، اختَر الأنظمة ثم Firestore. بدلاً من ذلك، أدخِل system=Firestore في حقل البحث.

  3. اختَر قاعدة بيانات.

  4. في صفحة تفاصيل Firestore، انقر على علامة التبويب قائمة الإدخالات، ثم انقر على عرض جميع الإدخالات الفرعية في البحث.

  5. في صفحة تفاصيل قاعدة بيانات Firestore، انقر على علامة التبويب قائمة الإدخالات، ثم انقر على عرض جميع الإدخالات الفرعية في البحث. يعرض Knowledge Catalog مجموعات البيانات في قاعدة البيانات.

  6. اختَر اسم مجموعة، ثم انقر على المخطّط في صفحة تفاصيل المجموعة لعرض المخطّط.

  7. اختياري: لإضافة نوع جانب إلى قاعدة بيانات، انقر على الزر إضافة جانب.

الأسعار

لا يتم فرض أي رسوم مقابل تخزين البيانات الوصفية الفنية في "كتالوج المعارف" من خلال "Cloud Firestore". تنطبق أسعار Standard Knowledge Catalog على طلبات البيانات من واجهة برمجة التطبيقات وإضافة المزيد من البيانات الوصفية للأنشطة التجارية. لمزيد من المعلومات، يُرجى الاطّلاع على صفحة أسعار Knowledge Catalog.

القيود

  • يتم اقتطاع نتائج طلب البحث بعد استيعاب 10,000 مجموعة.
  • أثناء عملية نقل البيانات المجمّعة، قد يستغرق ظهور التعديلات التي تم إجراؤها على قاعدة البيانات في "كتالوج المعرفة" مدة تصل إلى 48 ساعة.
  • أثناء عملية نقل البيانات المباشرة، قد يستغرق ظهور التعديلات على قاعدة بياناتك في "كتالوج المعرفة" مدة تصل إلى 5 دقائق.
  • لا يتم تعديل مجموعات المجموعات أثناء نقل البيانات المباشر.
  • يتم تعديل مخططات مجموعات البيانات أثناء عملية نقل البيانات المباشرة، ولكن هذا التعديل يشمل فقط أول 100 حقل أساسي من المستوى الأعلى بالترتيب الأبجدي. يتم تعديل معلومات المخطط المتبقية بعد فترة تتراوح بين 24 و48 ساعة من الاستيعاب المباشر.
  • قد تستغرق عملية الاستخراج عدة دقائق.

الخطوات التالية