ניהול מחברות

במאמר הזה מוסבר איך לנהל מחברות Colab Enterprise ב-BigQuery, כולל איך להציג, להשוות, לשחזר ולמחוק מחברות.

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

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

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

1. יצירת Notebook
2. כדי לנהל מטא-נתונים של מחברות ב-Dataplex Universal Catalog, צריך לוודא ש-Dataplex API מופעל בפרויקט שלכם ב- Google Cloud .

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

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

• BigQuery Job User (roles/bigquery.jobUser)
• BigQuery Read Session User (roles/bigquery.readSessionUser)
• הבעלים של הקוד (roles/dataform.codeOwner) ברמת המשאב.

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

• BigQuery Job User (roles/bigquery.jobUser)
• BigQuery Read Session User (roles/bigquery.readSessionUser)
• Code Owner (roles/dataform.codeOwner) או Code Editor (roles/dataform.codeEditor)

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

• BigQuery Job User (roles/bigquery.jobUser)
• BigQuery Read Session User (roles/bigquery.readSessionUser)

• אחד מהתפקידים הבאים:

  • בעלים של קוד (roles/dataform.codeOwner)
  • עורך קוד (roles/dataform.codeEditor)
  • Code Viewer (roles/dataform.codeViewer)

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

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

הענקת גישה למסמכי Notebook

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

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

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

   כניסה ל-BigQuery

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

   

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

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

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

5. לצד ה-Notebook, לוחצים על פתיחת פעולות ואז על שיתוף.

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

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

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

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

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

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

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

איך משתפים מחברות

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

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

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

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

   כניסה ל-BigQuery

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

   

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

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

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

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

6. משתפים את הקישור עם משתמשים אחרים.

הצגת כל המחברות

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

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

   כניסה ל-BigQuery

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

   

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

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

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

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

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

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

   כניסה ל-BigQuery

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

   

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

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

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

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

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

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

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

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

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

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

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

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

   כניסה ל-BigQuery

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

   

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

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

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

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

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

   כניסה ל-BigQuery

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

   

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

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

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

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

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

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

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

שחזור גרסה של פנקס

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

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

   כניסה ל-BigQuery

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

   

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

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

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

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

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

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

הורדת Notebook

כדי להוריד מחברת:

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

   כניסה ל-BigQuery

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

   

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

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

5. מרחיבים את סרגל התפריטים ועוברים לתפריט קובץ:

   

6. בוחרים באפשרות הורדה, ואז בוחרים את סוג הקובץ שבו רוצים להוריד את הקובץ.

מחיקת מחברות

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

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

   כניסה ל-BigQuery

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

   

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

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

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

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

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

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

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

אתם יכולים להשתמש ב-Dataplex Universal Catalog כדי לנהל מחברות בכל המיקומים של BigQuery. הניהול של מחברות ב-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 aspect לערך NOTEBOOK. לאחר מכן, בוחרים רשומה מתוך המחברת שנבחרה. הוראות להצגת הפרטים של סוג רשומה נבחר מופיעות במאמר הצגת הפרטים של סוג רשומה בתיעוד של Dataplex Universal Catalog. הוראות להצגת הפרטים של רשומה נבחרת מופיעות במאמר הצגת הפרטים של רשומה בתיעוד של Dataplex Universal Catalog.

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

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

סוג

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

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

פתרון בעיות

מידע נוסף זמין במאמר בנושא פתרון בעיות ב-Colab Enterprise.

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

• מידע נוסף על מחברות Colab Enterprise ב-BigQuery
• איך יוצרים מחברות
• איך מתזמנים מחברות