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

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

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

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

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

  • כדי לצפות בשאילתות שמורות: Bigtable Reader‏ (roles/bigtable.reader)
  • כדי לראות, ליצור, לשנות ולמחוק שאילתות שמורות: Bigtable User‏ (roles/bigtable.user)
  • כדי לנהל, להציג, ליצור, לשנות ולמחוק שאילתות שמורות: אדמין ב-Bigtable (roles/bigtable.admin). התפקיד הזה כולל הרשאות נרחבות ומספק גישה מלאה ל-Bigtable, לשימוש של אדמינים בלבד.

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

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

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

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

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

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

  1. נכנסים לדף Instances של Bigtable במסוף Google Cloud .
    מכונות
  2. בוחרים את המכונה שבה רוצים ליצור שאילתה שמורה.

  3. בתפריט הניווט, לוחצים על Bigtable Studio.

    בחלונית Explorer מוצגת רשימה של טבלאות, תצוגות ושאילתות במכונה.

  4. מריצים את השאילתה מהכרטיסייה Editor.

    התוצאות מופיעות בטבלה תוצאות.

  5. אם אתם לא מרוצים מהתוצאות, אתם יכולים לשנות את השאילתה ולהריץ אותה שוב. כשמרוצים מהשאילתה, לוחצים על Save.
  6. בתיבת הדו-שיח Save query, נותנים שם לשאילתה השמורה.
  7. לוחצים על Save.

אופציונלי:

  • כדי לשמור את השאילתה בשם אחר, לוחצים על החץ להרחבה Save as, בוחרים באפשרות Save as query ומזינים שם חדש בתיבת הדו-שיח.
  • כדי לשנות את האזור שבו נעשה שימוש בשאילתה השמורה הזו, לוחצים על הצגת אפשרויות מתקדמות. אחר כך בוחרים אזור מהרשימה Region.

אפשר גם לשמור את השאילתה כתצוגה לוגית או כתצוגה מהותית רציפה.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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