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

כשכותבים SQL בעורך השאילתות, אפשר לשמור את השאילתה ולשתף אותה עם אחרים. שאילתות שמורות הן נכסי קוד של BigQuery Studio שמבוססים על Dataform.

מידע נוסף על מחיקת שאילתות שמורות וניהול ההיסטוריה של שאילתות שמורות זמין במאמר ניהול שאילתות שמורות.

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

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

לכל המשתמשים עם תפקיד האדמין ב-Dataform (roles/dataform.admin) יש גישת בעלים לכל השאילתות שנשמרו בפרויקט.

מידע נוסף על ניהול זהויות והרשאות גישה (IAM) ב-BigQuery זמין במאמר בקרת גישה באמצעות IAM.

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

כדי ליצור ולהריץ שאילתות שמורות, אתם צריכים את הרשאות ה-IAM הבאות:

• dataform.locations.get
• dataform.locations.list
• dataform.repositories.list

• dataform.repositories.create

  הערה: משתמשים עם ההרשאה dataform.repositories.create יכולים להריץ קוד באמצעות חשבון השירות שמוגדר כברירת מחדל ב-Dataform וכל ההרשאות שניתנו לחשבון השירות הזה. מידע נוסף זמין במאמר שיקולי אבטחה לגבי הרשאות ב-Dataform.

אפשר לקבל את ההרשאות האלה מתפקידי ה-IAM הבאים:

• BigQuery Job User (roles/bigquery.jobUser)
• BigQuery Read Session User (roles/bigquery.readSessionUser)
• Code Creator (roles/dataform.codeCreator)

אזהרה: הנראות של נכסי קוד כפופה להרשאות של Dataform ברמת הפרויקט. משתמשים עם ההרשאה dataform.repositories.list – שכלולה בתפקידים סטנדרטיים ב-BigQuery כמו BigQuery Job User,‏ BigQuery Studio User ו-BigQuery User – יכולים לראות את כל נכסי הקוד בחלונית Explorer של הפרויקט Google Cloud , בלי קשר לשאלה אם הם יצרו את הנכסים האלה או שהנכסים האלה שותפו איתם. כדי להגביל את הנראות, אפשר ליצור תפקידים בהתאמה אישית שלא כוללים את ההרשאה dataform.repositories.list.

הערה: משתמשים שהוקצה להם התפקיד 'יצירת קוד' בפרויקט יכולים לראות את השמות של נכסי הקוד בפרויקט הזה באמצעות Dataform API או ממשק שורת הפקודה (CLI) של Dataform.

הערה: כשיוצרים שאילתה שמורה, BigQuery מעניק לכם את תפקיד האדמין של Dataform (roles/dataform.admin) בשאילתה השמורה הזו. לכל המשתמשים שהוקצה להם התפקיד Dataform Admin בפרויקט יש גישת בעלים לכל השאילתות השמורות שנוצרו בפרויקט. Google Cloud כדי לשנות את ההתנהגות הזו, אפשר לקרוא את המאמר הקצאת תפקיד ספציפי בזמן יצירת משאב.

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

כדי לערוך ולהריץ שאילתות שמורות, אתם צריכים את תפקידי ה-IAM הבאים:

• BigQuery Job User (roles/bigquery.jobUser)
• BigQuery Read Session User (roles/bigquery.readSessionUser)
• עורך קוד (roles/dataform.codeEditor)

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

כדי להציג ולהריץ שאילתות שמורות, אתם צריכים את תפקידי ה-IAM הבאים:

• BigQuery Job User (roles/bigquery.jobUser)
• BigQuery Read Session User (roles/bigquery.readSessionUser)
• צפייה בקוד (roles/dataform.codeViewer)

הגדרת אזור ברירת המחדל לנכסי קוד

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

הערה: אם יוצרים שאילתה שמורה ובוחרים אזור ברירת מחדל שונה מזה שבו השתמשתם עד עכשיו עבור נכסי קוד, למשל בחירה באזור us-west1 כשעד עכשיו השתמשתם באזור us-central1, אז השאילתה הזו וכל נכסי הקוד שתיצרו אחרי כן ישתמשו באזור החדש הזה כברירת מחדל. נכסי קוד קיימים ממשיכים להשתמש באזור שהוקצה להם כשהם נוצרו.

כל נכסי הקוד ב-BigQuery Studio משתמשים באותו אזור ברירת מחדל. כדי להגדיר את אזור ברירת המחדל לנכסי קוד:

1. עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. בחלונית Explorer, מחפשים את הפרויקט שבו הפעלתם נכסי קוד.

3. לצד הפרויקט, לוחצים על View actions (הצגת פעולות) ואז על Change my default code region (שינוי אזור הקוד שמוגדר כברירת מחדל).

4. בקטע Region בוחרים את האזור שבו רוצים להשתמש בנכסי קוד.

5. לוחצים על בחירה.

רשימת האזורים הנתמכים מופיעה במאמר מיקומים ב-BigQuery Studio.

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

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

1. במסוף Google Cloud , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. לוחצים על שאילתת SQL.

3. מזינים שאילתת SQL תקינה בעורך השאילתות. לדוגמה, אתם יכולים להריץ שאילתה על מערך נתונים ציבורי:

   SELECT
     name,
     SUM(number) AS total
   FROM
     `bigquery-public-data.usa_names.usa_1910_2013`
   GROUP BY
     name
   ORDER BY
     total DESC
   LIMIT
     10;

   לחלופין, אפשר להשתמש בחלונית Reference כדי ליצור שאילתות חדשות.

4. לוחצים על שמירה > שמירת שאילתה או מקישים על Control+S (או על Command+S ב-macOS).

5. בתיבת הדו-שיח Save query (שמירת שאילתה), מקלידים שם לשאילתה השמורה.

6. אופציונלי: כדי לשנות את האזור שבו נעשה שימוש בשאילתה השמורה הזו ובכל נכסי הקוד האחרים בעתיד, בוחרים אזור חדש בשדה אזור.

7. לוחצים על Save.

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

8. אופציונלי: אחרי ששומרים את השאילתה, אפשר להשתמש בסרגל הכלים הבא כדי לראות את פרטי השאילתה או את היסטוריית הגרסאות, להוסיף תגובות חדשות, להשיב לתגובות קיימות או לקבל קישור אליהן:

   

   התכונה תגובות בסרגל הכלים נמצאת בגרסת טרום-השקה. כדי לשלוח משוב או לבקש תמיכה בנוגע לתכונה הזו, אפשר לשלוח אימייל לכתובת [e-mail].

שיתוף שאילתות שמורות

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

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

1. במסוף Google Cloud , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. בחלונית הימנית, לוחצים על כלי הניתוחים:

   

   אם החלונית הימנית לא מוצגת, לוחצים על הרחבת החלונית הימנית כדי לפתוח אותה.

3. בחלונית Explorer, מרחיבים את הפרויקט ולוחצים על Queries.

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

5. לוחצים על שיתוף ואז על ניהול הרשאות.

6. בחלונית Manage permissions, לוחצים על Add user/group.

7. בשדה New principals, מזינים חשבון משתמש.

8. ברשימה Role, בוחרים באחד מהתפקידים הבאים:

   • בעלים של הקוד: יכולים לבצע כל פעולה בשאילתה השמורה, כולל מחיקה או שיתוף שלה.
   • עורך קוד: יכול לערוך את השאילתה.
   • Code Viewer: יכול לצפות בשאילתה.
   הערה: כדי להריץ את השאילתה השמורה, ל-principal צריך להיות גם התפקיד משתמש ב-BigQuery ‏ (roles/bigquery.user).

9. אופציונלי: כדי לראות רשימה מלאה של תפקידים והגדרות שיתוף מתקדמות, לוחצים על שיתוף מתקדם.

10. לוחצים על Save.

11. כדי לחזור לפרטי השאילתה השמורה, לוחצים על סגירה.

12. כדי ליצור קישור לשאילתה השמורה, לוחצים על שיתוף ואז על קבלת קישור.

    הקישור מועתק ללוח.

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

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

1. במסוף Google Cloud , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. בחלונית הימנית, לוחצים על כלי הניתוחים:

   

   אם החלונית הימנית לא מוצגת, לוחצים על הרחבת החלונית הימנית כדי לפתוח אותה.

3. בחלונית Explorer, מרחיבים את הפרויקט ולוחצים על Queries.

4. בוחרים שאילתה שמורה. אפשר להשתמש בתכונת החיפוש או במסננים כדי למצוא את השאילתה.

5. לוחצים על Version history (היסטוריית גרסאות).

6. לצד גרסה של שאילתה שנשמרה, לוחצים על הצגת פעולות ואז על פתיחה כשאילתה חדשה.

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

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

1. במסוף Google Cloud , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. בחלונית הימנית, לוחצים על כלי הניתוחים:

   

3. בחלונית Explorer, מרחיבים את הפרויקט ולוחצים על Queries.

4. בוחרים שאילתה שמורה. אפשר להשתמש בתכונת החיפוש או במסננים כדי למצוא את השאילתה.

5. משנים את השאילתה.

6. כדי לשמור את השאילתה ששיניתם, לוחצים על שמירת השאילתה > שמירת השאילתה או מקישים על Control+S (או על Command+S ב-macOS).

   נוצרת גרסה חדשה של השאילתה.

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

אפשר להעלות שאילתת SQL מקומית כדי להשתמש בה כשאילתה שמורה ב-BigQuery Studio. השאילתה השמורה שהועלתה מופיעה גם בדף BigQuery במסוף Google Cloud .

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

1. במסוף Google Cloud , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. בחלונית הימנית, לוחצים על כלי הניתוחים:

   

3. בחלונית Explorer מרחיבים את הפרויקט ואז מבצעים אחת מהפעולות הבאות:

   • לצד Queries (שאילתות), לוחצים על View actions (הצגת פעולות) > Upload SQL query (העלאת שאילתת SQL).
   • לצד Google Cloud שם הפרויקט, לוחצים על הצגת פעולות > העלאה לפרויקט > שאילתת SQL.

4. בתיבת הדו-שיח העלאת SQL, בשדה SQL, לוחצים על עיון ובוחרים את השאילתה שרוצים להעלות.

5. אופציונלי: בשדה שם SQL, עורכים את שם השאילתה.

6. בשדה Region (אזור), בוחרים את האזור שבו רוצים להעלות את השאילתה השמורה.

7. לוחצים על Upload.

אפשר לגשת לשאילתה השמורה דרך החלונית Explorer.

שאילתות שמורות בגרסה הקלאסית

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

בקטעים הבאים מוסבר איך ליצור ולעדכן שאילתות שמורות בגרסה הקלאסית של Analytics. מידע נוסף על שיתוף, העברה ומחיקה של שאילתות שמורות קלאסיות זמין במאמר בנושא שאילתות שמורות קלאסיות.

הערה: אם לא הפעלתם את BigQuery Studio, שאילתות שמורות קלאסיות יופיעו בתיקייה Saved queries (NUMBER) בחלונית Classic explorer במקום בתיקייה (Classic) Queries.

הרשאות שנדרשות לשאילתות שמורות בגרסה הקלאסית

כדי ליצור, להציג, לעדכן ולמחוק שאילתות שמורות קלאסיות, צריך את הרשאות ה-IAM הבאות:

• שאילתות שמורות פרטיות בגרסה הקלאסית:
  • כדי ליצור שאילתות פרטיות שנשמרו בגרסה הקלאסית של BigQuery, לא נדרשות הרשאות מיוחדות. אפשר לשמור שאילתה פרטית בכל פרויקט, אבל רק אתם יכולים לראות, לעדכן או למחוק את השאילתה.
• שאילתות שמורות קלאסיות ברמת הפרויקט:
  • יצירה של שאילתה קלאסית שמורה ברמת הפרויקט דורשת הרשאות bigquery.savedqueries.create. התפקיד bigquery.admin שמוגדר מראש כולל את ההרשאות bigquery.savedqueries.create.
  • כדי לצפות בשאילתה קלאסית שמורה ברמת הפרויקט, נדרשות הרשאות bigquery.savedqueries.get וbigquery.savedqueries.list. התפקידים המוגדרים מראש bigquery.admin ו-bigquery.user כוללים את ההרשאות bigquery.savedqueries.get ו-bigquery.savedqueries.list.
  • עדכון של שאילתה קלאסית ששמורה ברמת הפרויקט דורש הרשאות bigquery.savedqueries.update. התפקיד bigquery.admin שמוגדר מראש כולל את ההרשאות bigquery.savedqueries.update.
  • כדי למחוק שאילתה שמורה קלאסית ברמת הפרויקט, צריך הרשאות bigquery.savedqueries.delete. התפקיד bigquery.admin שמוגדר מראש כולל את ההרשאות bigquery.savedqueries.delete.
• שאילתות ציבוריות שמורות בגרסה הקלאסית של BigQuery:
  • כדי ליצור שאילתות שמורות ציבוריות בגרסה הקלאסית, לא נדרשות הרשאות מיוחדות. אפשר לשמור שאילתה ציבורית קלאסית בכל פרויקט, אבל רק אתם יכולים לעדכן או למחוק את השאילתה. כל מי שיש לו את הקישור יכול לראות שאילתה ציבורית קלאסית שנשמרה.

הערה: משתמשים שקיבלו את ההרשאה dataform.repository.list ברמת הפרויקט יכולים לראות את כל השאילתות השמורות שנוצרו בפרויקט.

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

יצירת שאילתות שמורות קלאסיות

1. במסוף Google Cloud , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. לוחצים על שאילתת SQL.

3. מזינים שאילתת SQL תקינה בעורך השאילתות. לדוגמה, אפשר להריץ שאילתה על מערך נתונים ציבורי:

   SELECT
     name,
     SUM(number) AS total
   FROM
     `bigquery-public-data.usa_names.usa_1910_2013`
   GROUP BY
     name
   ORDER BY
     total DESC
   LIMIT
     10;

4. לוחצים על שמירת שאילתה (גרסה קלאסית) > שמירת שאילתה (גרסה קלאסית).

5. בתיבת הדו-שיח שמירת השאילתה, מזינים שם לשאילתה ומגדירים את ההרשאות לאחת מהאפשרויות הבאות:

   • אישית (אפשרות עריכה רק לכם) לשאילתה פרטית משותפת קלאסית.
   • פרויקט (ניתן לעריכה על ידי חשבונות משתמשים עם הרשאות מתאימות) לשאילתה קלאסית שמורה ברמת הפרויקט.
   • ציבורית לשאילתה ציבורית שמורה בגרסה הקלאסית של חיפוש Google.

6. לוחצים על Save.

שיתוף שאילתות קלאסיות שמורות

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

כדי לשתף שאילתה קלאסית שמורה עם משתמשים אחרים, צריך ליצור קישור לשאילתה הקלאסית השמורה ולשתף אותו.

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

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

1. בחלונית הימנית, לוחצים על קטגוריה הגרסה הקלאסית של Explorer:

   

   אם החלונית הימנית לא מוצגת, לוחצים על הרחבת החלונית הימנית כדי לפתוח אותה.

2. בחלונית Classic Explorer מרחיבים את הפרויקט, לוחצים על (Classic) Queries ואז מאתרים את השאילתה הקלאסית השמורה שרוצים לשתף.

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

4. משתפים את הקישור עם המשתמשים שרוצים להעניק להם גישה לשאילתה.

עדכון שאילתות שמורות בגרסה הקלאסית

1. במסוף Google Cloud , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. בחלונית הימנית, לוחצים על קטגוריה הגרסה הקלאסית של Explorer:

   

3. בחלונית Classic Explorer, מרחיבים את הפרויקט ואת התיקייה (Classic) Queries, ואם צריך, גם את התיקייה Project queries.

4. כדי לפתוח שאילתה קלאסית שנשמרה, לוחצים על השם שלה.

5. משנים את השאילתה.

6. כדי לשמור את השאילתה ששונתה, לוחצים על שמירת שאילתה (גרסה קלאסית) > שמירת שאילתה (גרסה קלאסית).

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

• איך מנהלים שאילתות שמורות