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

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

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

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

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

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

מפעילים את Dataplex API, אם הוא עדיין לא מופעל.

התפקידים שנדרשים כדי להפעיל ממשקי API

כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, אתם יכולים לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים?

להפעלת ה-API

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

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

בקשת שינויים במטא-נתונים: צפייה ב-Dataplex Catalog‏ (roles/dataplex.catalogViewer)
מאשרים את השינויים במטא-נתונים:
- גורם מאשר של תהליך עבודה ב-Dataplex ‏(roles/dataplex.workflowApprover)
- עריכה ב-Dataplex Catalog ‏(roles/dataplex.catalogEditor)
- בעלים של רשומה ב-Dataplex ‏(roles/dataplex.entryOwner)
ניהול תהליכי עבודה של משילות: אדמין של תהליכי עבודה ב-Dataplex ‏(roles/dataplex.workflowAdmin)

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

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

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

בקשת שינויים בקטגוריה של מילון מונחים

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

יצירת קטגוריה

המסוף

כדי לבקש קטגוריה:

נכנסים לדף Glossaries של Knowledge Catalog במסוף Google Cloud .

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

המערכת מתעדת בקשה חדשה לשינוי ושולחת הודעה לגורם המאשר. אפשר לעקוב אחרי התקדמות הבקשה בדף Governance Workflows בכרטיסייה My Requests.

REST

כדי לבקש ליצור קטגוריה, משתמשים ב-method‏ glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createCategoryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "categoryId": "sample-category-id",
      "category": {
        "displayName": "Sample category name",
        "description": "Sample category description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצא מילון המונחים, למשל us-central1.
‫GLOSSARY_ID: המזהה של מילון המונחים הראשי.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

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

עדכון קטגוריה

המסוף

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

נכנסים לדף Glossaries של Knowledge Catalog במסוף Google Cloud .

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

REST

כדי לבקש עדכון של השם המוצג והתיאור של קטגוריה, משתמשים ב-method‏ glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateCategoryRequest": {
      "category": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצא מילון המונחים, למשל us-central1.
‫GLOSSARY_ID: המזהה של מילון המונחים הראשי.
‫CATEGORY_ID: המזהה של קטגוריית היעד שרוצים לעדכן.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

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

מחיקת קטגוריה

המסוף

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

נכנסים לדף Glossaries של Knowledge Catalog במסוף Google Cloud .

כניסה לדף Glossaries
מרחיבים את מילון המונחים ולוחצים על הקטגוריה שרוצים למחוק.
בחלונית Category details, לוחצים על Delete בתפריט.
אופציונלי: בקטע Justification, מסבירים למאשר את הסיבה לשינוי.
לוחצים על שליחה לבדיקה.

REST

כדי לבקש מחיקה של קטגוריה, משתמשים ב-method‏ glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteCategoryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצא מילון המונחים, למשל us-central1.
‫GLOSSARY_ID: המזהה של מילון המונחים הראשי.
‫CATEGORY_ID: המזהה של קטגוריית היעד שרוצים למחוק.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

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

בקשת שינויים במונח במילון

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

יצירת מונח במילון

המסוף

כדי לבקש ליצור מונח במילון המונחים:

נכנסים לדף Glossaries של Knowledge Catalog במסוף Google Cloud .

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

REST

כדי לשלוח בקשה ליצירת מונח במילון, משתמשים ב-method‏ glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createTermRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "termId": "sample-term-id",
      "term": {
        "displayName": "Sample term name",
        "description": "Sample term description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצא מילון המונחים, למשל us-central1.
‫GLOSSARY_ID: המזהה של מילון המונחים הראשי.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

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

עדכון מונח במילון

המסוף

כדי לבקש שינויים במונח במילון המונחים, פועלים לפי השלבים הבאים:

נכנסים לדף Glossaries של Knowledge Catalog במסוף Google Cloud .

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

REST

כדי לבקש עדכון של השם המוצג והתיאור של מונח במילון המונחים, משתמשים ב-method‏ glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateTermRequest": {
      "term": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצא מילון המונחים, למשל us-central1.
‫GLOSSARY_ID: המזהה של מילון המונחים הראשי.
‫TERM_ID: המזהה של המונח שרוצים לעדכן.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

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

מחיקת מונח במילון

המסוף

כדי לבקש למחוק מונח:

נכנסים לדף Glossaries של Knowledge Catalog במסוף Google Cloud .

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

REST

כדי לבקש מחיקה של מונח במילון, משתמשים ב-method‏ glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteTermRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצא מילון המונחים, למשל us-central1.
‫GLOSSARY_ID: המזהה של מילון המונחים הראשי.
‫TERM_ID: המזהה של מונח היעד שרוצים למחוק.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

השירות מחזיר RequestGlossaryChangeResponse שמכיל את שם המשאב של ChangeRequest.המערכת מתעדת בקשת שינוי חדשה ביומן ומודיעה למאשר.

בקשת שינויים ברשומה

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

יצירת דף

המסוף

כדי לבקש ליצור רשומה:

במסוף Google Cloud , נכנסים לדף Metadata types ב-Knowledge Catalog.

מעבר לסוגי מטא-נתונים
לוחצים על הכרטיסייה קבוצות של רשומות.
בוחרים את קבוצת הרשומות שבה רוצים ליצור רשומה ולוחצים על Create entry.
מזינים מזהה ושם לתצוגה של הרשומה.
בוחרים סוג רשומה.
אופציונלי: מוסיפים פרטים על ההיבט או תיאור.
לוחצים על שליחה לבדיקה. בחלק מהסעיפים יכול להיות שתצטרכו לספק הצדקה נוספת לפני שתוכלו לשלוח את הבקשה. מציינים את ההצדקה ולוחצים על המשך לשליחת השינויים.

REST

כדי לבקש ליצור רשומה, משתמשים ב-method‏ entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryId": "sample-entry-id",
      "entry": {
        "entryType": "projects/PROJECT_ID/locations/LOCATION/entryTypes/ENTRY_TYPE_ID",
        "entrySource": {
          "displayName": "Sample entry name",
          "description": "Sample entry description"
        }
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצאת קבוצת הרשומות, למשל us-central1.
‫ENTRY_GROUP_ID: המזהה של קבוצת הרשומות ההורה.
‫ENTRY_TYPE_ID: המזהה של סוג הרשומה.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

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

עדכון רשומה

המסוף

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

במסוף Google Cloud , נכנסים לדף Search או לדף Catalog ב-Knowledge Catalog.

מעבר לחיפוש

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

המערכת מתעדת בקשה חדשה לשינוי ושולחת הודעה לגורם המאשר. אפשר לעקוב אחרי התקדמות הבקשה בדף Governance Workflows בכרטיסייה My requests.

REST

כדי לבקש עדכון של השם המוצג והתיאור של מקור נתונים, משתמשים ב-method‏ entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "entrySource": {
          "displayName": "Sample new name",
          "description": "Sample new description"
        }
      },
      "updateMask": {
        "paths": [
          "entry_source.display_name",
          "entry_source.description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצאת קבוצת הרשומות, למשל us-central1.
‫ENTRY_GROUP_ID: המזהה של קבוצת הרשומות ההורה.
‫ENTRY_ID: המזהה של רשומת היעד.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

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

מחיקת רשומה

המסוף

כדי לבקש למחוק רשומה:

במסוף Google Cloud , נכנסים לדף Search או לדף Catalog ב-Knowledge Catalog.

מעבר לחיפוש

מחפשים את הרשומה שרוצים למחוק ובוחרים אותה.
לוחצים על הרשומה כדי לפתוח את הדף Entry details.
לוחצים על Delete.
לוחצים על שליחה לבדיקה. בחלק מהסעיפים יכול להיות שתצטרכו לספק הצדקה נוספת לפני שתוכלו לשלוח את הבקשה. מציינים את ההצדקה ולוחצים על המשך לשליחת השינויים.

REST

כדי לבקש מחיקה של רשומה, משתמשים ב-method‏ entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצאת קבוצת הרשומות, למשל us-central1.
‫ENTRY_GROUP_ID: המזהה של קבוצת הרשומות ההורה.
‫ENTRY_ID: המזהה של הרשומה שרוצים למחוק.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

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

עדכון היבט

המסוף

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

נכנסים לדף Search של Knowledge Catalog במסוף Google Cloud .

מעבר לחיפוש

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

REST

כדי לבקש לצרף או לעדכן היבט של אנשי קשר ברשומה, משתמשים ב-method‏ entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "aspects": {
          "dataplex-types.global.contacts": {
            "data": {
              "identities": [
                {
                  "role": "Data Steward",
                  "name": "Dana",
                  "id": "dana@example.com"
                }
              ]
            }
          }
        }
      },
      "updateMask": {
        "paths": [
          "aspects"
        ]
      },
      "aspectKeys": [
        "dataplex-types.global.contacts"
      ]
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצאת קבוצת הרשומות, למשל us-central1.
‫ENTRY_GROUP_ID: המזהה של קבוצת הרשומות ההורה.
‫ENTRY_ID: המזהה של רשומת היעד.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

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

יצירת קישור כניסה

המסוף

כדי לבקש ליצור קישור לערך, למשל כדי לצרף מונח במילון, פועלים לפי השלבים הבאים:

נכנסים לדף Search של Knowledge Catalog במסוף Google Cloud .

מעבר לחיפוש
מחפשים את רשומת נכס הנתונים שרוצים לקשר אליה מונח ובוחרים אותה.
בדף הפרטים של הרשומה, מבצעים אחת מהפעולות הבאות:
- כדי לקשר מונח לרשומה, בכרטיסייה Details, בקטע Glossary terms, לוחצים על Add.
- כדי לקשר מונח לעמודה, בכרטיסייה Schema בוחרים את העמודה ולוחצים על Add business term.
מחפשים ובוחרים את המונח שרוצים לקשר.
אופציונלי: מציינים את הסיבה לשינוי.
לוחצים על שליחה לבדיקה.

REST

כדי לבקש ליצור קישור הגדרה בין מונח במילון המונחים לבין רשומה של נכס נתונים, משתמשים ב-method‏ entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryLinkRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryLinkId": "sample-definition-link",
      "entryLink": {
        "entryLinkType": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
        "entryReferences": [
          {
            "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
            "type": "SOURCE"
          },
          {
            "name": "projects/PROJECT_ID/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_ID/locations/global/glossaries/GLOSSARY_ID/terms/TERM_ID",
            "type": "TARGET"
          }
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצאת קבוצת הרשומות, למשל us-central1.
‫ENTRY_GROUP_ID: המזהה של קבוצת הרשומות ההורה.
‫ENTRY_ID: המזהה של רשומת היעד.
‫GLOSSARY_ID: המזהה של מילון המונחים שמכיל את המונח.
‫TERM_ID: המזהה של המונח במילון המונחים.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

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

מחיקת קישור לרשומה

המסוף

כדי לבקש למחוק קישור לערך, למשל כדי להסיר מונח מצורף ממילון המונחים, פועלים לפי השלבים הבאים:

נכנסים לדף Search של Knowledge Catalog במסוף Google Cloud .

מעבר לחיפוש
מחפשים את רשומת נכס הנתונים שרוצים להסיר ממנה מונח מקושר ובוחרים בה.
בדף הפרטים של הרשומה, מבצעים אחת מהפעולות הבאות:
- כדי להסיר מונח מהרשומה, בכרטיסייה Details, בקטע Glossary terms, לוחצים על המונח ואז על Remove.
- כדי להסיר מונח מעמודה, בכרטיסייה Schema לוחצים על Remove ליד המונח.
אופציונלי: מציינים את הסיבה לשינוי.
לוחצים על שליחה לבדיקה.

REST

כדי לבקש למחוק קישור בין מונח במילון לבין רשומה של נכס נתונים, משתמשים ב-method‏ entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryLinkRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

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

‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
‫LOCATION: האזור שבו נמצאת קבוצת הרשומות, למשל us-central1.
‫ENTRY_GROUP_ID: המזהה של קבוצת הרשומות ההורה.
‫ENTRY_LINK_ID: המזהה של קישור הרשומה שרוצים למחוק.
‫JUSTIFICATION: הסבר למה אתם מציעים את השינוי.

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

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

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

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

בקשת שינויים בקטגוריה של מילון מונחים

יצירת קטגוריה

המסוף

REST

עדכון קטגוריה

המסוף

REST

מחיקת קטגוריה

המסוף

REST

בקשת שינויים במונח במילון

יצירת מונח במילון

המסוף

REST

עדכון מונח במילון

המסוף

REST

מחיקת מונח במילון

המסוף

REST

בקשת שינויים ברשומה

יצירת דף

המסוף

REST

עדכון רשומה

המסוף

REST

מחיקת רשומה

המסוף

REST

עדכון היבט

המסוף

REST

יצירת קישור כניסה

המסוף

REST

מחיקת קישור לרשומה

המסוף

REST

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

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