إدارة Cloud Firestore باستخدام "وحدة تحكُّم Firebase"

يمكنك تنفيذ الإجراءات التالية على Cloud Firestore عند استخدام وحدة تحكُّم Firebase:

• الاطّلاع على البيانات وإضافتها وتعديلها وحذفها
• إنشاء قواعد أمان Cloud Firestore وتعديلها
• إدارة الفهارس.
• مراقبة الاستخدام.

عرض البيانات

يمكنك عرض جميع بيانات Cloud Firestore في وحدة تحكُّم Firebase. من علامة تبويب البيانات في Cloud Firestore، انقر على مستند أو مجموعة لفتح البيانات المضمّنة في ذلك العنصر.

فتح مسار محدّد

لفتح مستند أو مجموعة في مسار معيّن، استخدِم زر تعديل المسار :

فلترة المستندات في مجموعة

لفلترة المستندات المدرَجة في مجموعة، استخدِم الزر قائمة الفلاتر .

مستندات الأصل غير متوفرة

يمكن أن يوجد مستند حتى في حال عدم وجود أصل واحد أو أكثر. على سبيل المثال، قد يتوفر المستند في المسار /mycoll/mydoc/mysubcoll/mysubdoc حتى إذا لم يكن مستند الأصل /mycoll/mydoc متوفرًا. يعرض عارض بيانات Cloud Firestore مستند أصل غير موجود على النحو التالي:

• في قائمة مستندات المجموعة، تكون معرّفات المستندات لمستندات الأصل غير الموجودة مائلة.
• في لوحة معلومات مستند أصل غير موجود، يشير عارض البيانات إلى أن المستند غير موجود.

تحذير: على الرغم من ظهور مستندات الأصل غير الموجودة في وحدة التحكم، إلا أنها لا تظهر في طلبات البحث واللقطات. وعليك إنشاء المستند لتضمينه في نتائج طلب البحث.

بيانات طلب البحث

يمكنك طلب البحث عن المستندات في علامة التبويب أداة إنشاء الطلبات في صفحة "بيانات Cloud Firestore".

1. الانتقال إلى صفحة بيانات Cloud Firestore

2. انقر على علامة التبويب أداة إنشاء طلبات البحث.

3. اختَر نطاق طلب البحث.

   اختَر مجموعة لطلب بحث عن مجموعة واحدة. في الحقل النصي، أدخِل مسارًا إلى مجموعة.

   اختَر مجموعة المجموعات لطلب البحث عن كل المجموعات التي تحمل رقم التعريف نفسه. في حقل مجموعة المجموعات، أدخِل رقم تعريف مجموعة المجموعات.

   سيعرض الجدول المستندات تلقائيًا من المجموعة أو مجموعة المجموعات المحددة.

4. انقر على إضافة إلى طلب البحث لفلترة مجموعة المستندات المعروضة. بشكل تلقائي، تضيف "أداة إنشاء طلبات البحث" عبارة WHERE. يمكنك تعديل هذه العبارة باستخدام القوائم المنسدلة والحقول النصية أو التغيير إلى إحدى العبارات الأخرى المتاحة. لمواصلة إنشاء طلبات بحث أكثر تعقيدًا، انقر على إضافة إلى طلب البحث.

   لإزالة عبارة طلب بحث، انقر على زر الإزالة . لإزالة جميع عبارات طلب البحث، انقر على محو.

   ملاحظة: يجب أن تستوفي طلبات البحث متطلبات Cloud Firestore والقيود المتعلقة بطلبات البحث. بخلاف ذلك، يتعذّر تنفيذ طلب البحث وتعرض الصفحة رسالة الخطأ التي تصف سبب تعذّر تنفيذ طلب البحث.

5. انقر على تشغيل لاسترداد النتائج من قاعدة البيانات.

متطلبات طلب البحث وحدوده

أثناء استخدام أداة إنشاء طلبات البحث، ضع في اعتبارك المتطلبات والقيود التالية المتعلقة بطلبات البحث.

• يجب أن يتيح فهرس واحد أو أكثر إمكانية تنفيذ جميع طلبات البحث. إذا لم تتمكن قاعدة البيانات من العثور على فهرس لدعم الاستعلام، فستعرض خطأ يحتوي على رابط لإنشاء الفهرس المطلوب.

• يجب أن تتطابق جُمل ORDER BY مع الحقول في عبارات WHERE وأن تكون بالترتيب نفسه. بشكل افتراضي، يتم ترتيب النتائج حسب معرّف المستند. في حال الفلترة حسب أي حقل آخر باستخدام أي حقل آخر غير سمة المساواة (==)، أضِف عبارة ORDER BY لهذا الحقل.

• يجب أن تتم فلترة جميع عبارات طلب البحث في النطاق (< و<= و> و>=) ولا يساوي (!= أو not-in) في الحقل نفسه.

لمعرفة القيود الإضافية، يُرجى الاطّلاع على قيود طلبات البحث.

إدارة البيانات

في Cloud Firestore، يمكنك تخزين البيانات في المستندات وتنظيم المستندات في مجموعات. قبل البدء في إضافة البيانات، اطّلِع على مزيد من المعلومات حول نموذج بيانات Cloud Firestore.

يمكنك إضافة المستندات والمجموعات وتعديلها وحذفها من وحدة تحكُّم Firebase. لإدارة بياناتك، افتح علامة تبويب البيانات في قسم Cloud Firestore:

ملاحظة: يتم احتساب العمليات القراءة والكتابة والحذف التي يتم إجراؤها في وحدة التحكم ضمن استخدام Cloud Firestore. قد تؤدي بعض أنشطة وحدة التحكم، مثل عرض مستند يحتوي على حقول متعددة، إلى إنشاء عدة عمليات.

إضافة بيانات

1. انقر على إضافة مجموعة، ثم أدخِل اسم المجموعة وانقر على التالي.
2. أدخِل معرّف مستند محدّدًا أو انقر على معرّف تلقائي، ثم أضِف حقولاً للبيانات في المستند.
3. انقر على حفظ. تظهر مجموعتك ومستندك الجديدان في عارض البيانات.
4. لإضافة المزيد من المستندات إلى المجموعة، انقر على إضافة مستند.

تعديل البيانات

1. انقر على مجموعة لعرض مستنداتها، ثم انقر على مستند لعرض حقوله ومجموعاته الفرعية.
2. انقر على حقل لتعديل قيمته. لإضافة حقول أو مجموعات فرعية إلى المستند المحدّد، انقر على إضافة حقل أو إضافة مجموعة.

حذف بيانات

لحذف مجموعة:

1. اختَر المجموعة التي تريد حذفها.
2. انقر على رمز القائمة في أعلى عمود المستندات، ثم انقر على حذف المجموعة.

لحذف مستند أو جميع حقوله:

1. اختَر المستند الذي تريد حذفه.
2. انقر على رمز القائمة أعلى عمود تفاصيل المستند. اختَر حذف المستند أو حذف حقول المستندات.

يؤدي حذف مستند إلى حذف جميع البيانات المتداخلة في هذا المستند، بما في ذلك أي مجموعات فرعية. ومع ذلك، لا يؤدي حذف حقول المستند إلى حذف مجموعاته الفرعية.

لحذف حقل معيّن في مستند:

1. اختَر المستند لعرض حقوله.
2. انقر على رمز الحذف بجانب الحقل الذي تريد حذفه.

إدارة قواعد أمان Cloud Firestore

لإضافة "قواعد أمان Cloud Firestore" وتعديلها وحذفها من "وحدة تحكُّم Firebase"، انتقِل إلى علامة التبويب القواعد في القسم Cloud Firestore. تعرَّف على مزيد من المعلومات حول إعداد القواعد وتخصيصها.

إدارة الفهارس

لإنشاء فهارس جديدة لطلبات البحث وإدارة الفهارس الحالية من وحدة تحكُّم Firebase، انتقِل إلى علامة تبويب المؤشرات في قسم Cloud Firestore. مزيد من المعلومات حول إدارة الفهارس

مراقبة الاستخدام

لمراقبة استخدام Cloud Firestore، افتح علامة التبويب الاستخدام في Cloud Firestore في "وحدة تحكُّم Firebase". استخدم لوحة المعلومات لقياس استخدامك خلال فترات زمنية مختلفة.