این صفحه نحوه ایجاد و مدیریت کوئریهای ذخیره شده را شرح میدهد. وقتی کوئریها را در Cloud Firestore Studio مینویسید، میتوانید آنها را ذخیره و مدیریت کنید. برای اطلاعات بیشتر، به نمای کلی کوئریهای ذخیره شده مراجعه کنید.
قابلیت ذخیره کوئریها فقط در کنسول گوگل کلود (Google Cloud) در دسترس است.
نقشهای مورد نیاز
برای دریافت مجوزهایی که برای استفاده از کوئریهای ذخیره شده نیاز دارید، از مدیر سیستم خود بخواهید که نقشهای مدیریت هویت و دسترسی (IAM) زیر را در پروژه به شما اعطا کند:
- برای مشاهده کوئریهای ذخیره شده: Cloud Datastore Viewer (
roles/datastore.viewer) - برای مشاهده، ایجاد، تغییر و حذف کوئریهای ذخیره شده: کاربر Cloud Datastore (
roles/datastore.user) - برای مدیریت، مشاهده، ایجاد، تغییر و حذف کوئریهای ذخیره شده: مالک Cloud Datastore (
roles/datastore.owner). این نقش دارای مجوزهای گستردهای است و دسترسی کامل به Cloud Firestore را فقط برای استفاده مدیران فراهم میکند.
برای اطلاعات بیشتر در مورد اعطای نقشها، به مدیریت دسترسی به پروژهها، پوشهها و سازمانها مراجعه کنید.
این نقشهای از پیش تعریفشده حاوی مجوزهای مورد نیاز برای استفاده از کوئریهای ذخیرهشده هستند. برای کسب اطلاعات بیشتر در مورد مجوزهای مورد نیاز، به مجوزهای مورد نیاز مراجعه کنید.
مجوزهای مورد نیاز
برای ایجاد، مشاهده، تغییر و حذف کوئریهای ذخیره شده، به مجوزهای IAM زیر در سطح پروژه نیاز دارید:
| اکشن | مجوزهای مورد نیاز IAM |
|---|---|
| ایجاد کوئریهای ذخیره شده |
|
| مشاهده کوئریهای ذخیره شده |
|
| تغییر کوئریهای ذخیره شده |
|
| حذف کوئریهای ذخیره شده |
| مدیریت کوئریهای ذخیره شده (فقط برای استفاده مدیران) |
|
همچنین میتوانید این مجوزها را با استفاده از نقشهای سفارشی یا سایر نقشهای از پیش تعریف شده دریافت کنید.
نقش کاربر کوئری استودیو ( roles/databasesconsole.studioQueryUser ) دسترسی ایجاد، مشاهده و نوشتن کوئریهای ذخیره شده را فراهم میکند. این نقش نیازهای اکثر کاربران را برآورده میکند.
نقش Studio Query Admin ( roles/databasesconsole.studioQueryAdmin ) را فقط به مدیران اعطا کنید. برای اطلاعات بیشتر در مورد Cloud Firestore IAM، به بخش مدیریت هویت و دسترسی مراجعه کنید.
ایجاد یک پرس و جوی ذخیره شده
برای ایجاد یک پرس و جوی ذخیره شده، مراحل زیر را دنبال کنید:
- به صفحه همه پایگاههای داده در کنسول Google Cloud بروید.
همه پایگاههای داده - یک پایگاه داده Cloud Firestore را که میخواهید در آن یک کوئری ذخیره شده ایجاد کنید، انتخاب کنید.
- در منوی ناوبری، روی Cloud Firestore Studio کلیک کنید.
- در پنل اکسپلورر در صفحه Cloud Firestore Studio، به بخش Collections بروید.
- برای باز کردن یک تب ویرایشگر جدید، روی یک مجموعه کلیک کنید. به صورت اختیاری، میتوانید روی View actions در کنار یک مجموعه کلیک کنید. سپس، روی Query collection کلیک کنید تا یک تب ویرایشگر جدید باز شود.
- در ویرایشگر پرسوجو، یک پرسوجو وارد کنید.
- روی ذخیره کلیک کنید.
- در کادر محاورهای ذخیره پرسوجو ، نامی برای پرسوجوی ذخیرهشده وارد کنید.
- روی ذخیره کلیک کنید.
باز کردن و اجرای یک کوئری ذخیره شده
برای باز کردن یک پرسوجوی ذخیرهشده به عنوان یک پرسوجوی جدید، مراحل زیر را دنبال کنید:
- در پنل اکسپلورر در صفحه Cloud Firestore Studio ، به بخش Queries بروید.
- برای باز کردن یک کوئری ذخیره شده در یک تب ویرایشگر جدید، روی آن کلیک کنید. به صورت اختیاری، میتوانید روی View actions در کنار یک کوئری ذخیره شده کلیک کنید. سپس، روی Open query کلیک کنید تا آن را در یک تب ویرایشگر جدید باز کنید.
- روی اجرا کلیک کنید.
بهروزرسانی یک پرسوجوی ذخیرهشده
برای بهروزرسانی یک پرسوجوی ذخیرهشدهی موجود، مراحل زیر را دنبال کنید:
- در پنل اکسپلورر در صفحه Cloud Firestore Studio ، به بخش Queries بروید.
- برای باز کردن یک کوئری ذخیره شده در یک تب ویرایشگر جدید، روی آن کلیک کنید. به صورت اختیاری، میتوانید روی View actions در کنار یک کوئری ذخیره شده کلیک کنید. سپس، روی Open query کلیک کنید تا آن را در یک تب ویرایشگر جدید باز کنید.
- پرسوجو را اصلاح کنید.
- برای ذخیره پرس و جوی اصلاح شده، روی ذخیره کلیک کنید.
مشاهده و مدیریت لیستی از تمام پرس و جوهای ذخیره شده
برای مشاهده لیست تمام کوئریهای ذخیره شده در پروژه خود، مراحل زیر را دنبال کنید:
- به صفحه همه پایگاههای داده در کنسول Google Cloud بروید.
همه پایگاههای داده - هر پایگاه دادهای را انتخاب کنید. از آنجا که یک کوئری ذخیره شده، زیرمجموعه یک پروژه است، تا زمانی که نقش مورد نیاز را داشته باشید، میتوانید تمام کوئریهای ذخیره شده در پروژه را از هر پایگاه دادهای مشاهده کنید.
- هر پایگاه دادهای را انتخاب کنید.
- در پنل اکسپلورر در صفحه Cloud Firestore Studio ، به بخش Queries بروید.
- برای مشاهده اقدامات کنار یک پرسوجوی ذخیرهشده، روی کلیک کنید. سپس، روی مدیریت پرسوجوها کلیک کنید.
صفحه «پرسشهای ذخیرهشده» باز میشود. این صفحه تمام پرسوجوهای ذخیرهشده در این پروژه، از جمله پرسوجوهای ذخیرهشده برای سایر محصولات Google Cloud را فهرست میکند.
شما میتوانید در صفحه «پرسشهای ذخیرهشده» جستجو، فیلتر، مشاهده و حذف پرسوجوها را انجام دهید. در صفحه «پرسشهای ذخیرهشده» نمیتوانید پرسوجوی موجود را ویرایش کنید.
حذف یک پرسوجوی ذخیرهشده
میتوانید یک کوئری ذخیرهشده را از صفحه Cloud Firestore Studio یا در صفحه Saved queries در کنسول Google Cloud حذف کنید.
- در پنل اکسپلورر در صفحه Cloud Firestore Studio ، به بخش Queries بروید.
- برای مشاهده اقدامات کنار پرسوجوی ذخیرهشدهای که میخواهید حذف کنید، روی کلیک کنید. سپس، برای حذف پرسوجوی ذخیرهشده، روی Delete query کلیک کنید.
- در کادر محاورهای حذف پرسوجو ، روی حذف کلیک کنید.
همچنین میتوانید یک پرسوجوی ذخیرهشده را در صفحه «پرسوجوهای ذخیرهشده» حذف کنید. برای حذف یک پرسوجوی ذخیرهشده در صفحه «پرسوجوهای ذخیرهشده» ، این مراحل را دنبال کنید:
- به صفحه جستجوهای ذخیره شده بروید.
- روی کلیک کنید تا اقدامات کنار پرسوجوی ذخیرهشدهای که میخواهید حذف کنید، نمایش داده شود .
- برای حذف پرسوجوی ذخیرهشده، روی «حذف پرسوجو» کلیک کنید.
- در کادر محاورهای حذف پرسوجو ، روی حذف کلیک کنید.
قدم بعدی چیست؟
- درباره پرسوجوهای ذخیرهشده اطلاعات کسب کنید.