המסמך הזה מיועד לבעלי מוצרי נתונים שרוצים לעדכן, למחוק ולהעניק גישה למוצרי נתונים ב-Knowledge Catalog (לשעבר Dataplex Universal Catalog).
מידע נוסף על הארכיטקטורה ומושגי המפתח של מוצרי נתונים זמין במאמר מידע על מוצרי נתונים.
לפני שמתחילים
-
מפעילים את ממשקי ה-API של Dataplex ו-BigQuery, אם הם לא מופעלים.
תפקידים שנדרשים להפעלת ממשקי API
כדי להפעיל ממשקי API, נדרשת ההרשאה
serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לניהול מוצרי נתונים, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-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 -
אישור בקשת גישה למוצר נתונים:
dataplex.dataProducts.approve
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
בקרת גישה למודלים של BigQuery
הגישה למודלים של BigQuery במוצר נתונים מנוהלת באמצעות תנאי IAM שחלים על מדיניות ה-IAM של קבוצת הנתונים הראשית.
אם מוחקים מודל ב-BigQuery ואז יוצרים אותו מחדש עם אותו שם, Knowledge Catalog משחזר את ההרשאות שניתנו בעבר לקבוצות Google או לחשבונות שירות דרך מוצר הנתונים.
הגדרת הרשאות כדי לאפשר גילוי של מוצר נתונים
כדי לאפשר לצרכנים פוטנציאליים לחפש מוצר נתונים, לצפות בו ולבקש גישה אליו, בעלי מוצר הנתונים צריכים לוודא שאפשר לגלות את המוצר. לשם כך, הם צריכים להקצות את תפקידי ה-IAM המתאימים במשאב של מוצר הנתונים:
חיפוש, צפייה ובקשת גישה למוצרי נתונים: צרכן מוצר נתונים של Dataplex (
dataplex.dataProductsConsumer)צפייה בהגדרות ובמטא-נתונים של מוצרי נתונים (גישת קריאה בלבד): Dataplex Data Product Viewer (
dataplex.dataProductsViewer)
ניהול בקשות גישה למוצרי נתונים
כשצרכן של מוצר נתונים מבקש גישה, הבעלים של מוצר הנתונים מקבל התראה באימייל. הבעלים יכולים לבדוק, לאשר או לדחות את הבקשות האלה באמצעות מסוף Google Cloud או ה-API.
המסוף
בדיקת בקשות גישה למוצר נתונים ספציפי
נכנסים לדף Knowledge Catalog Data products במסוף Google Cloud .
לוחצים על מוצר הנתונים שרוצים לבדוק את בקשות הגישה אליו.
לוחצים על הכרטיסייה ניהול בקשות גישה.
בוחרים את השם של השולח שרוצים לבדוק את הבקשה שלו.
לוחצים על פעולות ואז על אישור או על דחייה.
לוחצים על Save.
בדיקת בקשות גישה בכמה מוצרים של נתונים
במסוף Google Cloud , נכנסים לדף Knowledge Catalog (קטלוג הידע) Governance workflows (תהליכי עבודה של ניהול).
לוחצים על הכרטיסייה Pending Approvals (אישורים בהמתנה).
אופציונלי: מסננים את הרשימה לפי שם מוצר הנתונים הספציפי כדי לבודד את הבקשות שלו.
בוחרים את בקשת היעד ולוחצים על אישור או על דחייה.
לוחצים על Save.
התנהגות אחרי אישור
בקשות משתמשים: צרכנים שביקשו גישה לזהות המשתמש שלהם מתווספים אוטומטית כחברים לקבוצת Google שממופה לקבוצת הגישה.
בקשות לחשבון שירות: לצרכנים שביקשו גישה לחשבון שירות ניתנות הרשאות להתחזות לחשבון השירות של יוצר הנתונים שממופה לקבוצת הגישה.
אחרי שהבקשה מטופלת, הסטטוס שלה מתעדכן אוטומטית והרשומה עוברת לכרטיסייה יומן אישורים.
REST
הצגת כל בקשות הגישה בהמתנה
כדי לראות את רשימת כל בקשות הגישה שממתינות לבדיקה שלכם בפרויקט ובמיקום ספציפיים, שולחים בקשת GET באמצעות שיטת האוסף בהתאמה אישית :listReviewable:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests:listReviewable"
מחליפים את מה שכתוב בשדות הבאים:
PROJECT_ID: מזהה הפרויקט ב- Google Cloud
LOCATION: האזור שבו קיים מוצר הנתונים (לדוגמה,
us-central1)
אישור בקשת גישה
בעלי מוצרי נתונים עם הרשאה dataplex.dataProducts.approve יכולים לאשר בקשה בהמתנה על ידי שליחת בקשה POST לשיטה המותאמת אישית :approve:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests/CHANGE_REQUEST_ID:approve"
מחליפים את מה שכתוב בשדות הבאים:
PROJECT_ID: מזהה הפרויקט ב- Google Cloud
LOCATION: האזור שבו קיים מוצר הנתונים (לדוגמה,
us-central1)CHANGE_REQUEST_ID: המזהה הייחודי של בקשת הגישה שרוצים לאשר
בניגוד לאישורים שמתבצעים דרך המסוף, אישור של בקשת שינוי באמצעות REST API לא משנה באופן אוטומטי את החברות בקבוצות Google ולא מגדיר התחזות לטוקן של חשבון שירות. צריך לבצע את השלבים הבאים לניהול גישה במורד הזרם באופן ידני:
לגבי בקשות גישה לזהות משתמש: מוסיפים את הצרכן של מוצר הנתונים לקבוצת Google הממופה. מידע נוסף זמין במאמר בנושא הוספת חברות לקבוצת Google.
לגבי בקשות גישה לחשבון שירות: מריצים את הפקודה הבאה כדי להעניק את תפקיד ה-IAM Service Account Token Creator (
roles/iam.serviceAccountTokenCreator) בחשבון השירות של צרכן מוצר הנתונים במשאב:gcloud iam service-accounts add-iam-policy-binding PRODUCER_SERVICE_ACCOUNT \ --member="serviceAccount:CONSUMER_SERVICE_ACCOUNT" \ --role="roles/iam.serviceAccountTokenCreator"מחליפים את מה שכתוב בשדות הבאים:
PRODUCER_SERVICE_ACCOUNT: כתובת האימייל המוגדרת במלואה של חשבון השירות שממופה לקבוצת הגישה של מוצר הנתונים
CONSUMER_SERVICE_ACCOUNT: כתובת האימייל המוגדרת במלואה של חשבון השירות ששייך ללקוח שמבקש גישה
דחיית בקשת גישה
בעלי מוצרי נתונים עם הרשאת dataplex.dataProducts.approve יכולים לדחות בקשה בהמתנה על ידי שליחת בקשת POST לשיטה המותאמת אישית :reject יחד עם מטען ייעודי (payload) של הצדקה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"comment": "REJECTION_REASON"
}' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests/CHANGE_REQUEST_ID:reject"
מחליפים את מה שכתוב בשדות הבאים:
PROJECT_ID: מזהה הפרויקט ב- Google Cloud
LOCATION: האזור שבו קיים מוצר הנתונים (לדוגמה,
us-central1)CHANGE_REQUEST_ID: המזהה הייחודי של בקשת הגישה שרוצים לדחות
עדכון של מוצר נתונים
אתם יכולים לעדכן את הפרטים הבסיסיים (לדוגמה, שם מוצר הנתונים, תיאור, פרטי הבעלים), נכסים, קבוצות גישה, הרשאות, חוזה, היבטים ומסמכים נוספים של מוצר נתונים קיים.
עדכון הפרטים הבסיסיים של מוצר נתונים
המסוף
נכנסים לדף Knowledge Catalog Data products במסוף Google Cloud .
לוחצים על מוצר הנתונים שרוצים לעדכן.
לוחצים על Edit.
מעדכנים את שם מוצר הנתונים, הסמל של מוצר הנתונים, התיאור, כתובת האימייל של הבעלים של מוצר הנתונים, כתובת האימייל של המאשרים של מוצר הנתונים והתוויות לפי הצורך.
לוחצים על Save.
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי C#ההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Goההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Javaההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Node.jsההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Pythonההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
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: המזהה של מוצר הנתונים
עדכון נכסים של מוצר נתונים
המסוף
במסוף Google Cloud , עוברים לדף Data products ב-Knowledge Catalog.
לוחצים על מוצר הנתונים שרוצים לעדכן את הנכסים שלו.
לוחצים על הכרטיסייה נכסים.
כדי להוסיף נכס חדש, פועלים לפי השלבים הבאים:
לוחצים על +הוספה.
מחפשים את הנכסים שרוצים להוסיף למוצר הנתונים ובוחרים אותם. הנכסים שאתם בוחרים צריכים להיות באותו אזור כמו מוצר הנתונים.
אם יש לכם את ההרשאות הדרושות, אתם יכולים ללחוץ על הנכס כדי לראות את המטא-נתונים שלו.
כדי לשפר את תוצאות החיפוש, משתמשים במסננים.
אחרי שבוחרים את הנכסים, לוחצים על הוספה.
כדי להסיר נכס ממוצר הנתונים, פועלים לפי השלבים הבאים:
בנכס שרוצים להסיר, לוחצים על > הסרה.
לוחצים על הסרה כדי לאשר את הפעולה.
C#
הוספת נכס נתונים חדש למוצר נתונים
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי C#ההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
מחיקה של נכס נתונים ממוצר נתונים
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי C#ההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
המשך
הוספת נכס נתונים חדש למוצר נתונים
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Goההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
מחיקה של נכס נתונים ממוצר נתונים
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Goההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
הוספת נכס נתונים חדש למוצר נתונים
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Javaההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
מחיקה של נכס נתונים ממוצר נתונים
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Javaההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Node.js
הוספת נכס נתונים חדש למוצר נתונים
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Node.jsההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
מחיקה של נכס נתונים ממוצר נתונים
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Node.jsההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
הוספת נכס נתונים חדש למוצר נתונים
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Pythonההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
מחיקה של נכס נתונים ממוצר נתונים
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Pythonההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
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: המזהה של נכס הנתונים שרוצים להסיר ממוצר הנתונים
עדכון קבוצות הגישה וההרשאות לנכסים
המסוף
נכנסים לדף Data products בקטלוג הידע במסוף Google Cloud .
לוחצים על מוצר הנתונים שרוצים לעדכן את קבוצות הגישה וההרשאות שלו.
לוחצים על הכרטיסייה קבוצות גישה והרשאות.
כדי לעדכן קבוצת גישה:
לוחצים על עריכה.
מעדכנים את שם קבוצת הגישה, התיאור, המזהה ותפקיד ברירת המחדל לפי הצורך.
כדי להוסיף קבוצת גישה חדשה, לוחצים על הוספת קבוצת גישה ופועלים לפי השלבים הבאים:
בשדה שם קבוצת הגישה, מזינים שם לקבוצת הגישה החדשה. לדוגמה,
Analyst.בשדה Access group description (תיאור קבוצת הגישה), מזינים תיאור לקבוצת הגישה.
בשדה Access group identifier מזינים את כתובת האימייל של קבוצת Google או של חשבון שירות, או של שניהם, שרוצים להקצות לקבוצת הגישה הזו:
קבוצת Google: משתמשים במוצר נתונים שמבקשים גישה לעצמם מתווספים כחברים לקבוצת Google הממופה.
חשבון שירות: לצרכני מוצרי נתונים שמבקשים גישה לחשבונות השירות שלהם מוקצה תפקיד ה-IAM Service Account Token Creator (
roles/iam.serviceAccountTokenCreator) כדי להתחזות לחשבון השירות של יצרן הנתונים שממופה לקבוצת הגישה.
אופציונלי: בשדה Default role (תפקיד ברירת מחדל), בוחרים תפקיד ברירת מחדל ב-IAM כדי להעניק אותו באופן אוטומטי לכל הנכסים הנתמכים במוצר הנתונים. אם תפקידי IAM כבר הוקצו ישירות לנכסים ספציפיים, הוספה של תפקיד ברירת מחדל לא מבטלת את ההרשאות הישירות האלה.
לוחצים על הוספה.
כדי להסיר קבוצת גישה:
לצד קבוצת הגישה שרוצים להסיר, לוחצים על > הסרה.
לוחצים על הסרה כדי לאשר את הפעולה. הסרה של קבוצת גישה מבטלת את תפקיד ברירת המחדל שלה ואת כל ההרשאות הספציפיות לנכסים מכל הנכסים במוצר הנתונים.
אם לא הוגדרו קבוצות גישה למוצר הנתונים שנבחר, אפשר להוסיף קבוצת גישה חדשה בלחיצה על הוספת קבוצת גישה.
כדי לעדכן את הרשאות הנכסים:
לצד הנכס שרוצים לעדכן את ההרשאות שלו, לוחצים על > הרשאות.
מעדכנים את קבוצות הגישה ואת תפקידי ה-IAM הנדרשים. אתם יכולים להקצות תפקידים ספציפיים לנכסים כדי לבטל את תפקיד ברירת המחדל של קבוצת הגישה.
לוחצים על Configure (הגדרה). בעמודה הרשאות בטבלת הנכסים מוצגות ההרשאות המעודכנות וסטטוס ההגדרה שלהן:
- הוחל: תפקיד ה-IAM (ברירת המחדל או תפקיד ספציפי לנכס) פעיל במשאב הבסיסי.
- נכשל: החלת תפקיד ה-IAM על המשאב הבסיסי נכשלה. אפשר למצוא את הסיבה המפורטת לכשל ב-Cloud Logging.
- לא נתמך: אי אפשר להחיל הרשאות על סוג המשאב של הנכס הזה.
C#
עדכון קבוצות גישה
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי C#ההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
עדכון הרשאות הגישה לנכסים
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי C#ההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
המשך
עדכון קבוצות גישה
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Javaההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
עדכון הרשאות הגישה לנכסים
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Goההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
עדכון קבוצות גישה
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Javaההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
עדכון הרשאות הגישה לנכסים
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Javaההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Node.js
עדכון קבוצות גישה
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Node.jsההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
עדכון הרשאות הגישה לנכסים
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Node.jsההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
עדכון קבוצות גישה
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Pythonההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
עדכון הרשאות הגישה לנכסים
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Pythonההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
REST
כדי לעדכן את קבוצות הגישה שמשויכות למוצר נתונים, משתמשים בשיטה dataProducts.patch. דוגמה לקוד מופיעה במאמר בנושא הגדרת קבוצות גישה.
כדי לעדכן את הרשאות הנכס, משתמשים ב-method dataAssets.patch. דוגמת קוד מופיעה במאמר בנושא הגדרת הרשאות לנכסים.
עדכון החוזה של מוצר הנתונים
המסוף
נכנסים לדף Knowledge Catalog Data products במסוף Google Cloud .
לוחצים על מוצר הנתונים שרוצים לעדכן את החוזה שלו.
לוחצים על הכרטיסייה חוזה.
כדי לעדכן את החוזה הקיים:
לוחצים על עריכה.
מעדכנים את השדות הנדרשים.
לוחצים על Save.
אם לא צורף חוזה למוצר הנתונים שנבחר, אפשר להוסיף חוזה בלחיצה על הוספת חוזה.
REST
כדי לעדכן חוזה, משתמשים בשיטה entries.patch. דוגמה לקוד מופיעה במאמר בנושא הוספת חוזה.
עדכון של היבטים במוצר נתונים
המסוף
נכנסים לדף Knowledge Catalog Data products במסוף Google Cloud .
לוחצים על מוצר הנתונים שרוצים לעדכן את ההיבטים שלו.
לוחצים על הכרטיסייה מאפיינים.
כדי לעדכן היבט:
לוחצים על ההיבט שרוצים לעדכן.
לוחצים על עריכה.
מעדכנים את סוג ההיבט, המדינה והאזור לפי הצורך.
לוחצים על Save.
כדי להוסיף היבט חדש למוצר הנתונים, פועלים לפי השלבים הבאים:
לוחצים על + הוספת היבט.
בשדה Select aspect type (בחירת סוג היבט), מחפשים ובוחרים סוג היבט מהרשימה. לדוגמה,
Geo context.בשדה מדינה בוחרים את המדינה שאליה משויך הנכס.
בשדה Region, בוחרים את האזור העסקי שאליו הנכס שייך.
לוחצים על Save.
כדי למחוק היבט:
לוחצים על ההיבט שרוצים למחוק.
לוחצים על מחיקה.
לוחצים על אישור כדי לאשר את הפעולה.
REST
כדי לעדכן היבט כלשהו בנתוני המוצר, משתמשים בשיטה entries.patch.
עדכון התיעוד של מוצר הנתונים
המסוף
נכנסים לדף Knowledge Catalog Data products במסוף Google Cloud .
לוחצים על מוצר הנתונים שרוצים לעדכן את התיעוד שלו.
לוחצים על הכרטיסייה סקירה כללית.
לוחצים על עריכה לצד תיעוד.
לעדכן את מדריך למשתמש, שאילתות לדוגמה ומסמכים אחרים לפי הצורך.
לוחצים על Save.
REST
התיעוד הוא חלק מההיבט overview. כדי לעדכן את התיעוד של נתוני המוצרים, משתמשים בשיטה entries.patch.
מחיקת מוצר נתונים
כדי למחוק מוצר נתונים, קודם צריך להסיר ממנו את כל הנכסים.
המסוף
נכנסים לדף Knowledge Catalog Data products במסוף Google Cloud .
לוחצים על מוצר הנתונים שרוצים למחוק.
לוחצים על הכרטיסייה נכסים.
לכל נכס שמופיע ברשימה, לוחצים על > הסרה. לוחצים על הסרה כדי לאשר את הפעולה.
אחרי שמסירים את כל הנכסים, מוחקים את מוצר הנתונים בלחיצה על מחיקה.
בתיבת הדו-שיח לאישור, מזינים
deleteולוחצים על מחיקה.
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי C#ההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Goההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Javaההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Node.jsההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Pythonההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
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: המזהה של מוצר הנתונים שרוצים למחוק
שמירת נתונים ומחיקת פרויקטים
כשמוחקים פרויקט ב- Google Cloud שמכיל מוצרי נתונים, המשאבים המשויכים עוברים את מחזור החיים הרגיל של Google Cloud מחיקה, שנקרא גם מחיקה מוחלטת. סקירה מפורטת של התהליכים הטכניים ולוחות הזמנים שקובעים את ההתנהגות הזו מופיעה במאמר מחיקת נתונים ב- Google Cloud.
מחזור החיים של משאבים במהלך מחיקת פרויקט
מחזור החיים של מוצרי הנתונים ונכסי הנתונים שלכם מתנהל בשני שלבים עיקריים אחרי בקשה למחיקת פרויקט:
מחיקה עם אפשרות שחזור (מצב
Hidden): מיד לאחר הפעלת מחיקת הפרויקט, כל מוצרי הנתונים ונכסי הנתונים בפרויקט מסומנים כ-Hidden. במהלך תקופת החסד של 30 הימים, המטא-נתונים נשמרים אבל אי אפשר יותר לגשת אליהם דרך ממשקי ה-API של Dataplex או דרך Google Cloud המסוף. במהלך התקופה הזו, אפשר לשחזר את הפרויקט ואת המשאבים שלו בכל שלב.מחיקה סופית (מצב
Purged): אחרי שתקופת החסד בת 30 הימים מסתיימת, הפרויקט וכל המטא-נתונים שלו ב-Knowledge Catalog נמחקים באופן סופי. בקטלוג הידע נעשה שימוש במדיניות פנימית למחיקת שורות כדי למחוק את הרשומות האלה מהאחסון בצורה שניתן לאמת.
התנהגות של מדיניות IAM במשאבים חוצי-פרויקטים
יש הבדל קריטי בין המטא-נתונים של Knowledge Catalog לבין מדיניות IAM שנאכפת על הנתונים הפיזיים הבסיסיים (למשל מערכי נתונים של BigQuery או מאגרי Cloud Storage).
המטא-נתונים של Knowledge Catalog בתוך הפרויקט נמחקים אוטומטית, אבל כל קשרי ה-IAM שחלים על משאבי נתונים שנמצאים בפרויקט אחר (פרויקט ב') לא מבוטלים אוטומטית כשפרויקט הבעלים של מוצר הנתונים (פרויקט א') נמחק.
קישורי הרשאות יתומים: מכיוון שהמשאבים הפיזיים בפרויקט היעד נשארים פעילים, מערכת IAM לא מסירה אוטומטית את מזהי הגורמים הראשיים שמשויכים לפרויקט שנמחק.
מניעת הרשאות זומבי: כדי להבטיח השבתה מלאה של גישה לנתונים, צריך למחוק באופן ידני נכסי נתונים ממוצרי הנתונים, או להסיר באופן מפורש את ההרשאות המשויכות של IAM מהמשאבים הבין-פרויקטיים, לפני שמתחילים במחיקת פרויקט.
שחזור פרויקט (ביטול מחיקה)
אם תשחזרו פרויקט שנמחק במהלך תקופת החסד של 30 יום, Knowledge Catalog ינסה לשחזר את המשאבים שלכם ואת ההגדרה של מי יכול לראות אותם בקטלוג. בנכסים חוצי-פרויקטים, הגישה לנתונים בדרך כלל מתחדשת באופן מיידי בפרויקט המשוחזר, כי ההתאמות הבסיסיות של IAM לא בוטלו אוטומטית במהלך תהליך המחיקה.