תהליכי עבודה של פיקוח ב-Knowledge Catalog מאפשרים לכם לעקוב אחרי בקשות לשינויים, להעריך אותן ולבצע בהן ביקורת, כמו בקשות גישה למוצרי נתונים, לאורך מחזור החיים שלהן. כמבקשים, כמאשרים או כאדמינים של תהליך עבודה, אתם יכולים לשנות בקשות בהמתנה, לאשר או לדחות גישה כדי להפוך את הקצאת ההרשאות לאוטומטית, ולעקוב אחרי יומני האישורים כדי לוודא שהם עומדים בדרישות.
לפני שמתחילים
כדי להשתמש בתהליכי עבודה של משילות, ודאו שהפעלתם את ממשקי ה-API הנדרשים, ושלמאשרים ולאדמינים יש את התפקידים וההרשאות הנדרשים לניהול זהויות והרשאות גישה (IAM).
מפעילים את Dataplex API, אם הוא עדיין לא מופעל.
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לשימוש בתהליכי עבודה של פיקוח, בקשו מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט:
-
חיפוש מוצרי נתונים:
צפייה בקטלוג Dataplex (
roles/dataplex.catalogViewer) -
חיפוש נכסי נתונים ובקשת גישה:
צרכן של מוצרי נתונים ב-Dataplex (
roles/dataplex.dataProductsConsumer) -
גישה לקריאה בלבד כדי לצפות בהגדרות ובמטא-נתונים של מוצרי נתונים:
צפייה במוצרי נתונים ב-Dataplex (
roles/dataplex.dataProductsViewer) -
אישור בקשות גישה למוצרי נתונים:
- עריכת מוצרי נתונים ב-Dataplex (
roles/dataplex.dataProductsEditor) - אדמין של מוצרי נתונים ב-Dataplex (
roles/dataplex.dataProductsAdmin) - גורם מאשר של תהליך עבודה ב-Dataplex (
roles/dataplex.workflowApprover)
- עריכת מוצרי נתונים ב-Dataplex (
-
ניהול תהליכי עבודה של משילות:
אדמין של תהליכי עבודה ב-Dataplex (
roles/dataplex.workflowAdmin)
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
מידע נוסף זמין במאמר תפקידי IAM ב-Knowledge Catalog.
ניהול בקשות בתור מגיש הבקשה
בתור מבקשים, אתם יוזמים בקשות לשינויים, כמו בקשת גישה למוצרי נתונים. אחרי ששולחים בקשה, אפשר לעקוב אחרי ההתקדמות שלה, לראות את הפרטים שלה, לערוך את הפרטים של בקשות בהמתנה במצב NEW או למחוק בקשות לפני שגורם מאשר מטפל בהן.
צפייה בבקשות שנוצרו
כדי להציג את כל הבקשות שיצרתם, פועלים לפי השלבים הבאים:
המסוף
נכנסים לדף Governance Workflows ב-Knowledge Catalog במסוף Google Cloud .
לוחצים על הכרטיסייה הבקשות שלי כדי לראות רשימה של כל הבקשות הקודמות והבקשות שבהמתנה.
REST
צפייה בבקשות שנוצרו
כדי לקבל רשימה של הבקשות ששלחתם:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו נמצא המשאב (לדוגמה,us-central1). -
USER_EMAIL: כתובת האימייל שלכם.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests?filter=author=USER_EMAIL
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"changeRequests": [
{
"name": "projects/PROJECT_ID/locations/LOCATION/changeRequests/sample-change-request-1",
"uid": "123e4567-e89b-12d3-a456-426614174000",
"createTime": "2026-07-20T10:00:00Z",
"updateTime": "2026-07-20T10:00:00Z",
"justification": "Proposing a new glossary term definition for business accuracy.",
"author": "USER_EMAIL",
"state": "NEW",
"resource": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
"createGlossaryTerm": {
"parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
"termId": "sample-term-id",
"term": {
"displayName": "Sample term name",
"description": "Sample term description",
"parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary"
}
}
}
]
}
צפייה בבקשה ספציפית
כדי לראות בקשה ספציפית:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו נמצא המשאב (לדוגמה,us-central1). -
CHANGE_REQUEST_ID: מזהה הבקשה.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID",
"uid": "123e4567-e89b-12d3-a456-426614174000",
"createTime": "2026-07-20T10:00:00Z",
"updateTime": "2026-07-20T10:00:00Z",
"justification": "Proposing a new glossary term definition for business accuracy.",
"author": "user@example.com",
"state": "NEW",
"resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
"createGlossaryTerm": {
"parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
"termId": "sample-term-id",
"term": {
"displayName": "Sample term name",
"description": "Sample term description",
"parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
}
}
}
עריכת בקשה
אפשר לעדכן פרטים של בקשה קיימת בהמתנה במצב NEW. לדוגמה, אתם יכולים לשנות את ההצדקה שסיפקתם בבקשה.
REST
כדי לערוך בקשה, שולחים בקשת PATCH שמכילה את השדה ששונה:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו נמצא המשאב (לדוגמה,us-central1). -
CHANGE_REQUEST_ID: המזהה הייחודי של בקשת השינוי. -
NEW_JUSTIFICATION: ההצדקה המעודכנת לבקשת השינוי.
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID?updateMask=justification
תוכן בקשת JSON:
{
"justification": "NEW_JUSTIFICATION"
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.
מחיקת בקשה
אפשר למחוק רק בקשות שנמצאות במצב NEW. כדי למחוק בקשה:
המסוף
נכנסים לדף Governance Workflows ב-Knowledge Catalog במסוף Google Cloud .
לוחצים על הכרטיסייה הבקשות שלי.
מאתרים את השורה שמכילה את הבקשה הרלוונטית. אם צריך, מפעילים מסנן כדי לבודד את הרשומה.
לוחצים על פעולות ואז על מחיקה.
REST
כדי למחוק בקשה, שולחים בקשת DELETE שכוללת את מזהה הבקשה:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו נמצא המשאב (לדוגמה,us-central1). -
CHANGE_REQUEST_ID: המזהה של הבקשה שרוצים למחוק.
ה-method של ה-HTTP וכתובת ה-URL:
DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.
ניהול בקשות כגורם מאשר
כמאשרים, אתם בודקים, מעריכים ומטפלים בבקשות ממתינות לניהול משאבי הנתונים שלכם. כשאתם מאשרים או דוחים בקשה, המערכת מעבדת את ההחלטה באופן אוטומטי ושולחת התראה באימייל למבקש עם פרטי ההחלטה וההצדקה שלכם.
רשימת הבקשות בהמתנה
כדי להציג את רשימת הבקשות שממתינות לבדיקה:
המסוף
נכנסים לדף Governance Workflows ב-Knowledge Catalog במסוף Google Cloud .
לוחצים על הכרטיסייה אישורים בהמתנה כדי לראות את הבקשות שממתינות לבדיקה. אפשר לסנן את הבקשות לפי סוג המשאב, סוג הבקשה או התאריך.
REST
כדי להציג רשימה של בקשות גישה שממתינות לבדיקה בפרויקט ובמיקום ספציפיים, שולחים בקשת GET:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו נמצא המשאב. לדוגמה,us-central1.
שיטת ה-HTTP וכתובת ה-URL:
GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"changeRequests": [
{
"name": "projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/sample-change-request-1",
"uid": "123e4567-e89b-12d3-a456-426614174000",
"createTime": "2026-07-20T10:00:00Z",
"updateTime": "2026-07-20T10:00:00Z",
"justification": "Proposing a new glossary term definition for business accuracy.",
"author": "user@example.com",
"state": "NEW",
"resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
"createGlossaryTerm": {
"parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
"termId": "sample-term-id",
"term": {
"displayName": "Sample term name",
"description": "Sample term description",
"parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
}
}
}
]
}
אישור בקשה
כדי לאשר בקשה, פועלים לפי השלבים הבאים:
המסוף
נכנסים לדף Governance Workflows ב-Knowledge Catalog במסוף Google Cloud .
לוחצים על הכרטיסייה אישורים בהמתנה.
מאתרים את השורה שמכילה את הבקשה שרוצים לאשר.
לוחצים על פעולות ואז על אישור.
REST
כדי לאשר בקשה, שולחים בקשת POST ל-method המותאם אישית :approve:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו נמצא המשאב (לדוגמה,us-central1). -
CHANGE_REQUEST_ID: המזהה הייחודי של בקשת השינוי שרוצים לאשר.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:approve
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.
אחרי שהבקשה תטופל, הסטטוס שלה יתעדכן באופן אוטומטי והיא תעבור לכרטיסייה יומן אישורים.
דחיית בקשה
כדי לדחות בקשה, פועלים לפי השלבים הבאים:
המסוף
נכנסים לדף Governance Workflows ב-Knowledge Catalog במסוף Google Cloud .
לוחצים על הכרטיסייה אישורים בהמתנה.
מאתרים את השורה שמכילה את הבקשה שרוצים לדחות.
לוחצים על פעולות ואז על דחייה.
בתיבת הדו-שיח, מזינים את הסיבה לדחייה.
לוחצים על דחייה כדי לאשר.
REST
כדי לדחות בקשה, שולחים בקשת POST ל-method המותאם אישית :reject יחד עם מטען ייעודי (payload) של הצדקה:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו נמצא המשאב (לדוגמה,us-central1). -
CHANGE_REQUEST_ID: המזהה הייחודי של בקשת השינוי שרוצים לדחות. REJECTION_REASON: הסיבה לדחייה.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:reject
תוכן בקשת JSON:
{
"comment": "REJECTION_REASON"
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.
הוספת הערה ברורה על דחיית הבקשה עוזרת למבקשים להבין את ההחלטה ולשפר את ההצדקות שלהם לבקשת הגישה לפני שהם שולחים אותה מחדש.
ניהול בקשות כאדמין של תהליך עבודה
אדמינים של תהליכי עבודה מפקחים על כל בקשות הפיקוח בארגון, עוקבים אחרי היסטוריית האישורים ומוודאים שהארגון עומד בדרישות. אתם יכולים להציג את כל הבקשות הפעילות וההיסטוריות, לעקוב אחרי נתיבי ביקורת בכל מצבי הבקשות (NEW, APPROVED, REJECTED, DELETED) ולמחוק כל בקשה, בלי קשר למצב הנוכחי שלה.
הצגת כל הבקשות
כדי להציג את כל הבקשות בפרויקט ובמיקום ספציפיים:
REST
כדי לראות את רשימת כל בקשות הגישה בפרויקט ובמיקום ספציפיים, שולחים בקשת GET:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו נמצא המשאב. לדוגמה,us-central1.
שיטת ה-HTTP וכתובת ה-URL:
GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"changeRequests": [
{
"name": "projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/sample-change-request-1",
"uid": "123e4567-e89b-12d3-a456-426614174000",
"createTime": "2026-07-20T10:00:00Z",
"updateTime": "2026-07-20T10:00:00Z",
"justification": "Proposing a new glossary term definition for business accuracy.",
"author": "user@example.com",
"state": "NEW",
"resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
"createGlossaryTerm": {
"parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
"termId": "sample-term-id",
"term": {
"displayName": "Sample term name",
"description": "Sample term description",
"parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
}
}
}
]
}
מעקב אחרי היסטוריית האישורים
יומן האישורים מספק נראות מלאה של הביקורת על בקשות הגישה למוצרי נתונים, ומאפשר לאדמינים ולצוותי התאימות לעקוב אחרי שינויים וגישה בכל המצבים.
המסוף
נכנסים לדף Governance Workflows במסוף Google Cloud .
כדי לראות אישורים ודחיות שהושלמו ונתיבי ביקורת היסטוריים, עוברים לכרטיסייה יומן אישורים.
REST
כדי להציג את כל הבקשות לפרויקט ספציפי, שולחים בקשת GET:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו נמצא המשאב. לדוגמה,us-central1.
שיטת ה-HTTP וכתובת ה-URL:
GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"changeRequests": [
{
"name": "projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/sample-change-request-1",
"uid": "123e4567-e89b-12d3-a456-426614174000",
"createTime": "2026-07-20T10:00:00Z",
"updateTime": "2026-07-20T10:00:00Z",
"justification": "Proposing a new glossary term definition for business accuracy.",
"author": "user@example.com",
"state": "NEW",
"resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
"createGlossaryTerm": {
"parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
"termId": "sample-term-id",
"term": {
"displayName": "Sample term name",
"description": "Sample term description",
"parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
}
}
}
]
}