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

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

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

عرض البيانات

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

فتح مسار معيّن

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

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

لفلترة المستندات المدرَجة في مجموعة، استخدِم الز0}الزر فلترة القائمة 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". لإدارة بياناتك، افتح علامة التبويب البيانات في قسم Cloud Firestore:

إضافة بيانات

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