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

בדף הזה מוסבר איך ליצור ולנהל שאילתות שמורות. כשכותבים שאילתות ב-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 (roles/databasesconsole.studioQueryUser) מספק גישה ליצירה, לצפייה ולכתיבה של שאילתות שמורות. התפקיד הזה מתאים לרוב המשתמשים.

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

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

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

1. נכנסים לדף All databases במסוף Google Cloud.
   כל מסדי הנתונים
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 הצגת פעולות לצד שאילתה שנשמרה. אחר כך לוחצים על Open query (פתיחת שאילתה) כדי לפתוח אותה בכרטיסייה חדשה של העורך.
3. לוחצים על Run.

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

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

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

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

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

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

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

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

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

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

אפשר למחוק שאילתה שמורה מהדף 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. בתיבת הדו-שיח מחיקת שאילתה, לוחצים על מחיקה.

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

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