יצירה וניהול של שאילתות שמורות

כדי לעשות שימוש חוזר בפעולות נפוצות במסד הנתונים ולשתף אותן בין סשנים, אתם יכולים ליצור, לארגן ולנהל שאילתות שמורות במסוף Firebase. מידע נוסף זמין במאמר סקירה כללית על שאילתות שמורות.

היכולת לשמור שאילתות זמינה רק במסוף, ולא באמצעות ממשקי API.

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות לשימוש בשאילתות שמורות, בקשו מהאדמין להקצות לכם את התפקידים הבאים של ניהול הזהויות והרשאות הגישה (IAM) בפרויקט:

• כדי לצפות בשאילתות שמורות: צפייה ב-Cloud Datastore‏ (roles/datastore.viewer)
• כדי לראות, ליצור, לשנות ולמחוק שאילתות שמורות: משתמש ב-Cloud Datastore‏ (roles/datastore.user)
• כדי לנהל, להציג, ליצור, לשנות ולמחוק שאילתות שמורות: בעלים של Cloud Datastore ‏(roles/datastore.owner). לתפקיד הזה יש הרשאות נרחבות והוא מספק גישה מלאה ל-Cloud Firestore, לשימוש של אדמינים בלבד.

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקידים המוגדרים מראש האלה מכילים את ההרשאות שנדרשות כדי להשתמש בשאילתות שמורות. למידע נוסף על ההרשאות הנדרשות, ראו ההרשאות הנדרשות.

ההרשאות הנדרשות

כדי ליצור, להציג, לשנות ולמחוק שאילתות שמורות, צריך את ההרשאות הבאות ב-IAM ברמת הפרויקט:

פעולה	הרשאות 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) נותן גישה ליצירה, לצפייה ולכתיבה של שאילתות שמורות. התפקיד הזה מתאים לצרכים של רוב המשתמשים.

הקצו את התפקיד אדמין של שאילתות ב-Studio (roles/databasesconsole.studioQueryAdmin) רק לאדמינים. למידע נוסף על IAM ב-Cloud Firestore, קראו את המאמר ניהול זהויות והרשאות גישה.

יצירת שאילתה שמורה

כדי ליצור שאילתה שמורה:

1. נכנסים לדף Cloud Firestore במסוף Firebase.
   Cloud Firestore
2. בוחרים את מסד הנתונים שבו רוצים ליצור שאילתה שמורה. מסד הנתונים חייב להיות מכונה של מהדורת Enterprise.
3. לוחצים על הכרטיסייה עורך השאילתות.
4. מזינים שאילתה בעורך השאילתות.
5. לוחצים על שמירה.
6. בתיבת הדו-שיח Save query, נותנים שם לשאילתה השמורה.
7. לוחצים על שמירה.

פתיחה והרצה של שאילתה שמורה

כדי לפתוח שאילתה שמורה כשאילתה חדשה:

1. בעורך השאילתות, לוחצים על שאילתות שמורות (folder).
2. לוחצים על שאילתה שמורה כדי לפתוח אותה בכרטיסייה חדשה של עורך השאילתות. אפשר גם ללחוץ על more_vert View actions ליד שאילתה שמורה. אחר כך לוחצים על Open query כדי לפתוח אותה בכרטיסייה חדשה של עורך השאילתות.
3. לוחצים על Run.

עדכון של שאילתה שמורה

כדי לעדכן שאילתה שמורה קיימת:

1. בעורך השאילתות, לוחצים על שאילתות שמורות (folder).
2. לוחצים על שאילתה שמורה כדי לפתוח אותה בכרטיסייה חדשה של עורך השאילתות. אפשר גם ללחוץ על more_vert View actions ליד שאילתה שמורה. אחר כך לוחצים על Open query כדי לפתוח אותה בכרטיסייה חדשה של עורך השאילתות.
3. משנים את השאילתה.
4. כדי לשמור את השאילתה ששיניתם, לוחצים על שמירה.

הצגה וניהול של רשימת כל השאילתות השמורות

כדי לראות רשימה של כל השאילתות השמורות בפרויקט:

במסוף Google Cloud, נכנסים לדף שאילתות שמורות.

מעבר אל Saved queries

בדף שאילתות שמורות אפשר לחפש, לסנן, להציג ולמחוק שאילתות. אי אפשר לערוך שאילתה שמורה בדף Saved queries.

מחיקת שאילתה שמורה

אפשר למחוק שאילתה שמורה מהדף Cloud Firestore Studio או מהדף Saved queries במסוף Google Cloud.

1. בעורך השאילתות, לוחצים על שאילתות שמורות (folder).
2. לוחצים על more_vert View actions לצד השאילתה השמורה שרוצים למחוק. כדי למחוק את השאילתה השמורה, לוחצים על מחיקת השאילתה.
3. בתיבת הדו-שיח Delete query, לוחצים על Delete.

אפשר גם למחוק שאילתה שמורה בדף Saved queries. כדי למחוק שאילתה שמורה בדף Saved queries:

1. עוברים לדף שאילתות שמורות.
2. לוחצים על more_vert View actions ליד השאילתה השמורה שרוצים למחוק.
3. לוחצים על מחיקת השאילתה כדי למחוק את השאילתה השמורה.
4. בתיבת הדו-שיח Delete query, לוחצים על Delete.

המאמרים הבאים

• מידע על שאילתות שמורות