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