برای استفاده مجدد و هم‌رسانی عملیات رایج پایگاه داده در جلسه‌ها، می‌توانید پُرسمان‌های ذخیره‌شده را در کنسول Firebase ایجاد، سازمان‌دهی، و مدیریت کنید. برای اطلاعات بیشتر، نمای کلی پُرسمان‌های ذخیره‌شده را ببینید.
قابلیت پُرسمان‌های ذخیره‌شده فقط در کنسول دردسترس است و از میاناهای برنامه‌سازی کاربردی استفاده نمی‌کند.
نقش‌های الزامی
برای دریافت اجازه‌هایی که برای استفاده از پُرسمان‌های ذخیره‌شده نیاز دارید، از سرپرستتان بخواهید نقش‌های «مدیریت هویت و دسترسی» (IAM) زیر را در پروژه به شما اعطا کند:
- برای مشاهده پُرسمان‌های ذخیره‌شده:
Cloud Datastore Viewer (
roles/datastore.viewer) - برای مشاهده، ایجاد، اصلاح، و حذف پُرسمان‌های ذخیره‌شده:
کاربر Cloud Datastore (
roles/datastore.user) - برای مدیریت، مشاهده، ایجاد، اصلاح، و حذف پُرسمان‌های ذخیره‌شده:
مالک Cloud Datastore (
roles/datastore.owner). این نقش اجازه‌های گسترده‌ای دارد و دسترسی کامل به Cloud Firestore را فراهم می‌کند، فقط برای استفاده سرپرستان.
برای اطلاعات بیشتر درباره اعطای نقش‌ها، مدیریت دسترسی به پروژه‌ها، پوشه‌ها، و سازمان‌ها را ببینید.
این نقش‌های ازپیش تعریف‌شده حاوی اجازه‌های لازم برای استفاده از پُرسمان‌های ذخیره‌شده هستند. برای کسب اطلاعات بیشتر درباره اجازه‌های لازم، به اجازه‌های لازم مراجعه کنید.
مجوزهای لازم
برای ایجاد، مشاهده، اصلاح، و حذف پُرسمان‌های ذخیره‌شده، به اجازه‌های IAM زیر در سطح پروژه نیاز دارید:
| کنش | اجازه‌های IAM لازم |
|---|---|
| ایجاد پُرسمان‌های ذخیره‌شده |
|
| مشاهده پُرسمان‌های ذخیره‌شده |
|
| اصلاح پُرسمان‌های ذخیره‌شده |
|
| حذف پُرسمان‌های ذخیره‌شده |
|
| مدیریت پُرسمان‌های ذخیره‌شده (فقط برای استفاده سرپرستان) |
|
همچنین می‌توانید این اجازه‌ها را بااستفاده از نقش‌های سفارشی یا دیگر نقش‌های ازپیش تعریف‌شده دریافت کنید.
نقش کاربر پُرسمان استودیو
(roles/databasesconsole.studioQueryUser)
دسترسی ایجاد، مشاهده، و نوشتن پُرسمان‌های ذخیره‌شده را فراهم می‌کند. این نقش نیازهای اکثر کاربران را برآورده می‌کند.
نقش سرپرست پرسمان استودیو
(roles/databasesconsole.studioQueryAdmin)
را فقط به سرپرستان اعطا کنید. برای اطلاعات بیشتر درباره
Cloud Firestore IAM، مدیریت هویت و دسترسی‌ها را ببینید.
ایجاد پُرسمان ذخیره‌شده
برای ایجاد پُرسمان ذخیره‌شده، این مراحل را دنبال کنید:
- به صفحه Cloud Firestore در کنسول Firebase بروید.
Cloud Firestore - پایگاه داده‌ای را که می‌خواهید پُرسمان ذخیره‌شده در آن ایجاد شود انتخاب کنید. پایگاه داده باید نمونه نسخه Enterprise باشد.
- روی برگه ویرایشگر پُرسمان کلیک کنید.
- در ویرایشگر پُرسمان، پُرسمانی را وارد کنید.
- روی ذخیره کردن کلیک کنید.
- در کادر گفتگوی ذخیره پُرسمان، نامی برای پُرسمان ذخیره‌شده وارد کنید.
- روی ذخیره کردن کلیک کنید.
باز کردن و اجرای پُرسمان ذخیره‌شده
برای باز کردن پُرسمان ذخیره‌شده به‌عنوان پُرسمان جدید، این مراحل را دنبال کنید:
- در ویرایشگر پُرسمان، روی پُرسمان‌های ذخیره‌شده () کلیک کنید.
- روی پُرسمان ذخیره‌شده‌ای کلیک کنید تا در برگه ویرایشگر جدیدی باز شود. درصورت تمایل، می‌توانید روی مشاهده کنش‌ها در کنار پُرسمان ذخیره‌شده کلیک کنید. سپس، روی باز کردن پُرسمان کلیک کنید تا در برگه ویرایشگر جدیدی باز شود.
- روی اجرا کلیک کنید.
به‌روز کردن پُرسمان ذخیره‌شده
برای به‌روزرسانی پُرسمان ذخیره‌شده موجود، این مراحل را دنبال کنید:
- در ویرایشگر پُرسمان، روی پُرسمان‌های ذخیره‌شده () کلیک کنید.
- روی پُرسمان ذخیره‌شده‌ای کلیک کنید تا در برگه ویرایشگر جدیدی باز شود. درصورت تمایل، می‌توانید روی مشاهده کنش‌ها در کنار پُرسمان ذخیره‌شده کلیک کنید. سپس، روی باز کردن پُرسمان کلیک کنید تا در برگه ویرایشگر جدیدی باز شود.
- پُرسمان را اصلاح کنید.
- برای ذخیره کردن پُرسمان اصلاح‌شده، روی ذخیره کلیک کنید.
مشاهده و مدیریت فهرست همه پُرسمان‌های ذخیره‌شده
برای مشاهده فهرست همه پُرسمان‌های ذخیره‌شده در پروژه‌تان، این مراحل را دنبال کنید:
در کنسول Google Cloud، به صفحه پرس‌وجوهای ذخیره‌شده بروید.
رفتن به «پرسمان‌های ذخیره‌شده»می‌توانید پُرسمان‌ها را در صفحه پُرسمان‌های ذخیره‌شده جستجو، فیلتر، مشاهده، و حذف کنید. نمی‌توانید پُرسمان موجود را در صفحه پُرسمان‌های ذخیره‌شده ویرایش کنید.
حذف پُرسمان ذخیره‌شده
می‌توانید پُرسمان ذخیره‌شده را از صفحه Cloud Firestore Studio یا در صفحه پُرسمان‌های ذخیره‌شده در کنسول Google Cloud حذف کنید.
- در ویرایشگر پُرسمان، روی پُرسمان‌های ذخیره‌شده () کلیک کنید.
- روی مشاهده کنش‌ها در کنار پُرسمان ذخیره‌شده‌ای که می‌خواهید حذف کنید کلیک کنید. سپس برای حذف پُرسمان ذخیره‌شده، روی حذف پُرسمان کلیک کنید.
- در کادر گفتگوی حذف پُرسمان، روی حذف کلیک کنید.
همچنین می‌توانید پُرسمان ذخیره‌شده را در صفحه پُرسمان‌های ذخیره‌شده حذف کنید. برای حذف پُرسمان ذخیره‌شده در صفحه پُرسمان‌های ذخیره‌شده، این مراحل را دنبال کنید:
- به صفحه پُرسمان‌های ذخیره‌شده بروید.
- روی مشاهده کنش‌ها در کنار پُرسمان ذخیره‌شده‌ای که می‌خواهید حذف کنید کلیک کنید.
- برای حذف پُرسمان ذخیره‌شده، روی حذف پُرسمان کلیک کنید.
- در کادر گفتگوی حذف پُرسمان، روی حذف کلیک کنید.
حالا چه می‌شود
- با پرس‌وجوهای ذخیره‌شده آشنا شوید.