إنشاء طلبات البحث المحفوظة وإدارتها

توضّح هذه الصفحة كيفية إنشاء طلبات البحث المحفوظة وإدارتها. عند كتابة طلبات البحث في Cloud Firestoreاستوديو YouTubeCloud Firestore، يمكنك حفظ هذه الطلبات وإدارتها. لمزيد من المعلومات، راجِع نظرة عامة على الطلبات المحفوظة.

تتوفّر إمكانية الاستعلامات المحفوظة فقط في وحدة تحكّم Google Cloud.

الأدوار المطلوبة

للحصول على الأذونات اللازمة لاستخدام طلبات البحث المحفوظة، اطلب من المشرف منحك أدوار "إدارة الهوية وإمكانية الوصول" (IAM) التالية في المشروع:

  • لعرض الطلبات المحفوظة، اتّبِع الخطوات التالية: أداة عرض Cloud Datastore (roles/datastore.viewer)
  • لعرض الطلبات المحفوظة وإنشائها وتعديلها وحذفها، يجب أن يكون لديك الدور التالي: مستخدم Cloud Datastore (roles/datastore.user)
  • لإدارة طلبات البحث المحفوظة وعرضها وإنشائها وتعديلها وحذفها: مالك Cloud Datastore (roles/datastore.owner): يملك هذا الدور أذونات واسعة النطاق ويتيح الوصول الكامل إلى Cloud Firestore، ولا يمكن استخدامه إلا من قِبل المشرفين.

لمزيد من المعلومات حول منح الأدوار، يُرجى الاطّلاع على إدارة الوصول إلى المشاريع والمجلدات والمؤسسات.

تحتوي هذه الأدوار المحدّدة مسبقًا على الأذونات المطلوبة لاستخدام طلبات البحث المحفوظة. لمزيد من المعلومات عن الأذونات المطلوبة، يُرجى الاطّلاع على الأذونات المطلوبة.

الأذونات المطلوبة

لإنشاء طلبات البحث المحفوظة وعرضها وتعديلها وحذفها، يجب أن تتوفّر لك أذونات IAM التالية على مستوى المشروع:

الإجراء أذونات "إدارة الهوية وإمكانية الوصول" المطلوبة
إنشاء طلبات بحث محفوظة
  • databasesconsole.studioQueries.create
عرض طلبات البحث المحفوظة
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
تعديل طلبات البحث المحفوظة
  • databasesconsole.studioQueries.update
حذف طلبات البحث المحفوظة
  • databasesconsole.studioQueries.delete
إدارة طلبات البحث المحفوظة
(للاستخدام من قِبل المشرفين فقط)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list

يمكنك أيضًا الحصول على هذه الأذونات باستخدام الأدوار المخصّصة أو الأدوار المحدّدة مسبقًا الأخرى.

يوفّر دور مستخدم طلبات البحث في Studio (roles/databasesconsole.studioQueryUser) إمكانية إنشاء طلبات البحث المحفوظة وعرضها وكتابتها. يلبّي هذا الدور احتياجات معظم المستخدمين.

يجب منح دور مشرف طلبات البحث في "استوديو YouTube" (roles/databasesconsole.studioQueryAdmin) للمشرفين فقط. لمزيد من المعلومات حول Cloud Firestore إدارة الهوية وإمكانية الوصول، يُرجى الاطّلاع على إدارة الهوية وإمكانية الوصول .

إنشاء طلب بحث محفوظ

لإنشاء طلب بحث محفوظ، اتّبِع الخطوات التالية:

  1. انتقِل إلى صفحة جميع قواعد البيانات في وحدة تحكّم Google Cloud.
    كل قواعد البيانات
  2. اختَر قاعدة بيانات Cloud Firestore تريد إنشاء طلب بحث محفوظ فيها.
  3. في قائمة التنقّل، انقر على Cloud Firestore "استوديو YouTube".
  4. في لوحة المستكشف ضمن صفحة Cloud Firestore Studio، انتقِل إلى قسم المجموعات.
  5. انقر على مجموعة لفتح علامة تبويب جديدة للمحرّر. يمكنك اختياريًا النقر على عرض الإجراءات بجانب مجموعة. بعد ذلك، انقر على مجموعة طلبات البحث لفتح علامة تبويب جديدة في المحرّر.
  6. في محرّر طلب البحث، أدخِل طلب بحث.
  7. انقر على حفظ.
  8. في مربّع الحوار حفظ طلب البحث، أدخِل اسمًا لطلب البحث المحفوظ.
  9. انقر على حفظ.

فتح طلب بحث محفوظ وتنفيذه

لفتح طلب بحث محفوظ كطلب بحث جديد، اتّبِع الخطوات التالية:

  1. في جزء المستكشف ضمن صفحة Cloud Firestore "استوديو"، انتقِل إلى قسم طلبات البحث.
  2. انقر على طلب بحث محفوظ لفتحه في علامة تبويب جديدة في المحرّر. يمكنك اختياريًا النقر على عرض الإجراءات بجانب طلب بحث محفوظ. بعد ذلك، انقر على فتح طلب البحث لفتحه في علامة تبويب جديدة للمحرّر.
  3. انقر على تشغيل.

تعديل طلب بحث محفوظ

لتعديل طلب بحث محفوظ حالي، اتّبِع الخطوات التالية:

  1. في جزء المستكشف ضمن صفحة Cloud Firestore "استوديو"، انتقِل إلى قسم طلبات البحث.
  2. انقر على طلب بحث محفوظ لفتحه في علامة تبويب جديدة في المحرّر. يمكنك اختياريًا النقر على عرض الإجراءات بجانب طلب بحث محفوظ. بعد ذلك، انقر على فتح طلب البحث لفتحه في علامة تبويب جديدة للمحرّر.
  3. عدِّل طلب البحث.
  4. لحفظ طلب البحث المعدَّل، انقر على حفظ.

عرض قائمة بكل الطلبات المحفوظة وإدارتها

للاطّلاع على قائمة بجميع طلبات البحث المحفوظة في مشروعك، اتّبِع الخطوات التالية:

  1. انتقِل إلى صفحة جميع قواعد البيانات في وحدة تحكّم Google Cloud.
    كل قواعد البيانات
  2. اختَر أي قاعدة بيانات. بما أنّ طلب البحث المحفوظ هو عنصر تابع لمشروع، يمكنك عرض جميع طلبات البحث المحفوظة في المشروع من أي قاعدة بيانات طالما أنّ لديك الدور المطلوب.
  1. اختَر أي قاعدة بيانات.
  2. في جزء المستكشف ضمن صفحة Cloud Firestore "استوديو"، انتقِل إلى قسم طلبات البحث.
  3. انقر على عرض الإجراءات بجانب طلب بحث محفوظ. بعد ذلك، انقر على إدارة طلبات البحث.

    تفتح صفحة طلبات البحث المحفوظة. تعرض هذه الصفحة جميع طلبات البحث المحفوظة في هذا المشروع، بما في ذلك طلبات البحث المحفوظة لمنتجات Google Cloud الأخرى.

يمكنك البحث عن طلبات البحث وفلترتها وعرضها وحذفها في صفحة طلبات البحث المحفوظة. لا يمكنك تعديل طلب بحث حالي في صفحة طلبات البحث المحفوظة.

حذف طلب بحث محفوظ

يمكنك حذف طلب بحث محفوظ من صفحة Cloud Firestore Studio أو من صفحة طلبات البحث المحفوظة في "وحدة تحكّم Google Cloud".

  1. في جزء المستكشف على صفحة Cloud Firestore "استوديو"، انتقِل إلى قسم طلبات البحث.
  2. انقر على عرض الإجراءات بجانب طلب البحث المحفوظ الذي تريد حذفه. بعد ذلك، لحذف طلب البحث المحفوظ، انقر على حذف طلب البحث.
  3. في مربّع الحوار حذف طلب البحث، انقر على حذف.

يمكنك أيضًا حذف طلب بحث محفوظ في صفحة طلبات البحث المحفوظة. لحذف طلب بحث محفوظ في صفحة طلبات البحث المحفوظة، اتّبِع الخطوات التالية:

  1. انتقِل إلى صفحة طلبات البحث المحفوظة.
  2. انقر على عرض الإجراءات بجانب طلب البحث المحفوظ الذي تريد حذفه.
  3. انقر على حذف طلب البحث لحذف طلب البحث المحفوظ.
  4. في مربّع الحوار حذف طلب البحث، انقر على حذف.

الخطوات التالية