يمكنك تنفيذ الإجراءات التالية على Cloud Firestore عند استخدام وحدة تحكم Firebase :
- عرض وإضافة وتحرير وحذف البيانات.
- قم بإنشاء وتحديث قواعد أمان Cloud Firestore.
- إدارة الفهارس.
- مراقبة الاستخدام.
عرض البيانات
يمكنك عرض جميع بيانات Cloud Firestore الخاصة بك في وحدة تحكم Firebase. من علامة التبويب Cloud Firestore Data ، انقر فوق مستند أو مجموعة لفتح البيانات المتداخلة داخل هذا العنصر.
افتح مسارًا محددًا
لفتح مستند أو مجموعة في مسار معين ، استخدم زر تحرير المسار
:تصفية الوثائق في مجموعة
لتصفية المستندات المدرجة في مجموعة ، استخدم زر قائمة التصفية
.وثائق أسلاف غير موجودة
يمكن أن يوجد المستند حتى في حالة عدم وجود أحد أسلافه أو أكثر. على سبيل المثال ، يمكن أن يوجد المستند الموجود في المسار /mycoll/mydoc/mysubcoll/mysubdoc
حتى إذا لم يكن مستند السلف /mycoll/mydoc
موجودًا. يعرض عارض بيانات Cloud Firestore مستند أصل غير موجود على النحو التالي:
- في قائمة المستندات الخاصة بالمجموعة ، تظهر معرّفات المستندات لمستندات أسلاف غير موجودة بالخط المائل.
- في لوحة معلومات وثيقة الأصل غير الموجودة ، يشير عارض البيانات إلى أن المستند غير موجود.
بيانات الاستعلام
يمكنك الاستعلام عن المستندات في علامة تبويب منشئ الاستعلام في صفحة بيانات Cloud Firestore.
انقر فوق علامة التبويب منشئ الاستعلام .
حدد نطاق الاستعلام .
حدد مجموعة للاستعلام عن مجموعة واحدة. في حقل النص ، أدخل مسارًا لمجموعة.
حدد مجموعة المجموعة للاستعلام عن جميع المجموعات بنفس المعرف. في حقل مجموعة المجموعة ، أدخل معرف مجموعة المجموعة.
سيعرض الجدول تلقائيًا المستندات من المجموعة المحددة أو مجموعة المجموعات.
انقر فوق إضافة إلى الاستعلام لتصفية مجموعة المستندات التي تم إرجاعها. بشكل افتراضي ، يضيف منشئ الاستعلام جملة
WHERE
. يمكنك تعديل هذه الفقرة باستخدام القوائم المنسدلة وحقول النص أو التغيير إلى أحد البنود الأخرى المتاحة. لمتابعة إنشاء استعلامات أكثر تعقيدًا ، انقر فوق إضافة إلى الاستعلام .لإزالة عبارة استعلام ، انقر فوق زر الإزالة
. لإزالة كافة عبارات الاستعلام ، انقر فوق مسح .انقر فوق "تشغيل" لاسترداد النتائج من قاعدة البيانات الخاصة بك.
متطلبات الاستعلام والقيود
أثناء استخدامك Query Builder ، ضع في اعتبارك المتطلبات والقيود التالية للاستعلامات.
يجب أن تكون جميع الاستعلامات مدعومة بفهرس واحد أو أكثر. إذا لم تتمكن قاعدة البيانات من العثور على فهرس لدعم الاستعلام ، فستقوم بإرجاع خطأ يحتوي على ارتباط لإنشاء الفهرس المطلوب.
يجب أن تتطابق عبارات
ORDER BY
مع الحقول الموجودة في عباراتWHERE
وتأتي بنفس الترتيب. بشكل افتراضي ، يتم ترتيب النتائج حسب معرف المستند. إذا قمت بالتصفية حسب أي حقل آخر مع أي شيء آخر بخلاف المساواة (==
) ، أضف عبارةORDER BY
لهذا الحقل.يجب أن تتم تصفية عبارات الاستعلام Range (
<
،<=
،>
،>=
) وليس يساوي (!=
،not-in
) في نفس الحقل.
للحصول على قيود إضافية ، راجع قيود الاستعلام .
إدارة البيانات
في Cloud Firestore ، تقوم بتخزين البيانات في المستندات وتنظيم مستنداتك في مجموعات. قبل البدء في إضافة البيانات ، تعرف على المزيد حول نموذج بيانات Cloud Firestore .
يمكنك إضافة المستندات والمجموعات وتحريرها وحذفها من وحدة تحكم Firebase. لإدارة بياناتك ، افتح علامة تبويب البيانات في قسم Cloud Firestore :
إضافة البيانات
- انقر فوق إضافة مجموعة ، ثم أدخل اسم مجموعتك وانقر فوق التالي .
- أدخل معرف مستند محددًا أو انقر فوق معرف تلقائي ، ثم قم بإضافة حقول للبيانات في المستند الخاص بك.
- انقر فوق حفظ . تظهر مجموعتك الجديدة والمستند الجديد في عارض البيانات.
- لإضافة المزيد من المستندات إلى المجموعة ، انقر فوق إضافة مستند .
تحرير البيانات
- انقر فوق مجموعة لعرض مستنداتها ، ثم انقر فوق مستند لعرض حقولها ومجموعاتها الفرعية.
- انقر فوق حقل لتعديل قيمته. لإضافة حقول أو مجموعات فرعية إلى المستند المحدد ، انقر فوق إضافة مجال أو إضافة مجموعة .
حذف البيانات
لحذف مجموعة:
- حدد المجموعة التي تريد حذفها.
- انقر على رمز القائمة أعلى عمود المستندات ، ثم انقر على حذف المجموعة .
لحذف مستند أو جميع حقوله:
- حدد المستند الذي تريد حذفه.
- انقر فوق رمز القائمة أعلى عمود تفاصيل المستند. حدد حذف المستند أو حذف حقول المستند .
يؤدي حذف مستند إلى حذف جميع البيانات المتداخلة في ذلك المستند ، بما في ذلك أي مجموعات فرعية. ومع ذلك ، لا يؤدي حذف حقول المستند إلى حذف مجموعاته الفرعية.
لحذف حقل معين في مستند:
- حدد المستند لعرض الحقول الخاصة به.
- انقر فوق أيقونة الحذف بجانب الحقل الذي تريد حذفه.
إدارة قواعد أمان Cloud Firestore
لإضافة قواعد أمان Cloud Firestore وتحريرها وحذفها من وحدة تحكم Firebase ، انتقل إلى علامة التبويب "القواعد" في قسم Cloud Firestore . تعرف على المزيد حول إعداد القواعد وتخصيصها .
إدارة الفهارس
لإنشاء فهارس جديدة لاستعلاماتك وإدارة الفهارس الحالية من وحدة تحكم Firebase ، انتقل إلى علامة التبويب فهارس في قسم Cloud Firestore . تعرف على المزيد حول إدارة الفهارس .
مراقبة الاستخدام
لمراقبة استخدام Cloud Firestore ، افتح علامة التبويب Cloud Firestore Usage في Firebase Console. استخدم لوحة القيادة لقياس استخدامك خلال فترات زمنية مختلفة.