إدارة Cloud Firestore باستخدام Firebase Console

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

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

عرض البيانات

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

فتح مسار محدد

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

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

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

وثائق الأجداد غير موجودة

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

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

بيانات الاستعلام

يمكنك الاستعلام عن المستندات في علامة التبويب "منشئ الاستعلام" في صفحة بيانات Cloud Firestore.

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

2. انقر فوق علامة التبويب منشئ الاستعلام .

3. حدد نطاق الاستعلام .

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

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

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

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

   لإزالة عبارة استعلام، انقر فوق زر الإزالة الخاص بها cancel . لإزالة كافة عبارات الاستعلام، انقر فوق مسح .

5. انقر فوق تشغيل لاسترداد النتائج من قاعدة البيانات الخاصة بك.

متطلبات الاستعلام والقيود

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

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

• يجب أن تتطابق عبارات 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. استخدم لوحة التحكم لقياس استخدامك خلال فترات زمنية مختلفة.