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

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

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

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

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

  • כדי ליצור, לערוך ולמחוק שאילתות שמורות: משתמש בשאילתות ב-Studio (roles/databasesconsole.studioQueryUser)
  • כדי לנהל את כל השאילתות השמורות בפרויקט, כולל גישה לדף Saved queries: התפקיד Studio Query Admin ‏(roles/databasesconsole.studioQueryAdmin)

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

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

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

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

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

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

  1. נכנסים לדף Instances של Spanner במסוף Google Cloud .
    מכונות
  2. בוחרים את המכונה שבה רוצים ליצור שאילתה שמורה.
  3. בוחרים את מסד הנתונים שבו רוצים ליצור שאילתה שמורה.
  4. בתפריט הניווט, לוחצים על Spanner Studio.
  5. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסיית העריכה הריקה.
  6. בעורך השאילתות, מזינים שאילתת SQL.
  7. לוחצים על Save.
  8. בתיבת הדו-שיח Save query, נותנים שם לשאילתה השמורה.
  9. לוחצים על Save.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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