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

במאמר הזה מוסבר איך לנהל שאילתות שמורות ושאילתות שמורות קלאסיות, ואיך לנהל מטא-נתונים של שאילתות שמורות ב-Knowledge 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)
  • ‫Code Owner (roles/dataform.codeOwner)
• כדי לנהל שאילתות שמורות ב-BigQuery Studio באמצעות BigQuery API: בעלי הקוד (roles/dataform.codeOwner)
• כדי להעביר שאילתות שמורות של פרויקט קלאסי לשאילתות שמורות של BigQuery Studio: אדמין ב-BigQuery Studio (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

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

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

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

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

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

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Files כדי לפתוח את דפדפן הקבצים.

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

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

4. לוחצים על View actions ליד השאילתה השמורה, ואז על Share > Manage permissions.

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

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

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

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

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

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

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

11. כדי ליצור קישור לשאילתה השמורה, לוחצים על View actions > Share > Copy link.

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

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

כדי לתת גישה ציבורית לשאילתה שמורה ב-BigQuery Studio, צריך לתת לחשבון הראשי allAuthenticatedUsers את התפקיד "צפייה בקוד" (roles/dataform.codeViewer) בשאילתה השמורה.

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

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

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Files כדי לפתוח את דפדפן הקבצים.

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

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

4. לוחצים על View actions ליד השאילתה השמורה, ואז על Share > Manage permissions.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. נכנסים לדף BigQuery.

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Files כדי לפתוח את דפדפן הקבצים:

   

3. ליד שם הפרויקט, לוחצים על View files panel actions > Switch code region.

4. בוחרים את אזור הקוד שרוצים להשתמש בו כברירת מחדל.

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

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

הצפנה באמצעות CMEK

אתם יכולים להצפין את השאילתות השמורות באמצעות מפתחות הצפנה בניהול הלקוח (CMEK), על ידי שימוש במפתח CMEK שמוגדר כברירת מחדל ברמת הפרויקט ל-Dataform API. אי אפשר להחיל מפתחות CMEK נפרדים על שאילתות שמורות במסוף Google Cloud . ההגדרות החדשות חלות רק על שאילתות שמורות חדשות שנוצרו.

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

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

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

   

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

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

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Files כדי לפתוח את דפדפן הקבצים.

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

3. בחלונית Files, מרחיבים את הפרויקט ואת תיקיות המשנה כדי למצוא את השאילתה השמורה שרוצים לראות את המטא-נתונים שלה.

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

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

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

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

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

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

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

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Files כדי לפתוח את דפדפן הקבצים.

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

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

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

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Files כדי לפתוח את דפדפן הקבצים.

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

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

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

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

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

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

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Files כדי לפתוח את דפדפן הקבצים.

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

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

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

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

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

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

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Files כדי לפתוח את דפדפן הקבצים.

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

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

4. לוחצים על Open actions ליד השאילתה השמורה, ואז על Open in > Connected Sheets.

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Files כדי לפתוח את דפדפן הקבצים.

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

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

4. לוחצים על השם של השאילתה השמורה ואז על הורדה.

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

2. בחלונית השמאלית, לוחצים על Files כדי לפתוח את דפדפן הקבצים.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שמירת שאילתה קלאסית כשאילתה שמורה

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

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

   

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

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

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

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

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

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

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

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

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

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

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

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

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

הרשאות 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 תוסיף לפרויקט ב- Google Cloud את השאילתות השמורות שהועברו מ-BigQuery Studio באמצעות Dataform API. כדי לבטל את השינויים האלה, צריך לבצע ניקוי ידני.

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

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

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

   

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

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

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

   הרשאות ה-IAM שלכם קובעות את סוג השאילתות השמורות הקלאסיות שאתם יכולים להעביר, ואת החלקים שמוצגים לכם בחלונית Classic saved queries migration.

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

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

6. כדי להעביר את כל השאילתות השמורות האישיות מהגרסה הקלאסית, בקטע Migrate personal queries מסמנים את התיבה Migrate all personal queries ולוחצים על Next.

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

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

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

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

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

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

   1. מסמנים את התיבה Migrate all project queries.
   2. בתפריט הנפתח SQL, בוחרים שאילתה שמורה ב-BigQuery Studio עם כללי מדיניות ה-IAM שרוצים להחיל על השאילתות השמורות שהועברו.
   3. אופציונלי: כדי להוסיף משתמש או קבוצה שאיתם רוצים לשתף את השאילתות השמורות שהועברו, לוחצים על Add User/Group.
   4. לוחצים על הבא.

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

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

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

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

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

1. נכנסים לדף BigQuery במסוף Google Cloud .

   כניסה ל-BigQuery

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

   

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

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

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

5. לוחצים על View actions ליד השאילתה ואז על Delete.

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

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

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

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

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

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

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

ב-Knowledge Catalog, שאילתות שמורות נרשמות כרשומות עם ערכי הרשומות הבאים:

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

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

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

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

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

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

סוג

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

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

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

• כדי ללמוד עוד על שאילתות שמורות ב-BigQuery Studio, ראו מבוא לשאילתות שמורות .
• איך יוצרים שאילתות שמורות