במאמר הזה מפורטות ההרשאות של ניהול זהויות והרשאות גישה (IAM) למשאבים של Knowledge Catalog. אתם יכולים להשתמש בהרשאות האלה כדי ליצור תפקידים בהתאמה אישית, או כדי לאמת את הגישה הפרטנית שנדרשת לניהול מטא-נתונים, לסריקות נתונים, לפעולות באגם נתונים, למשימות ולסביבות.
הרשאות ותפקידים
אי אפשר להעניק למשתמשים הרשאות באופן ישיר. במקום זאת, אתם מקצים להם תפקידים שכוללים הרשאה אחת או יותר. הגישה הזו תואמת לעיקרון של הרשאות מינימליות, ומעודדת אתכם לתת למשתמש או לחשבון השירות רק את הגישה שנדרשת כדי לבצע את המשימות שלהם.
ב-IAM יש תפקידים מוגדרים מראש לתרחישים נפוצים לדוגמה. אם התפקידים המוגדרים מראש לא עונים על הצרכים הספציפיים שלכם, אתם יכולים ליצור תפקידים בהתאמה אישית שכוללים רק את ההרשאות הספציפיות שאתם צריכים.
מידע נוסף על התפקידים המוגדרים מראש ב-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 |
|
Delete entry types |
|
Get entry types |
dataplex.entryTypes.get |
List entry types |
dataplex.entryTypes.list |
Update entry types |
|
|
שימוש בסוגי רשומות (כשיוצרים רשומות, מעדכנים שדות של רשומות ברמה העליונה וערכים נדרשים של סוגי היבטים) |
|
סוגי היבטים
כדי ליצור ולנהל סוגי היבטים, צריך לקבל את ההרשאות הרגילות 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 |
לא רלוונטי | לא רלוונטי |
| כשיוצרים או מעדכנים רשומות, מגדירים ערכים אופציונליים של סוגי היבטים |
|
|
לא רלוונטי |
| כשיוצרים או מעדכנים רשומות, צריך להגדיר את ערכי סוגי ההיבטים הנדרשים |
|
|
לא רלוונטי |
Update aspect types |
dataplex.aspectTypes.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 |
|
|
לא רלוונטי |
Get entries |
כדי לראות את היבטי הנתונים, צריך גם את ההרשאה |
כדי לראות את היבטי הנתונים, צריך גם את ההרשאה |
כדי לראות את היבטי הנתונים, צריך גם את ההרשאה |
List entries |
dataplex.entries.list |
dataplex.entries.list |
dataplex.entries.list |
Lookup entries |
נדרשת הרשאת קריאה של מטא-נתונים במערכת המקור. כדי לראות את היבטי הנתונים, נדרשת הרשאה לקרוא נתונים ממערכת המקור. ברשומות בהתאמה אישית, שבהן Knowledge Catalog נחשב למערכת המקור, ההרשאות האלה הן |
נדרשת הרשאת קריאה של מטא-נתונים במערכת המקור. כדי לראות את היבטי הנתונים, נדרשת הרשאה לקרוא נתונים ממערכת המקור. ברשומות בהתאמה אישית, שבהן Knowledge Catalog נחשב למערכת המקור, ההרשאות האלה הן |
נדרשת הרשאת קריאה של מטא-נתונים במערכת המקור. כדי לראות את היבטי הנתונים, נדרשת הרשאה לקרוא נתונים ממערכת המקור. ברשומות בהתאמה אישית, שבהן Knowledge Catalog נחשב למערכת המקור, ההרשאות האלה הן |
Search entries |
הרשאת קריאה במערכת המקור המקורית. ברשומות בהתאמה אישית, הערך הוא |
הרשאת קריאה במערכת המקור המקורית. ברשומות בהתאמה אישית, הערך הוא |
הרשאת קריאה במערכת המקור המקורית. ברשומות בהתאמה אישית, הערך הוא |
Update entries |
|
|
אי אפשר לערוך שדות ברמה העליונה והיבטים נדרשים. |
קישורים לערכים
כדי ליצור ולנהל קישורי כניסה, צריך לקבל את ההרשאות create, get, list ו-delete ב-dataplex.entryLinks.
שימו לב לנקודות הבאות:
- כדי ליצור קישורי רשומות (
CreateEntryLink) צריך גם הרשאות לסוג קישור הרשומה והרשאות לרשומות הספציפיות של הקישור. - כשיוצרים קישור לרשומה עם מאפיין נדרש, צריך הרשאות כדי להשתמש בסוג המאפיין.
- כשמעדכנים או מוסיפים (upsert) קישור לרשומה (
UpdateEntryLinkעםallow_missing = True), צריך גם את אותן ההרשאות שנדרשות בשבילCreateEntryLink.
בטבלה הבאה מפורטות ההרשאות שנדרשות כדי לבצע פעולות בקישורים לרשומות:
| פעולה | הרשאת IAM |
|---|---|
| יצירת קישורים לדפים ביומן |
ההרשאות שנדרשות בהתאם לסוג הקישור לרשומה:
הרשאה להשתמש בסוג הקישור לכניסה:
הרשאות לכל ההיבטים הנדרשים שצוינו בסוג הקישור של הרשומה:
|
| מחיקת קישורים לרשומות | dataplex.entryLinks.delete (בקבוצת הרשומות) |
| קבלת קישורים לערכים |
|
| קישורים לערכים במילון |
נדרשת הרשאת קריאה של מטא-נתונים של מערכת המקור ברשומה שעבורה מחפשים קישורים לרשומות. ברשומות מותאמות אישית מקושרות, שבהן Knowledge Catalog נחשב למערכת המקור, ההרשאה היא ברשומות של מערכות מקושרות, ההרשאה היא הרשאת קריאה של מערכת המקור של הרשומה המקושרת. |
| עדכון הקישור לרשומה |
הרשאה להשתמש בסוג הקישור לכניסה:
הרשאות לכל ההיבטים הנדרשים שצוינו בסוג הקישור של הרשומה:
אם |
מגבלות על היבטים בקישורים לערכים
המגבלות הבאות חלות על שימוש בהיבטים עם קישורי רשומות.
קבוצות הקשרים
קבוצות הקשר הן מאגרים מוגבלים של נכסי נתונים ומטא-נתונים של יעדים, שמשמשים לביסוס מודלי AI בלוגיקה העסקית הקניינית שלכם. הם יכולים להכיל מידע ספציפי למסד הנתונים, כמו תבניות של שאילתות SQL או שאילתות חיפוש ערכים לכלים של המרת טקסט ל-SQL כמו QueryData, אבל ב-Knowledge Studio משתמשים בקבוצות הקשר גם כדי לאחסן מילוני מונחים, סקירות כלליות של טבלאות מובְנות ומיפויים של נתונים ארגוניים.
למידע נוסף על השימוש בקבוצות הקשר ב- Google Cloud, קראו את הסקירה הכללית על קבוצות הקשר ב-Knowledge Studio, ב-AlloyDB ל-PostgreSQL, ב-Cloud SQL ל-MySQL, ב-Cloud SQL ל-PostgreSQL או ב-Spanner.
כדי ליצור ולנהל קבוצות של הקשרים לביסוס נתונים ב-AI, צריך לקבל את תפקידי ה-IAM הבאים:
- Dataplex Catalog Viewer (
roles/dataplex.catalogViewer): גישה לקריאה בלבד כדי להציג, להוריד ולראות רשימה של קבוצות הקשר, ולראות מיקומים. - עריכת קטלוג Dataplex (
roles/dataplex.catalogEditor): גישה לעדכון, למחיקה, להעלאה ולהורדה של קבוצות הקשר. - אדמין של Dataplex Catalog (
roles/dataplex.catalogAdmin) או בעלים של קבוצת רשומות ב-Dataplex (roles/dataplex.entryGroupOwner): גישת אדמין מלאה לקבוצות הקשרים, כולל ההרשאהdataplex.entryGroups.setIamPolicyשנדרשת כדי ליצור קבוצות הקשרים.
בטבלה הבאה מפורטות הרשאות ה-IAM שנדרשות כדי לבצע פעולות בקבוצות הקשר:
| פעולה | הרשאת IAM |
|---|---|
| יצירת קבוצות של הקשרים | dataplex.entryGroups.createContextSet |
| מחיקת קבוצות הקשרים | dataplex.entryGroups.deleteContextSet |
| קריאת קבוצות הקשרים | dataplex.entryGroups.getContextSet |
| עדכון קבוצות ההקשרים | dataplex.entryGroups.updateContextSet |
| בקשת שינויים בהקשר | dataplex.entryGroups.requestContextChanges |
| יצירת רשומות הקשר | dataplex.entries.createContext |
| מחיקת רשומות הקשר | dataplex.entries.deleteContext |
| קריאת רשומות הקשר | dataplex.entries.getContext |
| הצגת רשימה של ערכי הקשר | dataplex.entries.listContext |
| עדכון רשומות ההקשר | dataplex.entries.updateContext |
מידע נוסף זמין במאמר תפקידי IAM ב-Knowledge Catalog.
הרשאות למשימות של מטא-נתונים
בטבלה הבאה מפורטות ההרשאות שנדרשות כדי לעבוד עם משימות ייבוא של מטא-נתונים ומשימות ייצוא של מטא-נתונים.
| פעולה | הרשאת IAM |
|---|---|
| גישה לתוצאות של משימות ייצוא מטא-נתונים |
|
Cancel metadata jobs |
|
Create metadata export jobs |
|
Create metadata import jobs |
|
Get metadata jobs |
|
List metadata jobs |
|
סוגי היבטים, סוגי רשומות וסוגי קישורים לרשומות במערכת
לכל סוג היבט, סוג רשומה וסוג קישור לרשומה שמוגדרים על ידי המערכת יש הרשאות 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.requestChanges |
| אישור בקשות לשינוי מטא-נתונים | dataplex.changeRequests.use |
| ביטול הפעלות של משימות העשרה | dataplex.agentTasks.cancel |
הרשאות לספקי אימות של צד שלישי
כשמגדירים מחברים חיצוניים, צריך את ההרשאות הבאות של Agent Identity כדי לנהל את ספקי האימות:
| פעולה | הרשאת IAM |
|---|---|
| יצירת ספקי אימות | agentidentity.authProviders.create |
| הצגת הפרטים של ספק האימות | agentidentity.authProviders.get |
| מחיקת ספקי אימות | agentidentity.authProviders.delete |
| עדכון ספקי אימות | agentidentity.authProviders.update |
הרשאות ליצירת פרופילים ב-BigQuery
כדי לאפשר לסוכן ההעשרה ליצור פרופיל נתונים ב-BigQuery ולקרוא את היסטוריית השאילתות בטבלה, צריך להקצות את התפקידים BigQuery Data Viewer (roles/bigquery.dataViewer) ו-BigQuery Resource Viewer (roles/bigquery.resourceViewer) לסוכן השירות של Knowledge Catalog (service-<var>PROJECT_NUMBER</var>@gcp-sa-dataplex.iam.gserviceaccount.com) בפרויקט היעד.