ניהול מילון המונחים הארגוני

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

תרחישי שימוש במילון המונחים הארגוני של Dataplex Universal Catalog

יצירת שפה משותפת לנתונים באמצעות מילון המונחים הארגוני של Dataplex Universal Catalog מאפשרת לכם:

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

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

רכיבים של מילון המונחים הארגוני

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

מילון מונחים

למילון מונחים יש את המאפיינים הבאים:

• סקירה כללית. מתאר את המטרה והתוכן של מילון המונחים הארגוני. אפשר להוסיף תמונות, קישורים וטבלאות. אין תמיכה בעיצוב HTML, אבל אפשר לכלול קוד HTML שמעוצב כקוד או להוסיף קישור לדף HTML. אפשר גם להשתמש באפשרויות עיצוב של Rich Text, כמו הדגשה, הטיה, קו תחתון, רשימות עם תבליטים, פסקאות, כותרות ובלוקים של קוד. הגודל המקסימלי שנתמך הוא 120KB.

• תיאור. תיאור המילון. הטקסט בשדה הזה עובר אינדוקס לחיפוש. הגודל המקסימלי שנתמך הוא 1KB.

• אזור. מציינים את האזור שבו נמצא המילון.

קטגוריה

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

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

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

האזור של קטגוריה זהה לאזור של המילון שמכיל אותה.

מונח

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

למונח יש את המאפיינים של קטגוריה, וגם את המאפיינים הבאים:

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

האזור של מונח זהה לאזור של המילון שמכיל אותו.

מילים נרדפות

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

מונחים קשורים

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

מגבלות

• אין תמיכה במילון המונחים הארגוני של Dataplex Universal Catalog בפרויקטים של Assured Workload.
• מילוני מונחים עסקיים מאוחסנים בתוך פרויקטים ומיקומים. המגבלות על פרויקטים ומיקומים חלות גם על מילוני מונחים.

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

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

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

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

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

ההרשאות הנדרשות

כדי ליצור ולנהל מילוני מונחים, צריך את ההרשאות הבאות:

• יצירה, קריאה, עדכון ומחיקה של מילון המונחים הארגוני, קטגוריה ומונחים בפרויקט:
  • dataplex.glossaries.list
  • dataplex.glossaries.create
  • dataplex.glossaries.get
  • dataplex.glossaries.update
  • dataplex.glossaries.delete
  • dataplex.glossaryCategories.create
  • dataplex.glossaryCategories.list
  • dataplex.glossaryCategories.get
  • dataplex.glossaryCategories.update
  • dataplex.glossaryCategories.delete
  • dataplex.glossaryTerms.create
  • dataplex.glossaryTerms.list
  • dataplex.glossaryTerms.get
  • dataplex.glossaryTerms.update
  • dataplex.glossaryTerms.delete
• כדי ליצור, לחפש ולמחוק קישורים בין מונחים נרדפים בפרויקט:
  • dataplex.entryLinks.create בקבוצת הרשומות של Dataplex Universal Catalog בפרויקט שבו מופיע אחד ממונחי מילון המונחים. הקישור נוצר בקבוצת הרשומות שעבורה ניתנה ההרשאה.
  • dataplex.entryGroups.useSynonymEntryLink בקבוצת הרשומות של Dataplex Universal Catalog בפרויקט שבו מופיע אחד ממונחי מילון המונחים. הקישור נוצר בקבוצת הרשומות שעבורה ניתנה ההרשאה.
  • dataplex.glossaryTerms.use במילוני המונחים שצריך לשייך אליהם את המונחים.
  • ‫ dataplex.glossaryTerms.get על המונח שאתם מחפשים את הקישורים למילים הנרדפות שלו. אם אין לכם הרשאה dataplex.glossaryTerms.get למונחים מסוימים, המונחים הנרדפים האלה יוסתרו בתגובה של Dataplex Universal Catalog.
  • dataplex.entryLinks.delete בקבוצת הרשומות Dataplex Universal Catalog בפרויקט שבו הקישור נמצא.
• יצירה, חיפוש ומחיקה של קישורים בין מונחים קשורים בפרויקט:
  • dataplex.entryLinks.create בקבוצת הרשומות של Dataplex Universal Catalog בפרויקט שבו מופיע אחד ממונחי מילון המונחים. הקישור נוצר בקבוצת הרשומות שעבורה ניתנה ההרשאה.
  • dataplex.entryGroups.useRelatedEntryLink בקבוצת הרשומות של Dataplex Universal Catalog בפרויקט שבו מופיע אחד ממונחי מילון המונחים. הקישור נוצר בקבוצת הרשומות שעבורה ניתנה ההרשאה.
  • dataplex.entries.link בקבוצת הרשומות של Dataplex Universal Catalog בפרויקטים שבהם יש רשומות שתואמות למונחים במילון.
  • dataplex.glossaryTerms.get על המונח שרוצים לחפש את הקישורים שקשורים אליו. אם אין לכם הרשאה מסוג dataplex.glossaryTerms.get למונחים מסוימים, המונחים האלה יוסתרו בתשובה של Dataplex Universal Catalog.
  • dataplex.entryLinks.delete בקבוצת הרשומות Dataplex Universal Catalog בפרויקט שבו הקישור נמצא.
• ליצור, לחפש ולמחוק קישורים בין מונחים לבין נכסי נתונים או עמודות בפרויקט:
  • dataplex.entryLinks.create בקבוצת רשומות המערכת שמתאימה לנכסי נתונים או לעמודות בפרויקט. הקישור נוצר בפרויקט שניתנה לו ההרשאה.
  • dataplex.entryGroups.useDefinitionEntryLink בקבוצת רשומות המערכת שמתאימה לנכסי נתונים או לעמודות בפרויקט. הקישור נוצר בפרויקט שניתנה לו הרשאה.
  • dataplex.entries.link בקבוצת רשומות המערכת שמתאימה לנכסי נתונים או לעמודות בפרויקט. הקישור נוצר בפרויקט שניתנה לו ההרשאה.
  • dataplex.glossaryTerms.use במאגר המונחים שצריך לשייך אליו את המונח.
  • Source system read permission (for example, bigquery.tables.get or dataplex.glossaryTerms.get) בפריט שאת הקישורים שלו מחפשים. אם אין לכם הרשאת קריאה במערכת המקור של נכסי נתונים מסוימים, הם יצונזרו בתגובה של Dataplex Universal Catalog.
  • dataplex.entryLinks.delete בקבוצת הרשומות של המערכת שבה מופיע הקישור.

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

למידע נוסף, תוכלו לקרוא על תפקידי IAM ב-Dataplex Universal Catalog.

יצירה וניהול של מילוני מונחים עסקיים

בקטעים הבאים מוסבר איך ליצור, לראות, לערוך ולמחוק מילון מונחים עסקי.

יצירת מילון המונחים הארגוני

המסוף

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

   מעבר אל Glossaries

2. לוחצים על יצירת מילון המונחים הארגוני.

3. בדף Create business glossary, מציינים שם ומיקום למילון המונחים הארגוני. אחרי שיוצרים את המילון, אי אפשר לשנות את המיקום שלו.

4. לוחצים על יצירה. המונחון נוצר בפרויקט הנוכחי.

5. אופציונלי: מוסיפים תיאור קצר בשדה תיאור (עד 1,024 תווים) או תיאור ארוך בשדה סקירה כללית (עד 120KB).

REST

כשיוצרים מילון מונחים, Dataplex Universal Catalog יוצר רשומה שמייצגת את מילון המונחים.

1. יוצרים את מילון המונחים.

   alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   
   gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID --data @- << EOF
   {
   "displayName": "DISPLAY_NAME",
   "description": "DESCRIPTION"
   }
   EOF

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

   • ‫PROJECT_ID: מזהה הפרויקט שבו רוצים ליצור את המילון
   • ‫LOCATION_ID: המזהה של המיקום שבו רוצים ליצור את המילון
   • ‫GLOSSARY_ID: המזהה של המילון
   • ‫DISPLAY_NAME: השם המוצג של המילון
   • ‫DESCRIPTION: תיאור המילון, עד 1,024 תווים

2. אופציונלי: מוסיפים סקירה כללית למילון המונחים.

   1. מחפשים את הערך במילון המונחים:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID
      \
      \&view=ALL

      מחליפים את PROJECT_NUMBER במספר הפרויקט שבו נוצר המילון.

   2. הוספת סקירה כללית למילון המונחים:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID\
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview \
      --data @- << EOF
      {
      "aspects": {
         "dataplex-types.global.overview": {
            "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/overview",
            "data": {
            "content": "OVERVIEW",
            "links": []
            },
         }
      }
      }
      EOF

      מחליפים את OVERVIEW בטקסט רגיל או ב-HTML כדי לתאר את הקטגוריה או המונח במילון המונחים.

צפייה במילוני המונחים הזמינים

המסוף

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

  מעבר אל Glossaries

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

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries

עריכת מילון מונחים

אפשר לערוך את השם והתיאור של מילון מונחים.

המסוף

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

   מעבר אל Glossaries

2. לוחצים על המילון שרוצים לערוך.

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

4. לוחצים על Save.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

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

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

המסוף

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

   מעבר אל Glossaries

2. לוחצים על המילון שרוצים למחוק.

3. לוחצים על מחיקה ומאשרים כשמופיעה בקשה.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID

יצירה וניהול של קטגוריות

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

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

במילון המונחים הארגוני יכולות להיות עד 200 קטגוריות.

המסוף

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

   מעבר אל Glossaries

2. בוחרים את המילון שבו רוצים ליצור קטגוריה, ואז לוחצים על יצירת קטגוריה.

3. מזינים שם לקטגוריה.

4. לוחצים על יצירה.

5. אופציונלי: מוסיפים תיאור קצר בשדה תיאור (עד 1,024 תווים) או תיאור ארוך בשדה סקירה כללית (עד 120KB).

REST

כשיוצרים קטגוריה, Dataplex Universal Catalog יוצר רשומה שמייצגת את הקטגוריה.

1. יוצרים את הקטגוריה.

   alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   
   gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
   {
   "displayName": "CATEGORY_DISPLAY_NAME",
   "description": "CATEGORY_DESCRIPTION",
   "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
   }
   EOF

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

   • ‫CATEGORY_ID: מזהה הקטגוריה
   • ‫CATEGORY_DISPLAY_NAME: השם המוצג של הקטגוריה
   • ‫CATEGORY_DESCRIPTION: תיאור הקטגוריה

2. אופציונלי: מוסיפים סקירה כללית לקטגוריה.

   1. מחפשים את הערך של הקטגוריה:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
      \
      \&view=ALL

   2. מוסיפים סקירה כללית לקטגוריה:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
      \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.overview": {
         "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
      ",
         "data": {
         "content": "OVERVIEW",
         "links": []
         },
      }
      }
      }
      EOF

      מחליפים את OVERVIEW בטקסט רגיל או ב-HTML כדי לתאר את הקטגוריה או המונח במילון המונחים.

3. אופציונלי: הוספת אנשי קשר

   1. מחפשים את הערך של הקטגוריה:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
      \
      \&view=ALL

   2. מעדכנים את הרשומה של הקטגוריה עם אנשי הקשר:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.contacts": {
         "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
         "data": {
         "identities": [
            {
               "role": "steward",
               "name": "CONTACT_NAME",
               "id": "CONTACT_EMAIL"
            }
         ]
         },
      }
      }
      }
      EOF

יצירת קטגוריה משנה

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

המסוף

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

   מעבר אל Glossaries

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

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

4. מזינים שם לקטגוריה.

5. לוחצים על יצירה.

6. אופציונלי: מוסיפים תיאור קצר בשדה תיאור (עד 1,024 תווים) או תיאור ארוך בשדה סקירה כללית (עד 120KB).

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
{
  "displayName": "CATEGORY_DISPLAY_NAME",
  "description": "CATEGORY_DESCRIPTION",
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
}
EOF

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

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

המסוף

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

   מעבר אל Glossaries

2. כדי לראות את הקטגוריות במילון מונחים, מרחיבים את מילון המונחים.

3. כדי להציג את הקטגוריות המשנה בקטגוריה, מרחיבים את הקטגוריה.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories

עריכת קטגוריה

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

המסוף

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

   מעבר אל Glossaries

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

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

4. לוחצים על Save.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "CATEGORY_DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

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

המסוף

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

   מעבר אל Glossaries

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

3. לוחצים על מחיקה ומאשרים כשמופיעה בקשה.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID

יצירה וניהול של מונחים

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

יצירת מונח במילון המונחים הארגוני

מילון המונחים הארגוני יכול להכיל עד 5,000 מונחים.

המסוף

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

   מעבר אל Glossaries

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

3. מזינים שם למונח.

4. לוחצים על יצירה.

5. אופציונלי: מוסיפים תיאור קצר בשדה תיאור (עד 1,024 תווים) או תיאור ארוך בשדה סקירה כללית (עד 120KB).

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

REST

כשיוצרים מונח, Dataplex Universal Catalog יוצר רשומה שמייצגת את המונח.

1. יוצרים את המונח.

   alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   
   gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
   {
   "displayName": "TERM_DISPLAY_NAME",
   "description": "TERM_DESCRIPTION",
   "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
   }
   EOF

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

   • ‫TERM_ID: המזהה של התנאי שאתם יוצרים
   • ‫TERM_DISPLAY_NAME: השם המוצג של המונח שאתם יוצרים
   • ‫TERM_DESCRIPTION: התיאור של המונח שיוצרים

2. אופציונלי: מוסיפים סקירה כללית למונח.

   1. חפשו את הערך של המונח:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL

   2. מוסיפים סקירה כללית למונח:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
      \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.overview": {
         "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
      ",
         "data": {
         "content": "OVERVIEW",
         "links": []
         },
      }
      }
      }
      EOF

      מחליפים את OVERVIEW בטקסט רגיל או ב-HTML כדי לתאר את הקטגוריה או המונח במילון המונחים.

3. אופציונלי: מוסיפים אנשי קשר.

   1. חפשו את הערך של המונח:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL

   2. מעדכנים את הערך של המונח עם אנשי הקשר:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.contacts": {
         "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
         "data": {
         "identities": [
            {
               "role": "steward",
               "name": "CONTACT_NAME",
               "id": "CONTACT_EMAIL"
            }
         ]
         },
      }
      }
      }
      EOF

יצירת מונח בקטגוריה

המסוף

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

   מעבר אל Glossaries

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

3. מזינים שם למונח.

4. לוחצים על יצירה.

5. אופציונלי: מוסיפים תיאור קצר בשדה תיאור (עד 1,024 תווים) או תיאור ארוך בשדה סקירה כללית (עד 120KB).

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

REST

כשיוצרים מונח, Dataplex Universal Catalog יוצר רשומה שמייצגת את המונח.

1. יוצרים מונח.

   alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   
   gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
   {
   "displayName": "TERM_DISPLAY_NAME",
   "description": "TERM_DESCRIPTION",
   "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
   }
   EOF

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

   • ‫TERM_ID: המזהה של התנאי שאתם יוצרים
   • ‫TERM_DISPLAY_NAME: השם המוצג של המונח שאתם יוצרים
   • ‫TERM_DESCRIPTION: התיאור של המונח שיוצרים

2. אופציונלי: מוסיפים סקירה כללית למונח.

   1. חפשו את הערך של המונח:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL

   2. מוסיפים סקירה כללית למונח:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
      \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.overview": {
         "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
      ",
         "data": {
         "content": "OVERVIEW",
         "links": []
         },
      }
      }
      }
      EOF

      מחליפים את OVERVIEW בטקסט רגיל או ב-HTML כדי לתאר את הקטגוריה או המונח במילון המונחים.

3. אופציונלי: מוסיפים אנשי קשר.

   1. חפשו את הערך של המונח:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL

   2. מעדכנים את הערך של המונח עם אנשי הקשר:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.contacts": {
         "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
         "data": {
         "identities": [
            {
               "role": "steward",
               "name": "CONTACT_NAME",
               "id": "CONTACT_EMAIL"
            }
         ]
         },
      }
      }
      }
      EOF

הוספת היבט למונח

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

המסוף

1. נכנסים לדף Glossaries ב-Dataplex Universal Catalog במסוף Google Cloud .

   מעבר אל Glossaries

2. מרחיבים את המילון ולוחצים על המונח שרוצים להוסיף לו היבט.

3. בקטע מאפיינים, לוחצים על הוספה.

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

REST

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

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=aspects\&aspect_keys=ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID --data @- << EOF
{
 "aspects": {
   "ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID": {
     "aspect_type": "projects/ASPECT_PROJECT_ID/locations/ASPECT_LOCATION_ID/aspectTypes/ASPECT_TYPE_ID",
     "data": {
       "sensitivity": "HIGH",
       "data_owner": "[e-mail]"
     }
   }
 }
}
EOF

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

• ‫PROJECT_NUMBER: מספר הפרויקט שמכיל את המונח במילון המונחים.
• ‫LOCATION_ID: המיקום של המונח במילון המונחים.
• ‫GLOSSARY_ID: המזהה של המילון שמכיל את המונח.
• ‫TERM_ID: המזהה של המונח שאליו רוצים לצרף את ההיבט.
• ‫ASPECT_PROJECT_ID: מזהה הפרויקט שמכיל את סוג ההיבט.
• ‫ASPECT_LOCATION_ID: המיקום של סוג ההיבט.
• ‫ASPECT_TYPE_ID: מזהה סוג ההיבט.

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

המסוף

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

   מעבר אל Glossaries

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

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms

הצגת הפרטים של מונח

המסוף

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

   מעבר אל Glossaries

2. כדי לראות את רשימת המונחים במילון מונחים, מרחיבים את מילון המונחים.

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

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

עריכת מונח

אפשר לערוך את השם, התיאור, הסקירה הכללית, אנשי הקשר וההורה של מונח.

המסוף

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

הוספת היבט למונח

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

המסוף

1. נכנסים לדף Glossaries ב-Dataplex Universal Catalog במסוף Google Cloud .

   מעבר אל Glossaries

2. מרחיבים את המילון ולוחצים על המונח שרוצים להוסיף לו היבט.

3. בקטע מאפיינים, לוחצים על הוספה.

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

REST

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

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=aspects\&aspect_keys=ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID --data @- << EOF
{
 "aspects": {
   "ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID": {
     "aspect_type": "projects/ASPECT_PROJECT_ID/locations/ASPECT_LOCATION_ID/aspectTypes/ASPECT_TYPE_ID",
     "data": {
       "sensitivity": "HIGH",
       "data_owner": "[e-mail]"
     }
   }
 }
}
EOF

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

• ‫PROJECT_NUMBER: מספר הפרויקט שמכיל את המונח במילון המונחים.
• ‫LOCATION_ID: המיקום של המונח במילון המונחים.
• ‫GLOSSARY_ID: המזהה של המילון שמכיל את המונח.
• ‫TERM_ID: המזהה של המונח שאליו רוצים לצרף את ההיבט.
• ‫ASPECT_PROJECT_ID: מזהה הפרויקט שמכיל את סוג ההיבט.
• ‫ASPECT_LOCATION_ID: המיקום של סוג ההיבט.
• ‫ASPECT_TYPE_ID: מזהה סוג ההיבט. מעבר אל Glossaries

1. מרחיבים את המילון ולוחצים על המונח שרוצים לערוך.

2. לוחצים על Edit.

3. עורכים את השדות ולוחצים על שמירה.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=displayName,description --data @- << EOF
{
  "displayName": "TERM_DISPLAY_NAME",
  "description": "TERM_DESCRIPTION"
}
EOF

מחיקת מונח

המסוף

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

   מעבר אל Glossaries

2. מרחיבים את המילון ולוחצים על המונח שרוצים למחוק.

3. לוחצים על מחיקה ומאשרים כשמופיעה בקשה.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

ניהול מילים נרדפות ומונחים קשורים

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

הקשרים בין המונחים הם דו-כיווניים. לדוגמה, כשמקשרים את profit כמילה נרדפת של earnings, ‏ earnings הופכת גם היא למילה נרדפת של profit.

יצירת קישורים בין מונחים נרדפים

המסוף

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

   מעבר אל Glossaries

2. מרחיבים את המילון ולוחצים על המונח שרוצים ליצור ממנו קישורים.

3. לוחצים על עריכה לצד מונחים נרדפים.

4. מחפשים את המונחים שרוצים לקשר ובוחרים אותם.

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

5. לוחצים על Close.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

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

• ‫TERM1_PROJECT_NUMBER: מספר הפרויקט של התקופה הראשונה שמקשרים.
• ‫TERM1_LOCATION_ID: מזהה המיקום של המילון שמכיל את המונח הראשון.
• ‫TERM1_GLOSSARY_ID: המזהה של המילון שמכיל את המונח הראשון.
• ‫TERM1_ID: המזהה של התקופה הראשונה.
• ‫TERM2_PROJECT_NUMBER: מספר הפרויקט של המונח השני שרוצים לקשר אליו בתור מונח נרדף. אם שני התנאים נמצאים באותו פרויקט, הערך הזה זהה למספר הפרויקט של התנאי הראשון.
• ‫TERM2_LOCATION_ID: מזהה המיקום של המילון שמכיל את המונח השני. אם שני המונחים נמצאים באותו מיקום, הערך הזה זהה למזהה המיקום של המונח הראשון.
• ‫TERM2_GLOSSARY_ID: המזהה של המילון שמכיל את המונח השני. אם שני המונחים מופיעים באותו מילון מונחים, הערך הזה זהה למזהה מילון המונחים של המונח הראשון.
• ‫TERM2_ID: המזהה של התקופה השנייה.
• ‫ENTRY_LINK_ID: מזהה של הקישור בין שני המונחים. כל מונח מיוצג כרשומה ב-Dataplex Universal Catalog. קישור הערך הוא הקשר בין מונחים נרדפים.

יצירת קישורים קשורים בין מונחים

המסוף

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

   מעבר אל Glossaries

2. מרחיבים את המילון ולוחצים על המונח שרוצים ליצור ממנו קישורים.

3. לוחצים על עריכה לצד מונחים קשורים.

4. מחפשים את המונחים שרוצים לקשר ובוחרים אותם.

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

5. לוחצים על Close.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/related",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

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

• ‫TERM1_PROJECT_NUMBER: מספר הפרויקט של התקופה הראשונה שמקשרים.
• ‫TERM1_LOCATION_ID: מזהה המיקום של המילון שמכיל את המונח הראשון.
• ‫TERM1_GLOSSARY_ID: המזהה של המילון שמכיל את המונח הראשון.
• ‫TERM1_ID: המזהה של התקופה הראשונה.
• ‫TERM2_PROJECT_NUMBER: מספר הפרויקט של התקופה השנייה שרוצים לקשר אליה כאל תקופה קשורה. אם שני המונחים נמצאים באותו פרויקט, הערך הזה זהה למספר הפרויקט של המונח הראשון.
• ‫TERM2_LOCATION_ID: מזהה המיקום של המילון שמכיל את המונח השני. אם שני המונחים נמצאים באותו מיקום, הערך הזה זהה למזהה המיקום של המונח הראשון.
• ‫TERM2_GLOSSARY_ID: המזהה של המילון שמכיל את המונח השני. אם שני המונחים מופיעים באותו מילון מונחים, הערך הזה זהה למזהה מילון המונחים של המונח הראשון.
• ‫TERM2_ID: המזהה של התקופה השנייה.
• ‫ENTRY_LINK_ID: מזהה של הקישור בין שני המונחים. כל מונח מיוצג כרשומה ב-Dataplex Universal Catalog. קישור הערך הוא הקשר בין מונחים קשורים.

חיפוש קישורים למילים נרדפות למונח

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM_PROJECT_ID/locations/SYNONYM_LINKS_LOCATION_ID:lookupEntryLinks?entry=projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/synonym&page_size=10

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

• ‫TERM_PROJECT_ID: מזהה הפרויקט של המונח שאתם מחפשים את הקישורים למילים הנרדפות שלו.
• ‫TERM_PROJECT_NUMBER: מספר הפרויקט של המונח שאת הקישורים למילים הנרדפות שלו מחפשים.
• ‫SYNONYM_LINKS_LOCATION_ID: מזהה המיקום שבו מחפשים את הקישורים למילים נרדפות.
• ‫TERM_LOCATION_ID: מזהה המיקום של המונח.
• ‫TERM_GLOSSARY_ID: המזהה של המילון שמכיל את המונח.
• ‫TERM_ID: המזהה של המונח.

הערה: כדי לאחזר דפים נוספים, צריך להוסיף את המחרוזת &page_token=PAGE_TOKEN לבקשה. מחליפים את PAGE_TOKEN בערך של טוקן הדף שקיבלתם מהתשובה הקודמת של lookupEntryLinks.

חיפוש קישורים שקשורים למונח

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM_PROJECT_ID/locations/RELATED_LINKS_LOCATION_ID:lookupEntryLinks?entry=projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/related&page_size=10

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

• ‫TERM_PROJECT_ID: מזהה הפרויקט של המונח שאתם מחפשים את הקישורים שקשורים אליו.
• ‫TERM_PROJECT_NUMBER: מספר הפרויקט של המונח שאת הקישורים הרלוונטיים שלו אתם מחפשים.
• ‫RELATED_LINKS_LOCATION_ID: מזהה המיקום שבו מחפשים את הקישורים הרלוונטיים.
• ‫TERM_LOCATION_ID: מזהה המיקום של המונח.
• ‫TERM_GLOSSARY_ID: המזהה של המילון שמכיל את המונח.
• ‫TERM_ID: המזהה של המונח.

הערה: כדי לאחזר דפים נוספים, צריך להוסיף את המחרוזת &page_token=PAGE_TOKEN לבקשה. מחליפים את PAGE_TOKEN בערך של טוקן הדף שקיבלתם מהתשובה הקודמת של lookupEntryLinks.

הסרת קישורים בין מילים נרדפות לבין מונחים קשורים

המסוף

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

   מעבר אל Glossaries

2. מרחיבים את המילון ולחצים על המונח שרוצים להסיר ממנו מילים נרדפות או מונחים קשורים.

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

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

REST

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

2. כדי למחוק את הקישור, שולחים את הבקשה הבאה DELETE:

   alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   
   gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

ניהול הקישורים בין מונחים לבין נכסי נתונים

אפשר לצרף תנאים לנכסי נתונים או לעמודות של נכסי נתונים. לדוגמה, אפשר לצרף תנאים למערך נתונים ב-BigQuery.

צירוף תנאים לנכס נתונים

המסוף

1. במסוף Google Cloud , עוברים לדף Search של Dataplex Universal Catalog.

   לחיפוש Google

2. מחפשים את נכס הנתונים (למשל מערך נתונים, קובץ או טבלה) שרוצים לקשר אליו את המונח, ואז לוחצים עליו.

3. בדף של נכס הנתונים, מבצעים אחת מהפעולות הבאות:

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

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
  "entry_references": [{
     "name": "projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
     "type": "SOURCE"
  }, {
     "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
     "type": "TARGET"
  }
  ]
}
EOF
)"

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

• ‫PROJECT_NUMBER: מספר הפרויקט של נכס הנתונים שמקשרים אליו
• ‫ENTRY_LOCATION_ID: מזהה המיקום של נכס הנתונים שמקשרים אליו
• ENTRY_GROUP_ID: קבוצת הרשומות של נכס הנתונים שמקושר
• ‫ENTRY_LINK_ID: מזהה לקישור בין המונח לבין הרשומה ב-Dataplex Universal Catalog שמייצגת את נכס הנתונים.
• ‫TERM_PROJECT_NUMBER: מספר הפרויקט של התקופה שמקשרים.

צירוף מונחים לעמודה בסכימת רשומות

המסוף

1. במסוף Google Cloud , עוברים לדף Search של Dataplex Universal Catalog.

   לחיפוש Google

2. מחפשים את נכס הנתונים (כמו מערך נתונים, קובץ או טבלה) שיש לו סכימה עם עמודה שרוצים לקשר אליה מונח. לוחצים על נכס הנתונים.

3. בדף של נכס הנתונים, מבצעים אחת מהפעולות הבאות:

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

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
"entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
"entry_references": [{
  "name": "projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
  "type": "SOURCE",
  "path": "Schema.COLUMN_NAME",
}, {
  "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
  "type": "TARGET"
}
]
}
EOF
)"

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

• ‫PROJECT_NUMBER: מספר הפרויקט של נכס הנתונים שמקושר
• ‫ENTRY_LOCATION_ID: מזהה המיקום של נכס הנתונים שמקשרים אליו
• ENTRY_GROUP_ID: קבוצת הרשומות של נכס הנתונים שמקושר
• ‫ENTRY_LINK_ID: מזהה של הקישור בין המונח לבין הרשומה ב-Dataplex Universal Catalog שמייצגת את נכס הנתונים
• ‫TERM_PROJECT_NUMBER: מספר הפרויקט של התקופה שמקשרים
• ‫COLUMN_NAME: העמודה שאליה רוצים לצרף את המונח

חיפוש נכסי נתונים שמקושרים למונח

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM_PROJECT_ID/locations/DEFINITION_LINKS_LOCATION_ID:lookupEntryLinks?entry=projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/definition&entry_mode=TARGET&page_size=10

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

• ‫TERM_PROJECT_ID: מזהה הפרויקט של המונח שאתם מחפשים את ההגדרה שלו.
• ‫TERM_PROJECT_NUMBER: מספר הפרויקט של המונח שאתם מחפשים את הקישורים להגדרה שלו.
• ‫DEFINITION_LINKS_LOCATION_ID: מזהה המיקום שבו מחפשים את קישורי ההגדרה.
• ‫TERM_LOCATION_ID: מזהה המיקום של המונח.
• ‫TERM_GLOSSARY_ID: המזהה של המילון שמכיל את המונח.
• ‫TERM_ID: המזהה של המונח.

הערה: עמודות שמקושרות למונח מוחזרות בשדה path.

כדי לאחזר דפים נוספים, מוסיפים את המחרוזת &page_token=PAGE_TOKEN לבקשה. מחליפים את PAGE_TOKEN בערך של טוקן הדף שקיבלתם מהתשובה הקודמת של lookupEntryLinks.

חיפוש מונחים שמקושרים לנכס נתונים

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/DEFINITION_LINKS_LOCATION_ID:lookupEntryLinks?entry=projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/definition&entry_mode=SOURCE&page_size=10

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

• ‫PROJECT_ID: מזהה הפרויקט של נכס הנתונים שאתם מחפשים את ההגדרות שלו.
• ‫: מספר הפרויקט של נכס הנתונים שאתם מחפשים את הקישורים להגדרה שלו.PROJECT_NUMBER
• ‫DEFINITION_LINKS_LOCATION_ID: מזהה המיקום שבו מחפשים את קישורי ההגדרה.
• ‫ENTRY_LOCATION_ID: מזהה המיקום של נכס המידע.
• ‫ENTRY_GROUP_ID: המזהה של קבוצת הרשומות של נכס הנתונים.
• ‫ENTRY_ID: המזהה של נכס הנתונים.

הערה: עמודות שמקושרות למונח בנכס נתונים מוחזרות בשדה path.

כדי לשלוף דפים נוספים, מוסיפים את המחרוזת &page_token=PAGE_TOKEN לבקשה. מחליפים את PAGE_TOKEN בערך של טוקן הדף שקיבלתם מהתשובה הקודמת של lookupEntryLinks.

הסרת מונחים מנכס נתונים

המסוף

1. במסוף Google Cloud , עוברים לדף Search של Dataplex Universal Catalog.

   לחיפוש Google

2. מחפשים את נכס הנתונים (למשל מערך נתונים, קובץ או טבלה) שרוצים להסיר ממנו את התנאים ולוחצים עליו.

3. בדף של נכס הנתונים, מבצעים אחת מהפעולות הבאות:

   • כדי להסיר מונח מנכס, בכרטיסייה פרטים, בקטע מונחי מילון מונחים, לוחצים על המונח. ואז לוחצים על .
   • כדי להסיר מונח מעמודה, בכרטיסייה סכימה לוחצים על לצד המונח.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/ENTRY_PROJECT_ID/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

חיפוש מילוני מונחים, מונחים ונכסי נתונים מקושרים

המסוף

כדי לנווט בתוכן של מילון המונחים העסקי, משתמשים בעץ של מילון המונחים והמונחים בדף מילוני מונחים.

1. נכנסים לדף Glossaries במסוף Google Cloud Dataplex Universal Catalog.

   מעבר אל Glossaries

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

   • ‫Name: מחזירה את המילונים, הקטגוריות והמונחים שהשם שלהם מכיל את הטקסט שאתם מספקים.
   • Parent: מחזירה את המונחים שהשם או התיאור של המונח הראשי שלהם במילון המונחים תואמים לטקסט שסיפקתם. לדוגמה, parent:Finance מחזירה את המונחים שמקושרים למילון המונחים הראשי ששמו או התיאור שלו מכילים את הביטוי Finance.
   • מילה נרדפת: מחזירה את רשימת המונחים עם מילה נרדפת שהשם או המזהה שלהם מכילים את הטקסט שסיפקתם. לדוגמה, הפונקציה synonym:Profit מחזירה את המונחים שיש להם מונח נרדף שהשם או המזהה שלו מכילים את הביטוי profit.
   • Contact: מחזירה את המונחים שבהם מנהל הנתונים מופיע כאיש קשר. לדוגמה, contact:[e-mail] מחזירה את הרשומות שמקושרות למונחים עם בעלי הרשאה לניהול נתונים שתואמים ל[e-mail].

REST

כדי למצוא מילונים, מונחים ונכסי נתונים מקושרים באמצעות API בארכיטקטורת REST, צריך להירשם לגרסת Preview.

חיפוש נכסי נתונים שמקושרים למונחים

המסוף

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

   מעבר אל Glossaries

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

3. לוחצים על מונח תואם.

4. בדף פרטי המונח אפשר לראות את המונחים המקושרים (מילים נרדפות ומונחים קשורים) ואת הרשומות המקושרות (נכסי נתונים) למונח הזה.

5. כדי לראות את הפרטים של רשומה ב-Dataplex Universal Catalog, לוחצים על הרשומה.

REST

כדי למצוא מילונים, מונחים ונכסי נתונים מקושרים באמצעות API בארכיטקטורת REST, צריך להירשם לגרסת Preview.

ייבוא מילונים וקישורים בין מונחים או בין נכסי נתונים

כדי לייבא מילונים וקישורים מכלי קטלוג אחר או לעדכן את המילונים ב-Dataplex Universal Catalog, אפשר לייבא בכמות גדולה מילונים, קטגוריות, מונחים, קישורים בין מונחים, קישורים בין מונחים לבין נכסי נתונים או עמודות באמצעות API בארכיטקטורת REST.

1. יוצרים את מילון המונחים של היעד.

   REST

   alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   
   gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID -d "$(cat<<EOF
   
   {
    "displayName": "DISPLAY_NAME",
    "description": "DESCRIPTION"
   }
   EOF
   )"

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

   • ‫PROJECT_ID: מזהה הפרויקט שבו יוצרים את המילון
   • ‫LOCATION_ID: המיקום שבו רוצים ליצור את המילון
   • ‫GLOSSARY_ID: מזהה המילון
   • ‫DISPLAY_NAME: השם המוצג של המילון
   • ‫DESCRIPTION: תיאור המילון

2. כדי לייבא קטגוריות, מונחים וקישורים בין מונחים לבין נכסי נתונים במילון המונחים שנוצר, מעלים קבצים לכל אחד מהפריטים האלה לקטגוריה של Cloud Storage. הקבצים האלה הם בפורמט הבא:

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

      {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-category","aspects":{"dataplex-types.global.glossary-category-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","displayName":"CATEGORY_NAME","description":"CATEGORY_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"}]}}}
      {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","displayName":"TERM1_DISPLAY_NAME","description":"TERM1_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}
      {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","displayName":"TERM2_DISPLAY_NAME","description":"TERM2_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}
      

   • דוגמה לפורמט של קישורים בין מונחים

      {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/synonym","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}
      {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-2f7408e3-af3d-405d-81bb-861cf9ec5146","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/related","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}
      

   • פורמט לדוגמה של קישורים בין מונחים לנכסי נתונים

      projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1 and term projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1
      {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/definition","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1"}]}}
      

   # Set GCURL alias
   alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   
   gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
   {
     "type":"IMPORT",
     "import_spec":{
        "log_level":"DEBUG",
        "source_storage_uri":"gs://STORAGE_BUCKET/",
        "entry_sync_mode":"FULL",
        "aspect_sync_mode":"INCREMENTAL",
        "scope":{
           "glossaries": "GLOSSARY_NAME"
        }
     }
   }
   EOF
   )"

   מחליפים את DATAPLEX_API בנקודת קצה ל-API של Dataplex Universal Catalog בפורמט dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

3. אופציונלי: קבלת הסטטוס של הפעולה.

   gcurl https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/operation-OPERATION_ID

   מחליפים את OPERATION_ID במזהה הפעולה.

4. אופציונלי: קבלת הסטטוס של משימת המטא-נתונים.

   gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/metadataJobs/JOB_ID

5. ייבוא קישורים בין מונחים כמילים נרדפות או כמונחים קשורים.

   gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
   {
     "type":"IMPORT",
     "import_spec":{
        "log_level":"DEBUG",
        "source_storage_uri":"gs://STORAGE_BUCKET/",
        "entry_sync_mode":"FULL",
        "aspect_sync_mode":"INCREMENTAL",
        "scope":{
           "entry_groups":[  "projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/@dataplex"
           ],
           "entry_link_types":[
              "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
              "projects/dataplex-types/locations/global/entryLinkTypes/related"
           ],
           "referenced_entry_scopes":[
              "PROJECT_IDS"
           ]
        }
     }
   }
   EOF
   )"

   מחליפים את DATAPLEX_API ב-dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

6. ייבוא קישורים בין מונחים לבין נכסי נתונים או עמודות.

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

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

   gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
   {
   "type":"IMPORT",
   "import_spec":{
     "log_level":"DEBUG",
     "source_storage_uri":"gs://STORAGE_BUCKET/",
     "entry_sync_mode":"FULL",
     "aspect_sync_mode":"INCREMENTAL",
     "scope":{
        "entry_groups":[  "projects/PROJECT_ID/locations/ENTRY_GROUP_LOCATION_ID/entryGroups/@dataplex"
        ],
        "entry_link_types":[
           "projects/dataplex-types/locations/global/entryLinkTypes/definition"
        ],
        "referenced_entry_scopes":[
           "PROJECT_IDS"
        ]
     }
   }
   }
   EOF
   )"

   מחליפים את DATAPLEX_API ב-dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

תמחור

החל מיולי 2026, יחול חיוב על מילון המונחים הארגוני של Dataplex Universal Catalog, בדומה לתמחור של אחסון מטא-נתונים. תמחור אחסון המטא-נתונים ב-Dataplex Universal Catalog

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

• אם אתם משתמשים בגרסת טרום-השקה (Preview) של מילון המונחים הארגוני ב-Data Catalog, כדאי לעיין במאמר בנושא מעבר למילון המונחים הארגוני ב-Dataplex Universal Catalog.
• פועלים לפי Codelab: ניהול הרשאות גישה בסיסי באמצעות Dataplex Universal Catalog.