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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. נכנסים לדף All databases במסוף Google Cloud .
    כל מסדי הנתונים
  2. בוחרים מסד נתונים כלשהו. שאילתה שמורה היא צאצא של פרויקט, ולכן כל עוד יש לכם את התפקיד הנדרש, אתם יכולים לראות את כל השאילתות השמורות בפרויקט מכל מסד נתונים.
  1. בוחרים מסד נתונים כלשהו.
  2. בחלונית Explorer בדף Firestore Studio, עוברים לקטע Queries.
  3. לוחצים על View actions ליד שאילתה שמורה. ואז לוחצים על ניהול שאילתות.

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

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

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

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

  1. בחלונית Explorer בדף Firestore Studio, עוברים לקטע Queries.
  2. לוחצים על View actions לצד השאילתה השמורה שרוצים למחוק. כדי למחוק את השאילתה השמורה, לוחצים על מחיקת השאילתה.
  3. בתיבת הדו-שיח Delete query, לוחצים על Delete.

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

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

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