במאמר הזה מוסבר איך ליצור ולנהל שאילתות שמורות. כשכותבים שאילתות במסוף Firebase, אפשר לשמור ולנהל אותן. מידע נוסף מופיע במאמר סקירה כללית על שאילתות שמורות.
האפשרות לשמור שאילתות זמינה רק במסוף, ולא באמצעות ממשקי API.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לשימוש בשאילתות שמורות, צריך לבקש מהאדמין להקצות לכם את תפקידי ניהול הזהויות והרשאות הגישה (IAM) הבאים בפרויקט:
- כדי לראות שאילתות שמורות:
Cloud Datastore Viewer (
roles/datastore.viewer) - כדי להציג, ליצור, לשנות ולמחוק שאילתות שמורות:
משתמש Cloud Datastore (
roles/datastore.user) - כדי לנהל, להציג, ליצור, לשנות ולמחוק שאילתות שמורות:
בעלים של Cloud Datastore (
roles/datastore.owner). לתפקיד הזה יש הרשאות רחבות והוא מספק גישה מלאה ל-Cloud Firestore, לשימוש אדמינים בלבד.
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה מכילים את ההרשאות שנדרשות לשימוש בשאילתות שמורות. מידע נוסף על ההרשאות הנדרשות
ההרשאות הנדרשות
כדי ליצור, להציג, לשנות ולמחוק שאילתות שמורות, צריך את הרשאות ה-IAM הבאות ברמת הפרויקט:
| פעולה | הרשאות IAM נדרשות |
|---|---|
| יצירת שאילתות שמורות |
|
| צפייה בשאילתות שמורות |
|
| שינוי שאילתות שמורות |
|
| מחיקת שאילתות שמורות |
|
| ניהול שאילתות שמורות (לשימוש אדמינים בלבד) |
|
אפשר לקבל את ההרשאות האלה גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
התפקיד Studio Query User
(roles/databasesconsole.studioQueryUser)
(משתמש שאילתות ב-Studio) מספק גישה ליצירה, לצפייה ולכתיבה של שאילתות שמורות. התפקיד הזה מתאים לצרכים של רוב המשתמשים.
מקצים את התפקיד אדמין של שאילתות בסטודיו (roles/databasesconsole.studioQueryAdmin) רק לאדמינים. מידע נוסף על Cloud FirestoreIAM זמין במאמר ניהול זהויות והרשאות גישה.
יצירת שאילתה שמורה
כדי ליצור שאילתה שמורה, פועלים לפי השלבים הבאים:
- נכנסים לדף Cloud Firestore במסוף Firebase.
Cloud Firestore - בוחרים מסד נתונים שבו רוצים ליצור שאילתה שמורה. מסד הנתונים חייב להיות מופע של מהדורת Enterprise.
- לוחצים על הכרטיסייה עורך השאילתות.
- מזינים שאילתה בעורך השאילתות.
- לוחצים על שמירה.
- בתיבת הדו-שיח שמירת השאילתה, מזינים שם לשאילתה השמורה.
- לוחצים על שמירה.
פתיחה והפעלה של שאילתה שמורה
כדי לפתוח שאילתה שמורה בתור שאילתה חדשה:
- בעורך השאילתות, לוחצים על שאילתות שמורות ().
- לוחצים על שאילתה שמורה כדי לפתוח אותה בכרטיסייה חדשה בעורך. אפשר גם ללחוץ על הצגת פעולות לצד שאילתה שנשמרה. אחר כך לוחצים על Open query (פתיחת שאילתה) כדי לפתוח אותה בכרטיסייה חדשה של העורך.
- לוחצים על Run.
עדכון שאילתה שמורה
כדי לעדכן שאילתה שמורה קיימת, בצעו את השלבים הבאים:
- בעורך השאילתות, לוחצים על שאילתות שמורות ().
- לוחצים על שאילתה שמורה כדי לפתוח אותה בכרטיסייה חדשה בעורך. אפשר גם ללחוץ על הצגת פעולות לצד שאילתה שנשמרה. אחר כך לוחצים על Open query (פתיחת שאילתה) כדי לפתוח אותה בכרטיסייה חדשה של העורך.
- משנים את השאילתה.
- כדי לשמור את השאילתה ששיניתם, לוחצים על שמירה.
הצגה וניהול של רשימת כל השאילתות השמורות
כדי לראות רשימה של כל השאילתות השמורות בפרויקט, פועלים לפי השלבים הבאים:
במסוף Google Cloud, עוברים לדף Saved queries.
מעבר לשאילתות שמורותבדף שאילתות שמורות אפשר לחפש, לסנן, להציג ולמחוק שאילתות. אי אפשר לערוך שאילתה קיימת בדף שאילתות שמורות.
מחיקת שאילתה שמורה
אפשר למחוק שאילתה שמורה מהדף Cloud Firestore Studio או מהדף Saved queries במסוף Google Cloud.
- בעורך השאילתות, לוחצים על שאילתות שמורות ().
- לצד השאילתה השמורה שרוצים למחוק, לוחצים על הצגת פעולות. כדי למחוק את השאילתה השמורה, לוחצים על מחיקת השאילתה.
- בתיבת הדו-שיח מחיקת שאילתה, לוחצים על מחיקה.
אפשר גם למחוק שאילתה שמורה בדף שאילתות שמורות. כדי למחוק שאילתה שמורה בדף Saved queries (שאילתות שמורות), פועלים לפי השלבים הבאים:
- עוברים לדף שאילתות שמורות.
- לצד השאילתה השמורה שרוצים למחוק, לוחצים על הצגת פעולות.
- לוחצים על מחיקת השאילתה כדי למחוק את השאילתה השמורה.
- בתיבת הדו-שיח מחיקת שאילתה, לוחצים על מחיקה.