החל מ-10 באפריל 2026, Dataplex Universal Catalog נקרא עכשיו Knowledge Catalog. השמות של ה-API, ספריית הלקוח, ה-CLI ו-IAM לא משתנים. מידע נוסף זמין במאמר הכרות עם קטלוג הידע של Google Cloud.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

הרשאות לניהול זהויות והרשאות גישה (IAM) ב-Knowledge Catalog

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

במאמר הזה מפורטות הרשאות ה-IAM שנדרשות כדי להריץ פעולות ספציפיות ו-methods של API ב-Knowledge Catalog. מידע נוסף על תפקידים מוגדרים מראש מופיע במאמר תפקידי IAM ב-Knowledge Catalog. למידע נוסף על IAM, קראו את הסקירה הכללית על IAM.

הרשאות Set ו-Get של מדיניות IAM

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

משאב	שיטת ה-API	הרשאת IAM
סוגי היבטים	`GetIamPolicy`	dataplex.aspectTypes.getIamPolicy
סוגי היבטים	`SetIamPolicy`	dataplex.aspectTypes.setIamPolicy
קבוצות כניסה	`GetIamPolicy`	dataplex.entryGroups.getIamPolicy
קבוצות כניסה	`SetIamPolicy`	dataplex.entryGroups.setIamPolicy
סוגי רשומות	`GetIamPolicy`	dataplex.entryTypes.getIamPolicy
סוגי רשומות	`SetIamPolicy`	dataplex.entryTypes.setIamPolicy
אגמים	`GetIamPolicy`	dataplex.lakes.getIamPolicy
אגמים	`SetIamPolicy`	dataplex.lakes.setIamPolicy

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

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

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

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

סוגי רשומות

כדי ליצור ולנהל סוגי רשומות, צריך לקבל לפחות את ההרשאות הרגילות create,‏ get,‏ list,‏ update ו-delete.

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

כדי להשתמש בסוג רשומה (לדוגמה, כדי ליצור רשומות מסוג רשומה מסוים), צריך לקבל את ההרשאה use בסוג הרשומה.

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

פעולה	הרשאת IAM
`Create entry types`	`dataplex.entryTypes.create` ‫`dataplex.aspectTypes.use` (לכל סוג היבט נדרש בסוג הרשומה) `dataplex.entryGroups.useASPECT_TYPE` (לכל סוג היבט מערכת שנדרש בסוג הרשומה). ההרשאות לסוגי היבטים של המערכת
`Delete entry types`	`dataplex.entryTypes.delete` ‫`dataplex.aspectTypes.use` (לסוגי ההיבטים הנדרשים בסוגי הרשומות) `dataplex.entryGroups.useASPECT_TYPE` (לכל סוג היבט מערכת שנדרש בסוג הרשומה). ההרשאות לסוגי היבטים של המערכת
`Get entry types`	`dataplex.entryTypes.get`
`List entry types`	`dataplex.entryTypes.list`
`Update entry types`	`dataplex.entryTypes.update` ‫`dataplex.aspectTypes.use` (לכל סוג היבט נדרש בסוג הרשומה) ‫`dataplex.entryGroups.useASPECT_TYPE` (לכל סוג היבט מערכת שנדרש בסוג הרשומה). ההרשאות לסוגי היבטים של המערכת
שימוש בסוגי רשומות (כשיוצרים רשומות, מעדכנים שדות של רשומות ברמה העליונה וערכים נדרשים של סוגי היבטים)	`dataplex.entryTypes.use` `dataplex.entries.create` או `dataplex.entries.update` ‫`dataplex.aspectTypes.use` (לכל היבט שנוצר או עודכן)

סוגי היבטים

כדי ליצור ולנהל סוגי היבטים, צריך לקבל את ההרשאות הרגילות create,‏ get,‏ list,‏ update ו-delete.

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

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

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

פעולה	ההרשאות שנדרשות לסוגי היבטים בהתאמה אישית	ההרשאות שנדרשות כדי להשתמש בסוגי ההיבטים של המערכת	ההרשאות שנדרשות לסוגי היבטים של המערכת לקריאה בלבד
`Create aspect types`	`dataplex.aspectTypes.create`	לא רלוונטי	לא רלוונטי
`Delete aspect types`	`dataplex.aspectTypes.delete`	לא רלוונטי	לא רלוונטי
`Get aspect types`	`dataplex.aspectTypes.get`	הוענקה ל-`allUsers`	הוענקה ל-`allUsers`
`List aspect types`	`dataplex.aspectTypes.list`	לא רלוונטי	לא רלוונטי
כשיוצרים או מעדכנים רשומות, מגדירים ערכים אופציונליים של סוגי היבטים	`dataplex.aspectTypes.use` `dataplex.entries.create` או `dataplex.entries.update`	`dataplex.entryGroups.useASPECT_TYPE`. מידע נוסף זמין במאמר הרשאות לסוגי היבטים של המערכת. `dataplex.entries.create` או `dataplex.entries.update`	לא רלוונטי
כשיוצרים או מעדכנים רשומות, צריך להגדיר את ערכי סוגי ההיבטים הנדרשים	`dataplex.aspectTypes.use` `dataplex.entryTypes.use` `dataplex.entries.create` או `dataplex.entries.update`	`dataplex.entryGroups.useASPECT_TYPE`. מידע נוסף זמין במאמר הרשאות לסוגי היבטים של המערכת. `dataplex.entryTypes.use` `dataplex.entries.create` או `dataplex.entries.update`	לא רלוונטי
`Update aspect types`	`dataplex.aspectTypes.update`	לא רלוונטי	לא רלוונטי
הגדרת ערכים נדרשים של סוגי היבטים כשיוצרים או מעדכנים קישור לרשומה	לא רלוונטי	`dataplex.entryGroups.useASPECT_TYPE`. מידע נוסף זמין במאמר הרשאות לסוגי היבטים של המערכת. `dataplex.entryLinkTypes.useENTRY_LINK_TYPE`. מידע נוסף על הרשאות וסוגי קישורים ‫`dataplex.entries.link` הוענקה לקבוצות של רשומות שמכילות רשומות מקושרות. הבדיקה מתבצעת רק במהלך יצירת הקישור לדף הכניסה. `dataplex.entryLinks.create` או `dataplex.entryLinks.update`	לא רלוונטי

קבוצות כניסה

כדי ליצור ולנהל קבוצות של רשומות, צריך לקבל את ההרשאות הרגילות create,‏ get,‏ list,‏ update ו-delete.

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

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

פעולה	ההרשאות שנדרשות לקבוצות של רשומות בהתאמה אישית	הרשאות שנדרשות לקבוצות של רשומות מערכת (שמתחילות ב-@)
`Create entry groups`	`dataplex.entryGroups.create`	לא רלוונטי
`Delete entry groups`	`dataplex.entryGroups.delete`	לא רלוונטי
`Get entry groups`	`dataplex.entryGroups.get`	`dataplex.entryGroups.get`
`List entry groups`	`dataplex.entryGroups.list`	`dataplex.entryGroups.list`
`Update entry groups`	`dataplex.entryGroups.update`	לא רלוונטי

רשומות

כדי ליצור ולנהל רשומות, צריך לקבל את ההרשאות הרגילות create,‏ get,‏ list,‏ update ו-delete.

שימו לב לנקודות הבאות:

בשיטות חיפוש (<code>LookupEntry</code>) וחיפוש (<code>SearchEntries</code>), נדרשת הרשאה מהמערכת של מקור הנתונים המקורי ברשומה. לדוגמה, אם המקור הוא טבלה ב-BigQuery, צריך את ההרשאה bigquery.tables.get כדי לראות מטא-נתונים, ואת ההרשאה bigquery.tables.getData כדי לראות היבטים של נתונים.
אם אין הרשאה לצפות בהיבטי הנתונים, הרשומות עדיין גלויות אבל התוכן של היבטי הנתונים מוסתר.
כשיוצרים רשומה או מעדכנים את השדות ברמה העליונה של רשומה, צריך לקבל את ההרשאה use בסוג הרשומה.
כשיוצרים או מעדכנים היבט נדרש, צריך לקבל את ההרשאה use לסוג הרשומה של הרשומה, וגם לסוג ההיבט הבסיסי. הסיבה לכך היא שההיבטים הנדרשים נאכפים על ידי סוג הרשומה.
כשיוצרים, מעדכנים או מוחקים היבט אופציונלי, צריך לקבל את ההרשאה use בסוג ההיבט של ההיבט.
כדי לעדכן או להוסיף רשומה (<code>UpdateEntry</code> עם <code>allow_missing = True</code>), צריך לקבל את ההרשאה create.

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

בטבלה הבאה מפורטות ההרשאות שנדרשות כדי לבצע פעולות ברשומות:

פעולה	רשומה שמבוססת על סוג רשומה בהתאמה אישית	רשומה שמבוססת על סוג רשומה שניתן להשתמש בו במערכת	רשומה שמבוססת על סוג רשומה של מערכת לקריאה בלבד
`Create entries`	`dataplex.entries.create` `dataplex.entryTypes.use` `dataplex.aspectTypes.use` (לכל היבט מותאם אישית שנוצר) ‫`dataplex.entryGroups.useASPECT_TYPE` (לכל היבט של סוג היבט מערכת שמיש שנוצר). ההרשאות לסוגי היבטים של המערכת	`dataplex.entries.create` `dataplex.entryGroups.useENTRY_TYPE`. מידע נוסף זמין במאמר הרשאות לסוגי רשומות של המערכת. ‫`dataplex.entryGroups.useASPECT_TYPE` (לכל היבט מערכת שנוצר). ההרשאות לסוגי היבטים של המערכת `dataplex.aspectTypes.use` (לכל היבט מותאם אישית שנוצר)	לא רלוונטי
`Get entries`	`dataplex.entries.get` כדי לראות את היבטי הנתונים, צריך גם את ההרשאה `dataplex.entries.getData`.	`dataplex.entries.get` כדי לראות את היבטי הנתונים, צריך גם את ההרשאה `dataplex.entries.getData`.	`dataplex.entries.get` כדי לראות את היבטי הנתונים, צריך גם את ההרשאה `dataplex.entries.getData`.
`List entries`	`dataplex.entries.list`	`dataplex.entries.list`	`dataplex.entries.list`
`Lookup entries`	נדרשת הרשאת קריאה של מטא-נתונים במערכת המקור. כדי לראות את היבטי הנתונים, נדרשת הרשאה לקרוא נתונים ממערכת המקור. ברשומות בהתאמה אישית, שבהן Knowledge Catalog נחשב למערכת המקור, ההרשאות האלה הן `dataplex.entries.get` ו-`dataplex.entries.getData`, בהתאמה.	נדרשת הרשאת קריאה של מטא-נתונים במערכת המקור. כדי לראות את היבטי הנתונים, נדרשת הרשאה לקרוא נתונים ממערכת המקור. ברשומות בהתאמה אישית, שבהן Knowledge Catalog נחשב למערכת המקור, ההרשאות האלה הן `dataplex.entries.get` ו-`dataplex.entries.getData`, בהתאמה.	נדרשת הרשאת קריאה של מטא-נתונים במערכת המקור. כדי לראות את היבטי הנתונים, נדרשת הרשאה לקרוא נתונים ממערכת המקור. ברשומות בהתאמה אישית, שבהן Knowledge Catalog נחשב למערכת המקור, ההרשאות האלה הן `dataplex.entries.get` ו-`dataplex.entries.getData`, בהתאמה.
`Search entries`	הרשאת קריאה של מערכת המקור המקורית. ברשומות בהתאמה אישית, הערך הוא `dataplex.entries.get`, כי המערכת מתייחסת ל-Knowledge Catalog כמערכת המקור המקורית.	הרשאת קריאה של מערכת המקור המקורית. ברשומות בהתאמה אישית, הערך הוא `dataplex.entries.get`, כי המערכת מתייחסת ל-Knowledge Catalog כמערכת המקור המקורית.	הרשאת קריאה של מערכת המקור המקורית. ברשומות בהתאמה אישית, הערך הוא `dataplex.entries.get`, כי המערכת מתייחסת ל-Knowledge Catalog כמערכת המקור המקורית.
`Update entries`	`dataplex.entries.update` `dataplex.entryTypes.use` (לעדכון שדות ברמה העליונה או היבטים נדרשים) ‫`dataplex.aspectTypes.use` (לכל היבט שמעדכנים) ‫`dataplex.entryGroups.useASPECT_TYPE` (לכל היבט של המערכת שעודכן). ההרשאות לסוגי היבטים של המערכת ‫`dataplex.entries.create` (אם `allow_missing` הוא `True`)	`dataplex.entries.update` `dataplex.entryGroups.useENTRY_TYPE` (לעדכון שדות ברמה העליונה או היבטים נדרשים). ההרשאות לסוגי רשומות של המערכת ‫`dataplex.aspectTypes.use` (על כל היבט מותאם אישית שמעדכנים) ‫`dataplex.entryGroups.useASPECT_TYPE` (לכל היבט ששייך לסוגי היבטים של המערכת). ההרשאות לסוגי היבטים של המערכת ‫`dataplex.entries.create` (אם `allow_missing` הוא `True`)	`dataplex.entries.update` ‫`dataplex.aspectTypes.use` (על כל היבט מותאם אישית שמעדכנים) `dataplex.entryGroups.useASPECT_TYPE` (לכל היבט של סוג היבט של מערכת שמישה שעודכן). ההרשאות לסוגי היבטים של המערכת אי אפשר לערוך שדות ברמה העליונה והיבטים נדרשים.

קישורים לערכים

כדי ליצור ולנהל קישורי כניסה, צריך לקבל את ההרשאות create,‏ get,‏ list ו-delete ב-dataplex.entryLinks.

שימו לב לנקודות הבאות:

כדי ליצור קישורים לרשומות (CreateEntryLink), צריך גם הרשאות לסוג הקישור לרשומה והרשאות לרשומות הספציפיות של הקישור.
כשיוצרים קישור לרשומה עם מאפיין נדרש, צריך הרשאות כדי להשתמש בסוג המאפיין.
כשמעדכנים או מוסיפים (upsert) קישור לרשומה (UpdateEntryLink עם allow_missing = True), צריך גם את אותן ההרשאות שנדרשות בשביל CreateEntryLink.

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

פעולה	הרשאת IAM
יצירת קישורים לדפים ביומן האישי	`dataplex.entryLinks.create` (בקבוצת הרשומות) ההרשאות שנדרשות בהתאם לסוג הקישור לרשומה: מילה נרדפת: `dataplex.glossaryTerms.use` (בשני המונחים) הגדרה: `dataplex.glossaryTerms.use` (ברשומת המונח) ו-`dataplex.entries.link` (ברשומת היעד) אחר: `dataplex.entries.link` (בשני השדות) הרשאה להשתמש בסוג הקישור לכניסה: לסוגי מערכות: `dataplex.entryGroups.useENTRY_LINK_TYPE` (בקבוצת הרשומות). הרשאות לסוגי קישורים של רשומות מערכת הרשאות לכל ההיבטים הנדרשים שצוינו בסוג הקישור לרשומה: לסוגי מערכות: `dataplex.entryGroups.useASPECT_TYPE` (בקבוצת הרשומות). ההרשאות לסוגי היבטים של המערכת
מחיקת קישורים לרשומות	`dataplex.entryLinks.delete` (בקבוצת הרשומות)
קבלת קישורים לרשומות	`dataplex.entryLinks.get` (בקבוצת הרשומות)
קישורים לערכים במילון	נדרשת הרשאת קריאה של מטא-נתונים של מערכת המקור ברשומה שעבורה מחפשים קישורים לרשומות. ברשומות מותאמות אישית מקושרות, שבהן Knowledge Catalog נחשב למערכת המקור, ההרשאה היא `dataplex.entries.get`. ברשומות של מערכות מקושרות, ההרשאה היא הרשאת קריאה של מערכת המקור של הרשומה המקושרת.
עדכון הקישור לרשומה	`dataplex.entryLinks.update` (בקבוצת הרשומות) הרשאה להשתמש בסוג הקישור לכניסה: לסוגי מערכות: `dataplex.entryGroups.useENTRY_LINK_TYPE` (בקבוצת הרשומות). הרשאות לסוגי קישורים של רשומות מערכת הרשאות לכל ההיבטים הנדרשים שצוינו בסוג הקישור לרשומה: לסוגי מערכות: `dataplex.entryGroups.useASPECT_TYPE` (בקבוצת הרשומות). ההרשאות לסוגי היבטים של המערכת אם `allow_missing` הוא `True`, בנוסף, כל ההרשאות מ-`Create entry link` חלות.

מגבלות על היבטים בקישורים לרשומות

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

קבוצות הקשרים

קבוצות הקשר הן מאגרים מוגבלים של נכסי נתונים ומטא-נתונים של יעדים, שמשמשים כדי לבסס מודלים של AI בלוגיקה העסקית הקניינית שלכם. הם יכולים להכיל מידע ספציפי למסד הנתונים, כמו תבניות של שאילתות SQL או שאילתות לחיפוש ערכים בכלים להמרת טקסט ל-SQL כמו QueryData, אבל ב-Knowledge Studio משתמשים בקבוצות הקשר גם כדי לאחסן מילוני מונחים, סקירות כלליות של טבלאות מובְנות ומיפויים של נתונים ארגוניים.

מידע נוסף על השימוש בקבוצות הקשר ב- Google Cloudזמין בסקירה הכללית על קבוצות הקשר ב-Knowledge Studio, ב-AlloyDB ל-PostgreSQL, ב-Bigtable, ב-Cloud SQL ל-MySQL, ב-Cloud SQL ל-PostgreSQL, ב-Firestore עם תאימות ל-MongoDB וב-Spanner.

כדי להציג, ליצור ולנהל קבוצות של הקשרים של מסדי נתונים ב-QueryData (dataplex.contextSetGroups.*,‏ dataplex.contextSets.* ו-dataplex.context.*), צריך להקצות את התפקידים הבאים ב-IAM:

Dataplex Catalog Viewer ‏(roles/dataplex.catalogViewer): גישה לקריאה בלבד כדי להציג ולפרט קבוצות של הקשרים, קבוצות של קבוצות הקשרים, הקשרים ומיקומים של מסדי נתונים, ולהוריד קבוצות של הקשרים והקשרים.
עריכת קטלוג Dataplex ‏(roles/dataplex.catalogEditor): גישה ליצירה, לצפייה, להצגה, לעדכון ולמחיקה של קבוצות הקשרים וקבוצות של קבוצות הקשרים של מסדי נתונים, להעלאה ולהורדה של קבוצות הקשרים, לצפייה, להצגה, לעדכון, למחיקה ולהורדה של הקשרים, ולצפייה ולהצגה של מיקומים.
אדמין של Dataplex Catalog ‏(roles/dataplex.catalogAdmin): גישה ניהולית מלאה לקבוצות של קבוצות הקשר, לקבוצות הקשר ולהקשר של מסד הנתונים, וגישה לצפייה במיקומים ולרשימת המיקומים.

כדי ליצור ולנהל קבוצות הקשר של קבוצות רשומות ב-Knowledge Studio (dataplex.entryGroups.*ContextSet,‏ dataplex.entryGroups.requestContextChanges ו-dataplex.entries.*Context), צריך להקצות את תפקידי ה-IAM הבאים:

יוצר תוכן ב-Dataplex ‏(roles/dataplex.contentCreator): גישה ליצירה ולרשימה של קבוצות הקשר בפרויקט (dataplex.entryGroups.createContextSet,‏ dataplex.entryGroups.list). כדי ליצור קבוצת הקשר לא צריך את ההרשאה dataplex.entryGroups.setIamPolicy.
Dataplex Content Viewer‏ (roles/dataplex.contentViewer): גישה לקריאה בלבד כדי לראות קונטיינרים של קבוצות הקשר (dataplex.entryGroups.getContextSet).
‫Dataplex Content User ‏(roles/dataplex.contentUser): גישה לצפייה בקבוצות של הקשרים, לקריאה ולרישום של רשומות הקשר ולבקשת שינויים בהקשרים.
עריכת תוכן ב-Dataplex (roles/dataplex.contentEditor): גישה לצפייה בקבוצות הקשר ולעדכון שלהן, לבקשת שינויים בהקשר וליצירה, קריאה, הצגה, עדכון ומחיקה של רשומות הקשר.
אדמין תוכן ב-Dataplex (roles/dataplex.contentAdmin): הרשאת אדמין מלאה לקבוצת הקשר קיימת, כולל כל ההרשאות של עריכת תוכן ב-Dataplex (roles/dataplex.contentEditor), מחיקת קבוצת ההקשר (dataplex.entryGroups.deleteContextSet) וניהול מדיניות IAM בקבוצת ההקשר (dataplex.entryGroups.setIamPolicy). התפקיד הזה לא נותן את ההרשאה dataplex.entryGroups.createContextSet. כדי ליצור קבוצת הקשר חדשה בפרויקט, צריך לתת את ההרשאה יצירת תוכן ב-Dataplex (roles/dataplex.contentCreator).

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

פעולה	הרשאת IAM
יצירת קבוצות של הקשרים (Knowledge Studio)	`dataplex.entryGroups.createContextSet`
מחיקת קבוצות הקשר (Knowledge Studio)	`dataplex.entryGroups.deleteContextSet`
קריאת קבוצות של הקשרים (Knowledge Studio)	`dataplex.entryGroups.getContextSet`
עדכון קבוצות ההקשרים (Knowledge Studio)	`dataplex.entryGroups.updateContextSet`
שינויים בהקשר של הבקשה (Knowledge Studio)	`dataplex.entryGroups.requestContextChanges`
יצירת רשומות הקשר (Knowledge Studio)	`dataplex.entries.createContext`
מחיקת רשומות הקשר (Knowledge Studio)	`dataplex.entries.deleteContext`
קריאת רשומות הקשר (Knowledge Studio)	`dataplex.entries.getContext`
הצגת רשומות הקשר (Knowledge Studio)	`dataplex.entries.listContext`
עדכון רשומות הקשר (Knowledge Studio)	`dataplex.entries.updateContext`
יצירת קבוצות של קבוצות הקשר (QueryData)	`dataplex.contextSetGroups.create`
מחיקת קבוצות של קבוצות הקשר (QueryData)	`dataplex.contextSetGroups.delete`
קריאת קבוצות של קבוצות הקשר (QueryData)	`dataplex.contextSetGroups.get`
הצגת רשימה של קבוצות הקשר (QueryData)	`dataplex.contextSetGroups.list`
עדכון קבוצות של קבוצות הקשר (QueryData)	`dataplex.contextSetGroups.update`
יצירת קבוצות הקשרים (QueryData)	`dataplex.contextSets.create`
מחיקת קבוצות הקשר (QueryData)	`dataplex.contextSets.delete`
הורדת הקשר מקבוצת הקשר (QueryData)	`dataplex.contextSets.download`
קריאת קבוצות הקשר (QueryData)	`dataplex.contextSets.get`
הצגת רשימה של קבוצות הקשר (QueryData)	`dataplex.contextSets.list`
עדכון קבוצות ההקשר (QueryData)	`dataplex.contextSets.update`
העלאת הקשר לקבוצת הקשר (QueryData)	`dataplex.contextSets.upload`
מחיקת ההקשר (QueryData)	`dataplex.context.delete`
הורדת ההקשר (QueryData)	`dataplex.context.download`
קריאת הקשר (QueryData)	`dataplex.context.get`
הקשר של רשימה (QueryData)	`dataplex.context.list`
עדכון ההקשר (QueryData)	`dataplex.context.update`

מידע נוסף זמין במאמר תפקידי IAM ב-Knowledge Catalog.

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

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

פעולה	הרשאת IAM
גישה לתוצאות של משימות ייצוא מטא-נתונים	`storage.objects.get`
`Cancel metadata jobs`	`dataplex.metadataJobs.cancel`
`Create metadata export jobs`	`dataplex.metadataJobs.create` `dataplex.entryGroups.export` `dataplex.entryGroups.get` `resourcemanager.projects.get` `resourcemanager.projects.list`
`Create metadata import jobs`	`dataplex.metadataJobs.create` ‫`dataplex.entryTypes.use` (לסוגי רשומות בהתאמה אישית בהיקף של המשימה) ‫`dataplex.entryTypes.useENTRY_TYPE` (לכל סוג רשומה של המערכת בהיקף של המשימה). ההרשאות לסוגי רשומות של המערכת עם זאת, ההרשאה הזו לא נדרשת כדי לשנות היבטים אופציונליים כשמפעילים משימת ייבוא של מטא-נתונים של היבטים בלבד. ‫`dataplex.aspectTypes.use` (לסוגי היבטים בהתאמה אישית בהיקף של המשימה) ‫`dataplex.aspectTypes.useASPECT_TYPE` (לכל סוג היבט של המערכת בהיקף המשימה). ההרשאות לסוגי היבטים של המערכת ‫`dataplex.entryGroups.import` (לקבוצות של רשומות בהיקף של המשימה)
`Get metadata jobs`	`dataplex.metadataJobs.get`
`List metadata jobs`	`dataplex.metadataJobs.list`

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

לכל סוג היבט, סוג רשומה וסוג קישור לרשומה שמוגדרים על ידי המערכת יש הרשאות IAM משלו. ההרשאות האלה הן בפורמט כמו dataplex.entryGroups.useASPECT_TYPE,‏ dataplex.entryGroups.useENTRY_TYPE או dataplex.entryGroups.useENTRY_LINK_TYPE. לדוגמה, ההרשאה לסוג ההיבט overview של המערכת היא dataplex.entryGroups.useOverviewAspect.

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

משאב	הרשאת IAM
‫`contacts` (סוג היבט המערכת)	`dataplex.entryGroups.useContactsAspect`
‫`data-profile` (סוג היבט המערכת)	`dataplex.entryGroups.useDataProfileAspect`
‫`data-quality-rule-template` (סוג היבט המערכת)	`dataplex.entryGroups.useDataQualityRuleTemplateAspect`
‫`data-quality-scorecard` (סוג היבט המערכת)	`dataplex.entryGroups.useDataQualityScorecardAspect`
‫`data-rules` (סוג היבט המערכת)	`dataplex.entryGroups.useDataRulesAspect`
‫`generic` (סוג היבט המערכת)	`dataplex.entryGroups.useGenericAspect`
‫`guidelines` (סוג היבט המערכת)	`dataplex.entryGroups.useGuidelinesAspect`
‫`overview` (סוג היבט המערכת)	`dataplex.entryGroups.useOverviewAspect`
‫`schema` (סוג היבט המערכת)	`dataplex.entryGroups.useSchemaAspect`
‫`schema-join` (סוג היבט המערכת)	`dataplex.entryGroups.useSchemaJoinAspect`
`generic` (סוג רשומה של המערכת)	`dataplex.entryGroups.useGenericEntry`
‫`definition` (סוג קישור של רשומת מערכת)	`dataplex.entryGroups.useDefinitionEntryLink`
‫`related` (סוג קישור של רשומת מערכת)	`dataplex.entryGroups.useRelatedEntryLink`
‫`synonym` (סוג קישור של רשומת מערכת)	`dataplex.entryGroups.useSynonymEntryLink`
‫`schema-join` (סוג קישור של רשומת מערכת)	`dataplex.entryGroups.useSchemaJoinEntryLink`

הרשאות לאגם, לאזור ולנכס

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

שיטת ה-API	הרשאת IAM
`CreateAsset`	dataplex.assets.create
`CreateLake`	dataplex.lakes.create
`CreateZone`	dataplex.zones.create
`DeleteAsset`	dataplex.assets.delete
`DeleteLake`	dataplex.lakes.delete
`DeleteZone`	dataplex.zones.delete
`GetAsset`	dataplex.assets.get
`GetLake`	dataplex.lakes.get
`GetZone`	dataplex.zones.get
`ListAssetActions`	dataplex.assetActions.list
`ListAssets`	dataplex.assets.list
`ListLakeActions`	dataplex.lakeActions.list
`ListLakes`	dataplex.lakes.list
`ListZoneActions`	dataplex.zoneActions.list
`ListZones`	dataplex.zones.list
`UpdateAsset`	dataplex.assets.update
`UpdateLake`	dataplex.lakes.update
`UpdateZone`	dataplex.zones.update

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

בטבלה הבאה מפורטות ההרשאות שנדרשות כדי לבצע פעולות במשימות:

שיטת ה-API	הרשאת IAM
`CancelJob`	dataplex.tasks.cancel
`CreateTask`	dataplex.tasks.create
`DeleteTask`	dataplex.tasks.delete
`GetJob`	dataplex.tasks.get
`GetTask`	dataplex.tasks.get
`ListJobs`	dataplex.tasks.get
`ListTasks`	dataplex.tasks.list
`UpdateTask`	dataplex.tasks.update

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

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

שיטת ה-API	הרשאת IAM
`CreateEntity`	dataplex.entities.create
`CreatePartition`	dataplex.partitions.create
`DeleteEntity`	dataplex.entities.delete
`DeletePartition`	dataplex.partitions.delete
`GetEntity`	dataplex.entities.get
`GetPartition`	dataplex.partitions.get
`ListEntities`	dataplex.entities.list
`ListPartitions`	dataplex.partitions.list

הרשאות לסריקת נתונים

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

שיטת ה-API	הרשאת IAM
`CancelDataScanJob`	dataplex.datascans.cancel
`CreateDataScan`	dataplex.datascans.create
`DeleteDataScan`	dataplex.datascans.delete
`GetDataScan` (תצוגה בסיסית)	dataplex.datascans.get
`GetDataScan` (תצוגה מלאה)	dataplex.datascans.getData
`GetDataScanJob` (תצוגה בסיסית)	dataplex.datascans.get
`GetDataScanJob` (תצוגה מלאה)	dataplex.datascans.getData
`ListDataScanJobs`	dataplex.datascans.get
`ListDataScans`	dataplex.datascans.list
`RunDataScan`	dataplex.datascans.run
`UpdateDataScan`	dataplex.datascans.update

משימות העשרה ב-Knowledge Studio

כדי ליצור ולנהל משימות העשרה ב-Knowledge Studio, נדרשות ההרשאות הבאות:

פעולה	הרשאת IAM
יצירת משימות העשרה	`dataplex.agentTasks.create`
מחיקת משימות העשרה	`dataplex.agentTasks.delete`
לקרוא את פרטי המשימה להעשרה	`dataplex.agentTasks.get`
לקרוא ולאחזר תוצאות של נתונים בסיסיים	`dataplex.agentTasks.getData`
משימות להעשרת רשימות	`dataplex.agentTasks.list`
עדכון משימות העשרה	`dataplex.agentTasks.update`
הרצת משימות העשרה	`dataplex.agentTasks.run`
בקשת שינויים בקבוצות של רשומות או בקבוצות של הקשרים (הצעות)	`dataplex.entryGroups.requestContextChanges` (קבוצות הקשר) או `dataplex.entryGroups.requestChanges` (קבוצות של רשומות)
אישור בקשות לשינוי מטא-נתונים	`dataplex.changeRequests.use`

הרשאות לספקי אימות של צד שלישי

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

פעולה	הרשאת IAM
יצירת ספקי אימות	`agentidentity.authProviders.create`
הצגת פרטי ספק האימות	`agentidentity.authProviders.get`
מחיקת ספקי אימות	`agentidentity.authProviders.delete`
עדכון ספקי אימות	`agentidentity.authProviders.update`
הגדרת מדיניות IAM בספקי אימות	`agentidentity.authProviders.setIamPolicy`

הרשאות ליצירת פרופילים ב-BigQuery

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

BigQuery Data Viewer‏ (roles/bigquery.dataViewer) במערכי הנתונים ובטבלאות היעד, ובכל טבלת מעקב של Agent Analytics.
BigQuery Job User‏ (roles/bigquery.jobUser) בפרויקט המשימה, ובפרויקט טבלת המעקב אם הוא שונה.

כדי לאפשר לנציג לנתח גם את היסטוריית השאילתות של הטבלאות ב-BigQuery, צריך לתת לחשבון השירות בניהול הלקוח את התפקיד צפייה במשאבים של BigQuery (roles/bigquery.resourceViewer) בפרויקטים שבהם נמצאת היסטוריית השאילתות.