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

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

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

عرض البيانات

يمكنك عرض جميع بيانات 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. أدخِل رقم تعريف مستند محدّدًا أو انقر على رقم تعريف تلقائي، ثم أضِف حقولًا ل data في مستندك.
3. انقر على حفظ. تظهر مجموعتك ومستندك الجديدان في أداة عرض البيانات.
4. لإضافة المزيد من المستندات إلى المجموعة، انقر على إضافة مستند.

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

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

حذف البيانات

لحذف مجموعة:

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

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

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

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

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

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

إدارة Cloud Firestore Security Rules

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

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

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

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

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