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

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

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

عرض البيانات

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

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

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

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

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

مستندات رئيسية غير موجودة

يمكن أن يتوفّر مستند حتى إذا لم يتوفّر مجلد رئيسي واحد أو أكثر له. على سبيل المثال، يمكن أن يتوفّر المستند في المسار /mycoll/mydoc/mysubcoll/mysubdoc حتى إذا لم يتوفّر المستند الرئيسي /mycoll/mydoc.

يعرض عارض بيانات Cloud Firestore المستند الرئيسي غير الموجود على النحو التالي:

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

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

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

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

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

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

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

   انقر على مجموعة المجموعات للاستعلام عن جميع المجموعات التي لها المعرّف نفسه. في حقل مجموعة المجموعات، أدخِل معرّف مجموعة المجموعات.

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

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

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

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

متطلبات طلبات البحث والقيود المفروضة عليها

عند استخدام "أداة إنشاء الطلبات"، يُرجى مراعاة المتطلبات والقيود التالية المتعلقة بالطلبات.

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

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

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

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

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

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

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

إضافة بيانات

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

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

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

حذف البيانات

لحذف إحدى المجموعات:

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

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

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

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

لحذف حقل معيّن في مستند، اتّبِع الخطوات التالية:

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

إدارة Cloud Firestore Security Rules

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

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

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

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

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