ניהול מוצרים מבוססי-נתונים

גרסת טרום-השקה

השימוש במוצר הזה או בתכונה הזו כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, שמפורטים בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

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

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

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

1. Enable the Dataplex, BigQuery APIs.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

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

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

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

• הרשאות מלאות ליצירה, לעדכון, למחיקה ולניהול של הרשאות למוצרי נתונים: אדמין מוצרי נתונים ב-Dataplex (roles/dataplex.dataProductsAdmin)
• עדכון וניהול של מוצרי נתונים קיימים: עריכת מוצרי נתונים ב-Dataplex (roles/dataplex.dataProductsEditor)
• מוסיפים היבטים כמו schema,‏ overview ו-contacts: Dataplex Entry and EntryLink Owner (roles/dataplex.entryOwner)
• חיפוש נכסים והוספה שלהם: צפייה בקטלוג Dataplex (roles/dataplex.catalogViewer)
• עריכת סוגי היבטים של המערכת, כמו תיעוד והיבט חוזה של קצב הרענון: Dataplex Catalog Editor (roles/dataplex.catalogEditor)

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

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

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

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

• עורכים את סוג היחס של המערכת overview: dataplex.entryGroups.useOverviewAspect
• עורכים את סוג היחס של המערכת refresh cadence: dataplex.entryGroups.useRefreshCadenceAspect

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

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

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

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

• חיפוש מוצרי נתונים וגישה אליהם בחיפוש של Dataplex Universal Catalog:‏ Dataplex Data Product Consumer (dataplex.dataProductsConsumer)
• גישת קריאה בלבד לצפייה בהגדרות של מוצרי נתונים ובמטא-נתונים: Dataplex Data Product Viewer (dataplex.dataProductsViewer)
• בקשת גישה למוצרי נתונים: Dataplex Data Product Consumer (dataplex.dataProductsConsumer)

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

כדי לתת גישה, בצעו את השלבים הבאים:

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

   כניסה לדף Groups

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

3. לוחצים על  הוספת חברים.

4. מוסיפים את הגורם הראשי.

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

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

עדכון של מוצר נתונים

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

עדכון הפרטים הבסיסיים של מוצר נתונים

המסוף

1. במסוף Google Cloud , עוברים לדף Data products בקטלוג האוניברסלי של Dataplex.

   מעבר אל 'מוצרי נתונים'

2. לוחצים על מוצר הנתונים שרוצים לעדכן.

3. לוחצים על עריכת מוצר הנתונים.

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

5. לוחצים על עדכון מוצר נתונים.

REST

כדי לעדכן את הפרטים הבסיסיים של מוצר נתונים, משתמשים בשיטה dataProducts.patch.

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"description": "NEW_DESCRIPTION"}' \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID?update_mask="description"

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

• ‫NEW_DESCRIPTION: תיאור חדש של מוצר הנתונים
• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
• ‫LOCATION: האזור שבו קיים מוצר הנתונים
• ‫DATA_PRODUCT_ID: המזהה של מוצר הנתונים

עדכון נכסים של מוצר נתונים

המסוף

1. במסוף Google Cloud , עוברים לדף Data products בקטלוג האוניברסלי של Dataplex.

   מעבר אל 'מוצרי נתונים'

2. לוחצים על מוצר הנתונים שרוצים לעדכן את הנכסים שלו.

3. לוחצים על הכרטיסייה נכסים.

4. כדי להוסיף נכס חדש, פועלים לפי השלבים הבאים:

   1. לוחצים על +הוספה.

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

      אם יש לכם את ההרשאות הדרושות, אתם יכולים ללחוץ על הנכס כדי לראות את המטא-נתונים שלו.

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

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

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

   1. בנכס שרוצים להסיר, לוחצים על > הסרה.

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

REST

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

כדי למחוק נכס נתונים ממוצר הנתונים, משתמשים בשיטה dataAssets.delete. לדוגמה, שולחים את הבקשה הבאה DELETE:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID/dataAssets/DATA_ASSET_ID"

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

• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
• ‫LOCATION: האזור שבו רוצים ליצור את מוצר הנתונים
• ‫DATA_PRODUCT_ID: מזהה ייחודי של מוצר הנתונים
• ‫DATA_ASSET_ID: המזהה של נכס הנתונים שרוצים להסיר ממוצר הנתונים

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

המסוף

1. במסוף Google Cloud , עוברים לדף Data products בקטלוג האוניברסלי של Dataplex.

   מעבר אל 'מוצרי נתונים'

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

3. לוחצים על הכרטיסייה קבוצות גישה והרשאות.

4. כדי לעדכן קבוצת גישה:

   1. לוחצים על עריכה.

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

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

      1. בשדה שם קבוצת הגישה, מזינים שם לקבוצת הגישה החדשה. לדוגמה, Analyst.

      2. בשדה Access group description (תיאור קבוצת הגישה), מזינים תיאור לקבוצת הגישה.

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

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

   4. לוחצים על הוספה.

5. כדי להסיר קבוצת גישה:

   1. לצד קבוצת הגישה שרוצים להסיר, לוחצים על > הסרה.

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

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

7. כדי לעדכן את הרשאות הנכסים, פועלים לפי השלבים הבאים:

   1. לצד הנכס שרוצים לעדכן את ההרשאות שלו, לוחצים על > הרשאות.

   2. מעדכנים את קבוצות הגישה ואת תפקידי ה-IAM הנדרשים.

   3. לוחצים על Configure (הגדרה).

REST

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

כדי לעדכן את הרשאות הנכס, משתמשים ב-method ‏dataAssets.patch. דוגמת קוד מופיעה במאמר בנושא הגדרת הרשאות לנכסים.

עדכון החוזה של מוצר הנתונים

הערה: אחרי שמוסיפים את קצב הרענון לחוזה, אי אפשר לערוך אותו. אם מנסים לשנות את הערך הזה, מוצגת השגיאה הבאה: You don't have permission to change contract values.

המסוף

1. במסוף Google Cloud , עוברים לדף Data products בקטלוג האוניברסלי של Dataplex.

   מעבר אל 'מוצרי נתונים'

2. לוחצים על מוצר הנתונים שרוצים לעדכן את החוזה שלו.

3. לוחצים על הכרטיסייה חוזה.

4. כדי לעדכן את החוזה הקיים:

   1. לוחצים על עריכה.

   2. מעדכנים את השדות הנדרשים.

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

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

REST

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

עדכון היבטים של מוצר נתונים

המסוף

1. במסוף Google Cloud , עוברים לדף Data products בקטלוג האוניברסלי של Dataplex.

   מעבר אל 'מוצרי נתונים'

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

3. לוחצים על הכרטיסייה מאפיינים.

4. כדי לעדכן היבט:

   1. לוחצים על ההיבט שרוצים לעדכן.

   2. לוחצים על עריכה.

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

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

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

   1. לוחצים על + הוספת היבט.

   2. בשדה בחירת סוג היבט, מחפשים סוג היבט ובוחרים אותו מהרשימה. לדוגמה, Geo context.

   3. בשדה מדינה בוחרים את המדינה שאליה משויך הנכס.

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

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

6. כדי למחוק היבט, פועלים לפי השלבים הבאים:

   1. לוחצים על ההיבט שרוצים למחוק.

   2. לחץ על .

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

REST

כדי לעדכן היבט כלשהו ברשומה של נתוני המוצר, משתמשים בשיטה entries.patch.

עדכון התיעוד של מוצר הנתונים

המסוף

1. במסוף Google Cloud , עוברים לדף Data products בקטלוג האוניברסלי של Dataplex.

   מעבר אל 'מוצרי נתונים'

2. לוחצים על מוצר הנתונים שרוצים לעדכן את התיעוד שלו.

3. לוחצים על הכרטיסייה סקירה כללית.

4. לוחצים על עריכה לצד תיעוד.

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

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

REST

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

מחיקת מוצר נתונים

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

המסוף

1. במסוף Google Cloud , עוברים לדף Data products בקטלוג האוניברסלי של Dataplex.

   מעבר אל 'מוצרי נתונים'

2. לוחצים על מוצר הנתונים שרוצים למחוק.

3. לוחצים על הכרטיסייה נכסים.

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

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

6. בתיבת הדו-שיח לאישור, מזינים delete ולוחצים על מחיקה.

REST

כדי למחוק מוצר נתונים, משתמשים ב-method‏ dataProducts.delete.

לדוגמה, שולחים את הבקשה הבאה DELETE:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID

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

• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
• ‫LOCATION: האזור שבו קיים מוצר הנתונים
• ‫DATA_PRODUCT_ID: המזהה של מוצר הנתונים שרוצים למחוק

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

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