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

בדף הזה נסביר איך ליצור ולנהל שאילתות שמורות. כשכותבים שאילתות ב-Cloud Firestore Studio, אפשר לשמור ולנהל אותן. מידע נוסף זמין במאמר סקירה כללית על שאילתות שמורות.

האפשרות לשמור שאילתות זמינה רק במסוף Google Cloud.

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

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

• כדי לראות את השאילתות השמורות: Cloud Datastore Viewer (roles/datastore.viewer)
• כדי לראות, ליצור, לשנות ולמחוק שאילתות שמורות: Cloud Datastore User (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 Query User (roles/databasesconsole.studioQueryUser) מאפשר ליצור שאילתות שמורות, לצפות בהן ולכתוב אותן. התפקיד הזה מתאים לרוב המשתמשים.

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

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

כדי ליצור שאילתה שמורה, פועלים לפי השלבים הבאים:

1. נכנסים לדף All databases במסוף Google Cloud.
   All databases
2. בוחרים Cloud Firestore מסד נתונים שבו רוצים ליצור שאילתה שמורה.
3. בתפריט הניווט, לוחצים על Cloud Firestore Studio.
4. בחלונית Explorer בדף Cloud Firestore Studio, עוברים לקטע Collections.
5. לוחצים על אוסף כדי לפתוח כרטיסייה חדשה בעורך. אפשר גם ללחוץ על more_vert הצגת פעולות לצד אוסף. לאחר מכן, לוחצים על Query collection כדי לפתוח כרטיסייה חדשה בעורך.
6. מזינים שאילתה בעורך השאילתות.
7. לוחצים על שמירה.
8. בתיבת הדו-שיח שמירת השאילתה, מזינים שם לשאילתה השמורה.
9. לוחצים על שמירה.

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

כדי לפתוח שאילתה שנשמרה בתור שאילתה חדשה, פועלים לפי השלבים הבאים:

1. בחלונית Explorer בדף Cloud Firestore Studio, עוברים לקטע Queries.
2. לוחצים על שאילתה שנשמרה כדי לפתוח אותה בכרטיסייה חדשה של העורך. לחלופין, אפשר ללחוץ על more_vert View actions (הצגת פעולות) לצד שאילתה שנשמרה, ואז ללחוץ על Open query (פתיחת שאילתה) כדי לפתוח אותה בכרטיסייה חדשה של העורך.
3. לוחצים על Run.

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

כדי לעדכן שאילתה שמורה קיימת, בצעו את השלבים הבאים:

1. בחלונית Explorer בדף Cloud Firestore Studio, עוברים לקטע Queries.
2. לוחצים על שאילתה שנשמרה כדי לפתוח אותה בכרטיסייה חדשה של העורך. לחלופין, אפשר ללחוץ על more_vert View actions (הצגת פעולות) לצד שאילתה שנשמרה, ואז ללחוץ על Open query (פתיחת שאילתה) כדי לפתוח אותה בכרטיסייה חדשה של העורך.
3. משנים את השאילתה.
4. כדי לשמור את השאילתה ששיניתם, לוחצים על שמירה.

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

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

1. נכנסים לדף All databases במסוף Google Cloud.
   All databases
2. בוחרים מסד נתונים כלשהו. שאילתה שמורה היא צאצא של פרויקט, ולכן כל עוד יש לכם את התפקיד הנדרש, אתם יכולים לראות את כל השאילתות השמורות בפרויקט מכל מסד נתונים.

3. בוחרים מסד נתונים כלשהו.
4. בחלונית Explorer בדף Cloud Firestore Studio, עוברים לקטע Queries.
5. לצד שאילתה שמורה, לוחצים על more_vert הצגת פעולות. לאחר מכן לוחצים על ניהול שאילתות.

   נפתח הדף Saved queries (שאילתות שמורות). בדף הזה מפורטות כל השאילתות השמורות בפרויקט הזה, כולל שאילתות שמורות למוצרי Google Cloud אחרים.

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

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

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

1. בחלונית Explorer בדף Cloud Firestore Studio, עוברים לקטע Queries.
2. לצד השאילתה השמורה שרוצים למחוק, לוחצים על more_vert הצגת פעולות. כדי למחוק את השאילתה השמורה, לוחצים על מחיקת השאילתה.
3. בתיבת הדו-שיח מחיקת שאילתה, לוחצים על מחיקה.

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

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

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

• מידע נוסף על שאילתות שמורות