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

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

היכולת לשמור שאילתות זמינה רק ב Google Cloud Console.

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

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

  • כדי לראות את השאילתות השמורות: Cloud Datastore Viewer (roles/datastore.viewer)
  • כדי לראות, ליצור, לשנות ולמחוק שאילתות שמורות: Cloud Datastore User (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
Delete saved queries
  • databasesconsole.studioQueries.delete
ניהול שאילתות שמורות
(לשימוש אדמינים בלבד)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list

אפשר לקבל את ההרשאות האלה גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

התפקיד Studio Query User (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. בתיבת הדו-שיח שמירת השאילתה, מזינים שם לשאילתה השמורה.
  9. לוחצים על Save.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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