لإعادة استخدام عمليات قاعدة البيانات الشائعة ومشاركتها في جميع الجلسات، يمكنك إنشاء وتنظيم وإدارة طلبات البحث المحفوظة في وحدة تحكُّم Firebase. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على الطلبات المحفوظة .
لا تتوفّر ميزة طلبات البحث المحفوظة إلا في وحدة التحكّم، وليس باستخدام واجهات برمجة التطبيقات.
الأدوار المطلوبة
للحصول على الأذونات التي تحتاج إليها لاستخدام طلبات البحث المحفوظة، اطلب من المشرف منحك أدوار "إدارة الهوية وإمكانية الوصول" (IAM) التالية في المشروع:
- لعرض طلبات البحث المحفوظة:
عارض Cloud Datastore (
roles/datastore.viewer) - لعرض طلبات البحث المحفوظة وإنشائها وتعديلها وحذفها:
مستخدم Cloud Datastore (
roles/datastore.user) - لإدارة طلبات البحث المحفوظة وعرضها وإنشائها وتعديلها وحذفها:
مالك Cloud Datastore (
roles/datastore.owner): يمتلك هذا الدور أذونات واسعة النطاق ويوفّر إمكانية الوصول الكامل إلى Cloud Firestore، وهو مخصّص للاستخدام من قِبل المشرفين فقط.
لمزيد من المعلومات حول منح الأدوار، يُرجى الاطّلاع على مقالة إدارة الوصول إلى المشاريع والمجلدات والمؤسسات.
تحتوي هذه الأدوار المحدّدة مسبقًا على الأذونات المطلوبة لاستخدام طلبات البحث المحفوظة. لمزيد من المعلومات حول الأذونات المطلوبة، يُرجى الاطّلاع على الأذونات المطلوبة.
الأذونات المطلوبة
لإنشاء طلبات البحث المحفوظة وعرضها وتعديلها وحذفها، تحتاج إلى أذونات "إدارة الهوية وإمكانية الوصول" التالية على مستوى المشروع:
| الإجراء | أذونات "إدارة الهوية وإمكانية الوصول" المطلوبة |
|---|---|
| إنشاء طلبات بحث محفوظة |
|
| عرض الطلبات المحفوظة |
|
| تعديل الطلبات المحفوظة |
|
| حذف الطلبات المحفوظة |
|
| إدارة طلبات البحث المحفوظة (للاستخدام من قِبل المشرفين فقط) |
|
يمكنك أيضًا الحصول على هذه الأذونات باستخدام الأدوار المخصّصة أو الأدوار المحدّدة مسبقًا الأخرى.
يوفّر دور مستخدم طلبات البحث في "استوديو YouTube"
(roles/databasesconsole.studioQueryUser)
إذن الوصول لإنشاء طلبات البحث المحفوظة وعرضها وكتابتها. يلبي هذا الدور احتياجات معظم المستخدمين.
يجب منح دور مشرف طلبات البحث في Studio
(roles/databasesconsole.studioQueryAdmin)
للمشرفين فقط. لمزيد من المعلومات حول "إدارة الهوية وإمكانية الوصول" في Cloud Firestore، يُرجى الاطّلاع على مقالة إدارة الهوية وإمكانية الوصول.
إنشاء طلب محفوظ
لإنشاء طلب بحث محفوظ، اتّبِع الخطوات التالية:
- انتقِل إلى صفحة Cloud Firestore في وحدة تحكُّم Firebase.
Cloud Firestore - اختَر قاعدة بيانات تريد إنشاء طلب بحث محفوظ فيها. يجب أن تكون قاعدة البيانات مثيلاً لإصدار Enterprise.
- انقر على علامة التبويب محرِّر طلبات البحث.
- في محرّر طلب البحث، أدخِل طلب بحث.
- انقر على حفظ.
- في مربّع الحوار حفظ طلب البحث، أدخِل اسمًا لطلب البحث المحفوظ.
- انقر على حفظ.
فتح طلب بحث محفوظ وتنفيذه
لفتح طلب بحث محفوظ كطلب بحث جديد، اتّبِع الخطوات التالية:
- في محرِّر طلبات البحث، انقر على طلبات البحث المحفوظة ().
- انقر على طلب محفوظ لفتحه في علامة تبويب جديدة في المحرِّر. يمكنك اختياريًا النقر على عرض الإجراءات بجانب طلب بحث محفوظ. بعد ذلك، انقر على فتح طلب البحث لفتحه في علامة تبويب جديدة في المحرِّر.
- انقر على تشغيل.
تعديل طلب بحث محفوظ
لتعديل طلب بحث محفوظ حالي، اتّبِع الخطوات التالية:
- في محرِّر طلبات البحث، انقر على طلبات البحث المحفوظة ().
- انقر على طلب محفوظ لفتحه في علامة تبويب جديدة في المحرِّر. يمكنك اختياريًا النقر على عرض الإجراءات بجانب طلب بحث محفوظ. بعد ذلك، انقر على فتح طلب البحث لفتحه في علامة تبويب جديدة في المحرِّر.
- عدِّل طلب البحث.
- لحفظ طلب البحث المعدَّل، انقر على حفظ.
عرض قائمة بجميع الطلبات المحفوظة وإدارتها
لعرض قائمة بجميع طلبات البحث المحفوظة في مشروعك، اتّبِع الخطوات التالية:
في وحدة تحكّم Google Cloud، انتقِل إلى صفحة طلبات البحث المحفوظة.
الانتقال إلى "طلبات البحث المحفوظة"يمكنك البحث عن طلبات البحث وفلترتها وعرضها وحذفها في صفحة طلبات البحث المحفوظة. لا يمكنك تعديل طلب بحث حالي في صفحة طلبات البحث المحفوظة.
حذف طلب محفوظ
يمكنك حذف طلب بحث محفوظ من صفحة Cloud Firestore Studio أو من صفحة طلبات البحث المحفوظة في Google Cloud Console.
- في محرِّر طلبات البحث، انقر على طلبات البحث المحفوظة ().
- انقر على عرض الإجراءات بجانب طلب البحث المحفوظ الذي تريد حذفه. بعد ذلك، لحذف الطلب المحفوظ، انقر على حذف الطلب.
- في مربّع الحوار حذف طلب البحث، انقر على حذف.
يمكنك أيضًا حذف طلب محفوظ في صفحة الطلبات المحفوظة. لحذف طلب بحث محفوظ في صفحة طلبات البحث المحفوظة، اتّبِع الخطوات التالية:
- انتقِل إلى صفحة طلبات البحث المحفوظة.
- انقر على عرض الإجراءات بجانب طلب البحث المحفوظ الذي تريد حذفه.
- انقر على حذف طلب البحث لحذف طلب البحث المحفوظ.
- في مربّع الحوار حذف طلب البحث، انقر على حذف.