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

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

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

عرض البيانات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   لإزالة عبارة استعلام، انقر فوق الزر "Remove" (إزالة) cancel لإزالة جميع عبارات الاستعلام، انقر على محو.

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

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

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

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

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

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

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

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

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

يمكنك إضافة المستندات والمجموعات وتعديلها وحذفها من Firebase. وحدة التحكم. لإدارة بياناتك، افتح علامة تبويب البيانات. في القسم 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". استخدام لوحة البيانات لقياس معدّل استخدامك خلال فترات زمنية مختلفة.