این صفحه نحوه ایجاد و مدیریت کوئریهای ذخیره شده را شرح میدهد. وقتی کوئریها را در کنسول Firebase مینویسید، میتوانید آنها را ذخیره و مدیریت کنید. برای اطلاعات بیشتر، به نمای کلی کوئریهای ذخیره شده مراجعه کنید.
قابلیت ذخیره کوئریها فقط در کنسول موجود است و از APIها استفاده نمیکند.
نقشهای مورد نیاز
برای دریافت مجوزهایی که برای استفاده از کوئریهای ذخیره شده نیاز دارید، از مدیر سیستم خود بخواهید که نقشهای مدیریت هویت و دسترسی (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، به بخش مدیریت هویت و دسترسی مراجعه کنید.
ایجاد یک پرس و جوی ذخیره شده
برای ایجاد یک پرس و جوی ذخیره شده، مراحل زیر را دنبال کنید:
- به صفحه Cloud Firestore در کنسول Firebase بروید.
Cloud Firestore - پایگاه دادهای را که میخواهید در آن یک کوئری ذخیره شده ایجاد کنید، انتخاب کنید. پایگاه داده باید از نوع نسخه Enterprise باشد.
- روی برگه ویرایشگر پرس و جو کلیک کنید.
- در ویرایشگر پرسوجو، یک پرسوجو وارد کنید.
- روی ذخیره کلیک کنید.
- در کادر محاورهای ذخیره پرسوجو ، نامی برای پرسوجوی ذخیرهشده وارد کنید.
- روی ذخیره کلیک کنید.
باز کردن و اجرای یک کوئری ذخیره شده
برای باز کردن یک پرسوجوی ذخیرهشده به عنوان یک پرسوجوی جدید، مراحل زیر را دنبال کنید:
- در ویرایشگر پرسوجو ، پرسوجوهای ذخیرهشده کلیک کنید.
- برای باز کردن یک کوئری ذخیره شده در یک تب ویرایشگر جدید، روی آن کلیک کنید. به صورت اختیاری، میتوانید روی View actions در کنار یک کوئری ذخیره شده کلیک کنید. سپس، روی Open query کلیک کنید تا آن را در یک تب ویرایشگر جدید باز کنید.
- روی اجرا کلیک کنید.
بهروزرسانی یک پرسوجوی ذخیرهشده
برای بهروزرسانی یک پرسوجوی ذخیرهشدهی موجود، مراحل زیر را دنبال کنید:
- در ویرایشگر پرسوجو ، پرسوجوهای ذخیرهشده کلیک کنید.
- برای باز کردن یک کوئری ذخیره شده در یک تب ویرایشگر جدید، روی آن کلیک کنید. به صورت اختیاری، میتوانید روی View actions در کنار یک کوئری ذخیره شده کلیک کنید. سپس، روی Open query کلیک کنید تا آن را در یک تب ویرایشگر جدید باز کنید.
- پرسوجو را اصلاح کنید.
- برای ذخیره پرس و جوی اصلاح شده، روی ذخیره کلیک کنید.
مشاهده و مدیریت لیستی از تمام پرس و جوهای ذخیره شده
برای مشاهده لیست تمام کوئریهای ذخیره شده در پروژه خود، مراحل زیر را دنبال کنید:
در کنسول گوگل کلود، به صفحهی «پرسشهای ذخیرهشده» بروید.
به جستجوهای ذخیره شده برویدشما میتوانید در صفحه «پرسشهای ذخیرهشده» جستجو، فیلتر، مشاهده و حذف پرسوجوها را انجام دهید. در صفحه «پرسشهای ذخیرهشده» نمیتوانید پرسوجوی موجود را ویرایش کنید.
حذف یک پرسوجوی ذخیرهشده
میتوانید یک کوئری ذخیرهشده را از صفحه Cloud Firestore Studio یا در صفحه Saved queries در کنسول Google Cloud حذف کنید.
- در ویرایشگر پرسوجو ، پرسوجوهای ذخیرهشده کلیک کنید.
- برای مشاهده اقدامات کنار پرسوجوی ذخیرهشدهای که میخواهید حذف کنید، روی کلیک کنید. سپس، برای حذف پرسوجوی ذخیرهشده، روی Delete query کلیک کنید.
- در کادر محاورهای حذف پرسوجو ، روی حذف کلیک کنید.
همچنین میتوانید یک پرسوجوی ذخیرهشده را در صفحه «پرسوجوهای ذخیرهشده» حذف کنید. برای حذف یک پرسوجوی ذخیرهشده در صفحه «پرسوجوهای ذخیرهشده» ، این مراحل را دنبال کنید:
- به صفحه جستجوهای ذخیره شده بروید.
- روی کلیک کنید تا اقدامات کنار پرسوجوی ذخیرهشدهای که میخواهید حذف کنید، نمایش داده شود .
- برای حذف پرسوجوی ذخیرهشده، روی «حذف پرسوجو» کلیک کنید.
- در کادر محاورهای حذف پرسوجو ، روی حذف کلیک کنید.
قدم بعدی چیست؟
- درباره پرسوجوهای ذخیرهشده اطلاعات کسب کنید.