Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

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

عرض البيانات

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

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

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

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

تصفية الوثائق في مجموعة

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

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

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

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

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

مستند أصل غير موجود في وحدة التحكم.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • يجب أن تتم تصفية عبارات الاستعلام Range ( < ، <= ، > ، >= ) وليس يساوي ( != ، 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 Usage في Firebase Console. استخدم لوحة القيادة لقياس استخدامك خلال فترات زمنية مختلفة.