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

במאמר הזה מוסבר איך לנהל שאילתות שמורות ושאילתות שמורות קלאסיות ואיך לנהל מטא-נתונים של שאילתות שמורות ב-Dataplex Universal Catalog.

שאילתות שמורות הן נכסי קוד של BigQuery Studio שמבוססים על Dataform.

לפני שמתחילים

אפשר גם להגדיר הרשאות IAM בשאילתות שמורות ציבוריות או בפרויקט שעברו העברה, ליצור או לבחור שאילתה שמורה ב-BigQuery Studio ולהעניק הרשאות IAM נבחרות לשאילתה השמורה הזו.

במהלך ההעברה של שאילתות שמורות ציבוריות או של פרויקטים קלאסיים לשאילתות שמורות ב-BigQuery Studio, בוחרים שאילתה שמורה ב-BigQuery Studio כדי להעתיק את ההרשאות שניתנו לה לשאילתות השמורות שהועברו.

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

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

• כדי לנהל שאילתות שמורות ב-BigQuery Studio במסוף Google Cloud :
  • BigQuery Job User (roles/bigquery.jobUser)
  • BigQuery Read Session User (roles/bigquery.readSessionUser)
  • בעלים של קוד (roles/dataform.codeOwner)
• כדי לנהל שאילתות שמורות ב-BigQuery Studio באמצעות BigQuery API: בעלי קוד (roles/dataform.codeOwner)
• כדי להעביר שאילתות שמורות מפרויקט בגרסה הקלאסית של BigQuery לשאילתות שמורות ב-BigQuery Studio: BigQuery Studio Admin (roles/bigquery.studioAdmin)
• כדי לאפשר למשתמשים מאומתים לצפות בשאילתות עם גישה ציבורית: צפייה בקוד (roles/dataform.codeViewer)

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

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

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

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

• כדי לנהל שאילתות שמורות ב-BigQuery Studio במסוף Google Cloud : bigquery.config.get, bigquery.jobs.create, dataform.locations., resourcemanager.projects.get, resourcemanager.projects.list, bigquery.readsessions., dataform.repositories., dataform.workspaces.
• כדי לנהל שאילתות שמורות ב-BigQuery Studio באמצעות BigQuery API: dataform.locations., dataform.repositories., dataform.workspaces.*, resourcemanager.projects.get, resourcemanager.projects.list
• כדי להעביר שאילתות שמורות קלאסיות בפרויקט לשאילתות שמורות ב-BigQuery Studio: bigquery.savedqueries.get, bigquery.savedqueries.list, bigquery.savedqueries.update, bigquery.savedqueries.delete, bigquery.savedqueries.create
• כדי שמשתמשים מאומתים יוכלו לצפות בשאילתות עם גישה ציבורית: dataform.locations.*, dataform.repositories.computeAccessTokenStatus, dataform.repositories.fetchHistory, dataform.repositories.fetchRemoteBranches, dataform.repositories.get, dataform.repositories.getIamPolicy, dataform.repositories.list, dataform.repositories.queryDirectoryContents, dataform.repositories.readFile, dataform.workspaces.fetchFileDiff, dataform.workspaces.fetchFileGitStatuses, dataform.workspaces.fetchGitAheadBehind. dataform.workspaces.get, dataform.workspaces.getIamPolicy, dataform.workspaces.list, dataform.workspaces.queryDirectoryContents, dataform.workspaces.readFile, dataform.workspaces.searchFiles, resourcemanager.projects.get, resourcemanager.projects.list

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

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

כדי לנהל מטא-נתונים של שאילתות שמורות ב-Dataplex Universal Catalog, צריך לוודא שיש לכם את התפקידים הנדרשים ב-Dataplex Universal Catalog ואת ההרשאה dataform.repositories.get.

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

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

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

איך מעניקים גישה ציבורית לשאילתה שמורה

כדי להעניק גישה ציבורית לשאילתה שמורה ב-BigQuery Studio, צריך להעניק את התפקיד Code Viewer ‏ (roles/dataform.codeViewer) בשאילתה השמורה למשתמש allAuthenticatedUsers.

כשמקצים תפקיד IAM לחשבון המשתמש allAuthenticatedUsers, חשבונות השירות וכל המשתמשים באינטרנט שאומתו באמצעות חשבון Google מקבלים את התפקיד הזה. החשבונות האלה כוללים חשבונות שלא מחוברים לחשבון Google Workspace או לדומיין ב-Cloud Identity, כמו חשבונות Gmail אישיים. משתמשים לא מאומתים, כמו מבקרים אנונימיים, לא נכללים בו. מידע נוסף זמין במאמר כל המשתמשים המאומתים.

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

זהירות: מתן הרשאות אדמין, עריכה או הרשאות ברמת ההפעלה ל-allAuthenticatedUsers עלול לאפשר לגורמים זדוניים לגשת לנתונים שלכם. מומלץ לתת רק את ההרשאות המינימליות הנדרשות.

כדי להעניק גישה ציבורית לשאילתה שמורה ב-BigQuery Studio:

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

   כניסה ל-BigQuery

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

   

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

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

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

5. לוחצים על הצגת פעולות לצד השאילתה השמורה, ואז לוחצים על שיתוף > ניהול הרשאות.

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

7. בשדה New principals, מזינים allAuthenticatedUsers.

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

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

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

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

כדי לוודא שלא ניתנת גישה ציבורית לשום שאילתה שנשמרה ב-BigQuery Studio, צריך להגביל את העיקרון allAuthenticatedUsers בפרויקט.

כדי להגביל את allAuthenticatedUsers בפרויקט, אפשר להגדיר את המדיניות של iam.allowedPolicyMemberDomains ולהסיר את allAuthenticatedUsers מהרשימה של allowed_values.

כשמגבילים את allAuthenticatedUsers במדיניות iam.allowedPolicyMemberDomains, אי אפשר להשתמש בחשבון הראשי allAuthenticatedUsers באף מדיניות IAM בפרויקט, וכך נמנעת הענקת גישה ציבורית לכל המשאבים, כולל שאילתות שמורות ב-BigQuery Studio.

מידע נוסף על המדיניות iam.allowedPolicyMemberDomains והוראות להגדרתה זמין במאמר הגבלת זהויות לפי דומיין.

הגדרת אזור ברירת מחדל

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

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

   

3. בחלונית Explorer, לוחצים על View actions לצד Queries, ואז מבצעים אחת מהפעולות הבאות:

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

צפייה במטא-נתונים של שאילתות שמורות

כדי להציג את המטא-נתונים של שאילתה שנשמרה:

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

   כניסה ל-BigQuery

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

   

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

4. מחפשים את השאילתה השמורה שרוצים לראות את המטא-נתונים שלה ולוחצים עליה.

5. לוחצים על מידע פרטים כדי לראות מידע על השאילתה השמורה, כמו האזור שבו היא משתמשת והתאריך שבו היא שונתה לאחרונה.

עבודה עם גרסאות של שאילתות שמורות

אפשר ליצור שאילתה שמורה בתוך מאגר או מחוצה לו. הטיפול בניהול גרסאות של שאילתות שמורות שונה בהתאם למיקום של השאילתה השמורה.

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

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

ניהול גרסאות של שאילתות שמורות מחוץ למאגרים

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

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

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

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

   כניסה ל-BigQuery

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

   

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

4. לוחצים על השם של השאילתה השמורה שרוצים לראות את היסטוריית הגרסאות שלה.

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

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

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

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

   כניסה ל-BigQuery

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

   

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

4. לוחצים על השם של השאילתה השמורה שרוצים להשוות את פרטי הגרסה שלה.

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

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

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

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

שחזור גרסה של שאילתה שמורה

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

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

   

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

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

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

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

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

7. לוחצים על אישור.

פתיחת שאילתות שמורות בגיליונות מקושרים

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

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

   כניסה ל-BigQuery

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

   

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

4. לצד השאילתה השמורה, לוחצים על פתיחת פעולות ואז על פתיחה ב-> Connected Sheets.

   לחלופין, לוחצים על שם השאילתה השמורה כדי לפתוח אותה בחלונית הפרטים, ואז לוחצים על פתיחה ב-> Connected Sheets.

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

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

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

   כניסה ל-BigQuery

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

   

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

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

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

Delete saved queries

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

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

   כניסה ל-BigQuery

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

   

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

4. מחפשים את השאילתה השמורה שרוצים למחוק.

5. לצד השאילתה השמורה, לוחצים על פתיחת פעולות ואז על מחיקה.

6. כדי לאשר את המחיקה, מקלידים delete בתיבת הדו-שיח.

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

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

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

בקטעים הבאים מוסבר איך לנהל שאילתות שמורות קלאסיות.

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

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

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

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

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

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

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. בתיבת הדו-שיח שמירת שאילתה, מקלידים שם ובוחרים את המיקום של השאילתה.

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

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

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

אפשר להעביר בקבוצות את השאילתות הקלאסיות השמורות הבאות:

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

רק המשתמש שיצר שאילתות שמורות קלאסיות יכול לראות אותן. הם מזוהים באמצעות הסמל . רק הבעלים של השאילתות יכולים להעביר אותן.

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

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

ההרשאות ב-IAM בשאילתות שמורות ציבוריות בגרסה הקלאסית לא תואמות להרשאות בשאילתות שמורות ב-BigQuery Studio. המשמעות היא ששאילתות שמורות ב-BigQuery Studio שהועברו משאילתות שמורות ציבוריות קלאסיות לא זמינות לציבור כברירת מחדל. צריך להגדיר הרשאות IAM לשאילתות שמורות ב-BigQuery Studio שהועברו, במהלך ההעברה או אחריה.

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

אם לא תגדירו הרשאות IAM במהלך ההעברה, רק לכם תהיה גישה לשאילתות השמורות שהועברו מ-BigQuery Studio.

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

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

הרשאות IAM בשאילתות שמורות קלאסיות בפרויקט לא ממופות ישירות להרשאות בשאילתות שמורות ב-BigQuery Studio. צריך להגדיר הרשאות IAM לשאילתות שמורות ב-BigQuery Studio שהועברו, במהלך ההעברה או אחריה.

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

אם לא מגדירים הרשאות IAM במהלך ההעברה, רק לכם תהיה גישה לשאילתות השמורות שהועברו מ-BigQuery Studio.

במהלך העברת קבוצות של שאילתות שמורות קלאסיות, BigQuery מבצע את הפעולות הבאות:

• כל השאילתות השמורות הקלאסיות שמועברות נשמרות כשאילתות שמורות ב-BigQuery Studio, ומאוחסנות באזור שנבחר.
• ממיר את כל השאילתות השמורות בגרסה הקלאסית שעוברות מיגרציה לשאילתות שמורות בגרסה הקלאסית לקריאה בלבד.

אחרי המיגרציה, תוכלו לגשת לשאילתות השמורות האישיות, הציבוריות והפרויקטים הקלאסיות שלכם גם כשאילתות שמורות ב-BigQuery Studio וגם כשאילתות שמורות קלאסיות לקריאה בלבד.

סיכונים בהעברה

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

מערכת BigQuery תוסיף את השאילתות השמורות שהועברו מ-BigQuery Studio לפרויקט Google Cloud באמצעות Dataform API. כדי לבטל את השינויים האלה צריך לבצע ניקוי ידני.

אזהרה: אחרי שמתחילים העברה, אי אפשר להפסיק או לבטל אותה.

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

כדי להעביר שאילתות שמורות קלאסיות בפרויקט שלכם ל-BigQuery Studio בכמות גדולה:

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

   כניסה ל-BigQuery

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

   

3. בחלונית Classic Explorer, מרחיבים את הפרויקט ולוחצים על View actions (הצגת פעולות) לצד (Classic) Queries (שאילתות (קלאסיות)), ואז לוחצים על Migrate classic saved queries (העברת שאילתות קלאסיות שמורות).

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

   הרשאות ה-IAM שלכם קובעות איזה סוג של שאילתות קלאסיות שמורות תוכלו להעביר ואילו חלקים בחלונית העברת שאילתות קלאסיות שמורות יהיו גלויים לכם.

5. בקטע Region, בתפריט הנפתח Region, בוחרים אזור שבו BigQuery יאחסן את השאילתות השמורות שהועברו.

   מומלץ לבחור את האזור שמוגדר כברירת מחדל לנכסי קוד ב-BigQuery Studio. מידע נוסף מופיע במאמר בנושא הגדרת אזור ברירת המחדל.

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

7. כדי להעביר את כל השאילתות הציבוריות הקלאסיות השמורות בפרויקט, בקטע העברת שאילתות ציבוריות:

   1. מסמנים את התיבה העברת כל השאילתות הציבוריות.
   2. בתפריט הנפתח SQL, בוחרים שאילתה שמורה ב-BigQuery Studio שיש לה את מדיניות ה-IAM שרוצים להחיל על השאילתות השמורות שהועברו.

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

      כדי לשתף את השאילתות השמורות שהועברו באופן ציבורי, צריך להגדיר את allAuthenticatedUsers כישות מורשית ולתת לה את התפקיד Code Viewer. מידע נוסף זמין במאמר בנושא הענקת גישה ציבורית.

   4. לוחצים על הבא.

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

   1. מסמנים את תיבת הסימון העברת כל השאילתות של הפרויקט.
   2. בתפריט הנפתח SQL, בוחרים שאילתה שמורה ב-BigQuery Studio שיש לה את מדיניות ה-IAM שרוצים להחיל על השאילתות השמורות שהועברו.
   3. אופציונלי: כדי להוסיף משתמש או קבוצה שרוצים לשתף איתם את השאילתות השמורות שהועברו, לוחצים על הוספת משתמש או קבוצה.
   4. לוחצים על הבא.

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

   אזהרה: אחרי שמתחילים העברה, אי אפשר להפסיק או לבטל אותה.

10. לוחצים על שליחה.

ההעברה יכולה להימשך יותר מ-15 דקות, בהתאם למספר השאילתות שמועברות.

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

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

   כניסה ל-BigQuery

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

   

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

4. מאתרים את השאילתה הקלאסית השמורה שרוצים למחוק.

5. לצד השאילתה, לוחצים על View actions (הצגת פעולות) ואז על Delete (מחיקה).

6. כדי לאשר את המחיקה, מקלידים delete בתיבת הדו-שיח.

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

ניהול מטא-נתונים ב-Dataplex Universal Catalog

ב-Dataplex Universal Catalog אפשר לאחסן ולנהל מטא-נתונים של שאילתות שמורות. כברירת מחדל, שאילתות שמורות זמינות ב-Dataplex Universal Catalog בלי צורך בהגדרה נוספת.

אתם יכולים להשתמש ב-Dataplex Universal Catalog כדי לנהל שאילתות שמורות בכל המיקומים של השאילתות השמורות. השימוש בשאילתות שמורות ב-Dataplex Universal Catalog כפוף למכסות ולמגבלות של Dataplex Universal Catalog ולתמחור של Dataplex Universal Catalog.

‫Dataplex Universal Catalog מאחזר באופן אוטומטי את המטא-נתונים הבאים משאילתות שנשמרו:

• שם נכס הנתונים
• נכס הורה של נתוני נכס
• מיקום נכס הנתונים
• סוג נכס הנתונים
• פרויקט Google Cloud מתאים

Dataplex Universal Catalog שומר שאילתות שמורות כרשומות עם ערכי הרשומות הבאים:

קבוצת רשומות של מערכת

קבוצת הרשומות במערכת של שאילתות שמורות היא @dataform. כדי לראות את הפרטים של רשומות השאילתות השמורות ב-Dataplex Universal Catalog, צריך להציג את קבוצת רשומות המערכת dataform. הוראות להצגת רשימה של כל הרשומות בקבוצת רשומות מופיעות במאמר הצגת הפרטים של קבוצת רשומות במסמכי התיעוד של Dataplex Universal Catalog.

סוג רשומה של מערכת

סוג הרשומה במערכת של שאילתות שמורות הוא dataform-code-asset. כדי לראות את הפרטים של שאילתות שמורות, צריך להציג את dataform-code-asset סוג הרשומה של המערכת, לסנן את התוצאות באמצעות מסנן מבוסס-היבטים ולהגדיר את השדה type בתוך ההיבט dataform-code-asset לערך SQL_QUERY. לאחר מכן, בוחרים רשומה של השאילתה השמורה שנבחרה. הוראות להצגת הפרטים של סוג רשומה נבחר מופיעות במאמר הצגת הפרטים של סוג רשומה בתיעוד של Dataplex Universal Catalog. הוראות להצגת הפרטים של רשומה נבחרת מופיעות במאמר הצגת הפרטים של רשומה בתיעוד של Dataplex Universal Catalog.

סוג ההיבט של המערכת

‫

סוג ההיבט של המערכת לשאילתות שמורות הוא dataform-code-asset. כדי לספק הקשר נוסף לשאילתות שמורות ב-Dataplex Universal Catalog על ידי הוספת הערות לערכים של שאילתות שמורות עם מאפיינים, צריך להציג את סוג המאפיין dataform-code-asset, לסנן את התוצאות באמצעות מסנן מבוסס-מאפיינים ולהגדיר את השדה type בתוך המאפיין dataform-code-asset לערך SQL_QUERY. הוראות להוספת הערות להיבטים של רשומות מופיעות במאמר ניהול היבטים והעשרת מטא-נתונים במסמכי התיעוד של Dataplex Universal Catalog.

סוג

הסוג של שאילתות שמורות הוא SQL_QUERY. הסוג הזה מאפשר לכם לסנן שאילתות שמורות בdataform-code-asset סוג הרשומה של המערכת ובdataform-code-assetסוג ההיבט באמצעות השאילתה במסנן מבוסס-היבט.aspect:dataplex-types.global.dataform-code-asset.type=SQL_QUERY

הוראות לחיפוש נכסים ב-Dataplex Universal Catalog מופיעות במאמר חיפוש נכסי נתונים ב-Dataplex Universal Catalog במסמכי התיעוד של Dataplex Universal Catalog.

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

• מידע נוסף על שאילתות שמורות ב-BigQuery Studio זמין במאמר מבוא לשאילתות שמורות .
• במאמר יצירת שאילתות שמורות מוסבר איך ליצור שאילתות שמורות.