היבטים וסוגי היבטים ב-Knowledge Catalog (לשעבר Dataplex Universal Catalog) מאפשרים להוסיף מטא-נתונים מובְנים לרשומות, לעמודות ולקישורים של רשומות כדי לתאר את נכסי הנתונים ואת הקשרים ביניהם. ההקשר הזה משפר את יכולת הגילוי של הנתונים ועוזר לסווג מידע רגיש, כמו פרטים אישיים מזהים (PII), כדי להחיל מדיניות גישה או מדיניות איכות נתונים.
במאמר מידע על היבטים וסוגי היבטים מוסבר על סכימות של היבטים, סוגי היבטים של המערכת לעומת סוגי היבטים בהתאמה אישית, רמות יעד ומגבלות על מיקום אחסון הנתונים. לסקירה כללית על הארכיטקטורה של המטא-מודל של המטא-נתונים, קראו את המאמר מידע על מטא-נתונים ב-Knowledge Catalog. אם זו הפעם הראשונה שאתם עובדים עם מטא-נתונים של Knowledge Catalog, כדאי לעיין במדריכים למתחילים הוספת מטא-נתונים לטבלה ב-BigQuery או יצירה ושימוש במילון המונחים הארגוני.
לפני שמתחילים
לפני שיוצרים ומנהלים סוגי היבטים והיבטים, צריך לבצע את המשימות שמתוארות בקטע הזה.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות ליצירה ולניהול של היבטים וסוגי היבטים, בקשו מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט. אתם לא צריכים את כל התפקידים האלה בו-זמנית. בחרו את התפקיד או את שילוב התפקידים שמתאים לתהליך העבודה הספציפי שלכם:
כדי לקבל את ההרשאות שדרושות ליצירה ולניהול של היבטים וסוגי היבטים, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM בפרויקט:
-
כדי לנהל את כל המשאבים בקטלוג, כולל סוגי היבטים ורשומות, עם הרשאות אדמין נרחבות: אדמין של Dataplex Catalog (
roles/dataplex.catalogAdmin) או עריכה של Dataplex Catalog (roles/dataplex.catalogEditor) -
כדי ליצור ולנהל רק סוגי היבטים בהתאמה אישית, עם הרשאות גישה מינימליות לאדמינים של סוגי היבטים:
Dataplex Aspect Type Owner (
roles/dataplex.aspectTypeOwner) -
כדי להשתמש בסוגי היבטים כשיוצרים או משנים רשומות, עם גישה בהרשאות מינימליות לאוצרי נתונים:
משתמש בסוג היבט של Dataplex (
roles/dataplex.aspectTypeUser) -
כדי לצרף סוגי היבטים של מערכת לשימוש חוזר, כמו
schema,contactsו-overview, לרשומות ולקישורים לרשומות: הבעלים של Dataplex Entry ו-EntryLink (roles/dataplex.entryOwner) -
כדי לצפות בסוגי ההיבטים ובמדיניות ה-IAM שלהם בלי לשנות אותם:
צפייה ב-Dataplex Catalog (
roles/dataplex.catalogViewer)
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה מכילים את ההרשאות שנדרשות כדי ליצור ולנהל היבטים וסוגי היבטים. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי ליצור ולנהל היבטים וסוגי היבטים, נדרשות ההרשאות הבאות:
-
יצירה, הצגה, הצגה ברשימה, עדכון ומחיקה של סוגי היבטים:
-
dataplex.aspectTypes.create -
dataplex.aspectTypes.get -
dataplex.aspectTypes.list -
dataplex.aspectTypes.update -
dataplex.aspectTypes.delete
-
-
שימוש בסוגי היבטים כדי להעשיר את הרשומות:
dataplex.aspectTypes.use -
יצירה, הצגה, עדכון ומחיקה של רשומות וההיבטים שלהן:
-
dataplex.entries.create -
dataplex.entries.get -
dataplex.entries.list -
dataplex.entries.update -
dataplex.entries.delete
-
-
יצירה, הצגה, עדכון ומחיקה של קישורי רשומות וההיבטים שלהם:
-
dataplex.entryLinks.create -
dataplex.entryLinks.get -
dataplex.entryLinks.list -
dataplex.entryLinks.update -
dataplex.entryLinks.delete
-
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
מידע נוסף זמין במאמר תפקידי IAM ב-Knowledge Catalog.
הפעלת ה-API
מפעילים את Dataplex API בפרויקט של Knowledge Catalog. אם אתם משתמשים בפרויקט חדש ב- Google Cloud או בפרויקט שבו BigQuery API מופעל, Dataplex API מופעל כברירת מחדל.
יצירת סוג היבט בהתאמה אישית
המסוף
כדי ליצור סוג היבט בהתאמה אישית במסוף Google Cloud , מבצעים את הפעולות הבאות:
הגדרת פרטים בסיסיים:
במסוף Google Cloud , נכנסים לדף Metadata types ב-Knowledge Catalog.
לוחצים על הכרטיסייה Aspect types > Custom ואז על Create aspect type.
בקטע Details, מזינים את הפרטים הבאים:
- אופציונלי: Display name: שם ידידותי למשתמש של סוג ההיבט.
- Aspect type ID: מזהה ייחודי של סוג ההיבט.
- Description (אופציונלי): תיאור של סוג ההיבט והמטרה שלו.
- Location: בוחרים מיקום לסוג ההיבט. אי אפשר לשנות את המיקום אחרי שיוצרים את המרחב. במאמר סוגי היבטים בהתאמה אישית מוסבר על היתרונות והחסרונות של מיקום גלובלי לעומת מיקום אזורי.
הגדרת תבנית הסכימה:
התבנית מגדירה את הפורמט והסכימה של שדות המטא-נתונים שמקובצים בסוג ההיבט. אתם יכולים להגדיר שדות באופן ידני או להאיץ את יצירת הסכימה על ידי בחירת תבנית התחלתית מ-Template gallery, כמו Data Sensitivity, Data Governance או הטמעת נתונים. לדוגמה, אם בוחרים בתבנית Data Sensitivity, השדות הבוליאניים
Is Encryptedו-Has PIIושדה ה-enumPII Typeנוספים באופן אוטומטי.כדי להגדיר שדות באופן ידני:
- בקטע תבנית, לוחצים על הוספת שדה.
- בחלונית New field, מציינים את הפרטים הבאים:
- Name: מזהה של השדה.
- אופציונלי: שם תצוגה: תווית ידידותית למשתמש.
- אופציונלי: תיאור: תיאור קצר של השדה.
- סוג: בוחרים את סוג הנתונים של השדה. הסוגים הנתמכים כוללים טקסט, מספר שלם, ערך בוליאני, תאריך ושעה, מספר ממשי, טיפוס מנייה, מערך, מפה ורשומה.
- אופציונלי: חובה: מסמנים את התיבה הזו כדי להגדיר את השדה כשדה חובה כשהמשתמשים מצרפים את ההיבט הזה.
- לוחצים על סיום. כדי להוסיף עוד שדות, לוחצים על הוספת שדה וחוזרים על השלבים האלה.
מוסיפים תוויות למשאבים ושומרים:
תוויות של משאבים הן צמדי מפתח/ערך שרירותיים שעוזרים לארגן ולסנן את המשאבים ב- Google Cloud . לדוגמה, אתם יכולים לארגן משאבים לפי סביבה או בעלות של צוות באמצעות תוויות כמו
environment: productionאוteam: analytics.- בקטע תוויות, לוחצים על הוספת תווית.
- מזינים את המפתח ואת הערך של התווית.
- לוחצים על Save.
gcloud
כדי ליצור סוג היבט בהתאמה אישית, משתמשים בפקודה gcloud dataplex aspect-types
create.
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Go במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Ruby
Ruby
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Ruby במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Ruby API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
REST
כדי ליצור סוג היבט בהתאמה אישית, משתמשים ב-method aspectType.create.
אחרי שיוצרים סוג היבט בהתאמה אישית, אפשר להוסיף היבטים לרשומות.
דוגמה לשימוש בשדות "מזהה רשומה" ו"הפניה לרשומה"
אפשר להשתמש בשדות Record ID ו-Record reference להפניות רקורסיביות. בדוגמה הבאה אפשר לראות איך להשתמש בשדות האלה:
נניח שיש לכם סוג היבט שנקרא Employee, עם השדות הבאים:
- Name (סוג:
Text) - תאריך התחלה (סוג:
Date & time) - Designation (סוג:
Text) - הכתובת הנוכחית (סוג:
Record) - כתובת קבועה (סוג:
Record)
שני שדות הכתובת Current address ו-Permanent address הם מאותו סוג נתונים Record. כדי למנוע כפילויות, אפשר להגדיר את הערכים של מזהה הרשומה והפניה לרשומה כשמגדירים את השדות האלה.
כשמגדירים את השדה Current address, אפשר לציין את הערך address-field בשדה Record ID. בשדה Permanent address, אפשר לציין את אותו ערך (address-field) בשדה Record reference. לדוגמה:
- Name (סוג:
Text) - תאריך התחלה (סוג:
Date & time) - Designation (סוג:
Text) - הכתובת הנוכחית (סוג:
Record, מזהה רשומה:address-field) - כתובת קבועה (סוג:
Record, הפניה לרשומה:address-field)
כך לא תצטרכו לשכפל את השדות של כתובת אחרת.
הוספת היבטים לרשומה
אחרי שיוצרים סוג היבט בהתאמה אישית, אפשר ליצור היבטים מהסוג הזה. כדי להוסיף היבטים לרשומה, צריך לעדכן את הרשומה, כי ההיבטים מאוחסנים בתוך הרשומות.
שימו לב למגבלות הבאות:
- אפשר להוסיף היבטים לרשומה או לעמודות של רשומה.
- אפשר לערוך את ההיבטים הנדרשים רק ברשומות בהתאמה אישית. אי אפשר למחוק את ההיבטים הנדרשים.
- אתם יכולים לערוך ולמחוק את ההיבטים האופציונליים של רשומות בהתאמה אישית ושל רשומות מערכת.
- כשמחליפים או טוענים מחדש טבלה ב-BigQuery באמצעות הצהרת
CREATE OR REPLACE TABLE, הצהרתTRUNCATE TABLEאו משימתWRITE_TRUNCATE, ההיבטים של הרשומה שמצורפים למשתמש נשמרים ב-Knowledge Catalog. היבטים ברמת העמודה נשמרים גם בעמודות שנשארות בסכימה. עם זאת, אם אתם מסירים טבלה ויוצרים אותה מחדש באמצעות הצהרתDROP TABLEוהצהרתCREATE TABLE, Knowledge Catalog יוצר רשומה חדשה בלי ההיבטים שצורפו על ידי המשתמש בטבלה המקורית. כדי לשמור על ההיבטים כשמטעינים מחדש טבלה, משתמשים ב-CREATE OR REPLACE TABLE, ב-TRUNCATE TABLEאו ב-WRITE_TRUNCATE. לחלופין, אתם יכולים ליצור תצוגה ב-BigQuery ולצרף אליה היבטים.
המסוף
נכנסים לדף Search של Knowledge Catalog במסוף Google Cloud .
מחפשים את הרשומה שרוצים להוסיף לה היבטים ולוחצים עליה. דף הפרטים של הרשומה נפתח.
בדף הפרטים של הרשומה, לוחצים על הכרטיסייה Details.
בקטע היבטים, לוחצים על הוספה באזור היבטים נדרשים או היבטים אופציונליים. אפשר להוסיף היבטים נדרשים רק אם סוג הרשומה מגדיר היבטים נדרשים.
מחפשים את ההיבט שרוצים להוסיף ובוחרים אותו.
בחלון Add aspect, מזינים את הערכים בשדות.
לוחצים על Save.
כדי להוסיף היבטים לעמודה של הרשומה:
- בדף הפרטים של הרשומה, לוחצים על הכרטיסייה Schema.
- בוחרים את העמודות שרוצים להוסיף להן היבטים.
- לוחצים על הוספת היבט.
- מחפשים את ההיבט שרוצים להוסיף ובוחרים אותו.
- בחלון Add aspect, מזינים את הערכים בשדות.
- לוחצים על Save.
gcloud
כדי להוסיף היבטים לרשומה או לעמודה של רשומה, משתמשים בפקודה gcloud
dataplex entries update.
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
כדי להוסיף היבטים לאובייקט הרשומה, ראו היבטים.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Go במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
כדי להוסיף היבטים לאובייקט הרשומה, ראו רשומה.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Ruby
Ruby
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Ruby במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Ruby API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
כדי להוסיף היבטים לאובייקט הרשומה, ראו #required_aspects=.
REST
כדי להוסיף היבטים לרשומה או לעמודה של רשומה, משתמשים ב-method entry.patch.
אי אפשר ליצור היבטים ולהשתמש בהם ברשומה שבה סוג ההיבט והרשומה נמצאים בארגונים שונים ב- Google Cloud .
צירוף היבטים של סוגי היבטים של מערכת לשימוש חוזר
ב-Knowledge Catalog יש סוגי היבטים מוגדרים מראש של המערכת שאפשר לצרף לרשומות כדי לתעד מטא-נתונים סטנדרטיים. לדוגמה, אתם יכולים להשתמש בסוגי ההיבטים האלה כדי לתעד אנשי קשר של בעלים, הגדרות סכימה, מדדי שימוש ותוצאות של איכות נתונים.
כללים כלליים לגבי תהליך העבודה והמטען הייעודי (payload)
כשמצרפים היבטים של סוגי היבטים של מערכת לשימוש חוזר, צריך לפעול לפי הכללים הבאים:
- מסוף לעומת CLI או REST: בסוגי היבטים בלי שדות בתצוגת עץ, כמו
generic, אתם יכולים להשתמש במסוף Google Cloud , ב-CLI שלgcloudאו ב-API בארכיטקטורת REST. בסוגי היבטים עם מבנים מורכבים או בתצוגת עץ, כמוdata-quality-scorecard,contactsאוdata-profile, צריך להשתמש ב-CLI שלgcloudאו ב-API בארכיטקטורת REST. - מבנה המטען הייעודי (payload):
-
gcloudCLI: מעבירים את מפת ההיבטים ישירות, עם מפתח לפי המזהה הגלובלי של סוג ההיבט:{"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}}. - API בארכיטקטורת REST: עוטפים את מפת ההיבטים בתוך אובייקט מאגר
"aspects":{"aspects": {"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}}}.
-
- התנהגות של החלפה: עדכון של היבט מחליף את כל הנתונים הקיימים של סוג ההיבט הספציפי הזה ברשומה או בעמודה של היעד. הוא לא ממזג שדות.
בקטעים הבאים מופיעות דוגמאות וסכימות לצירוף היבטים נפוצים של מערכות לשימוש חוזר, החל מכרטיס המידע של איכות הנתונים.
כרטיס מידע על איכות הנתונים
כרטיס מידע על איכות הנתונים הוא היבט שמספק סיכום של איכות הנתונים, בדרך כלל על סמך סריקות של איכות הנתונים או תהליכים אחרים. אתם יכולים לצרף כרטיס מידע על איכות הנתונים לרשומה כדי לספק מידע מותאם אישית על איכות הנתונים. כדי לעשות את זה, צריך לצרף היבט של הסוג data-quality-scorecard שמוגדר במערכת.
השדה data בהיבט data-quality-scorecard יכול לכלול את השדות הבאים:
job: אופציונלי. רשומה שכוללת פרטים על המשימה שיצרה את כרטיס המידע.
name: שם המשאב של משימת בקרת איכות הנתונים.
runTime: זמן הריצה של משימת איכות הנתונים.
score: אופציונלי. ציון איכות הנתונים הכולל. הציון נע בין [0, 100].
status: שדה חובה. הסטטוס של כרטיס המידע על איכות הנתונים, שמציין אם הוא עבר או נכשל בסף האיכות (PASSאוFAIL).
dimensions: אופציונלי. מערך של תוצאות המאפיינים. כל תוצאה כוללת:
name: שם המאפיין. הערך יכול להיות אחד מהבאים:ACCURACY,COMPLETENESS,CONSISTENCY,FRESHNESS,UNIQUENESS,VALIDITYאוVOLUME, או שם של מאפיין מותאם אישית. השמות של המאפיינים המותאמים אישית צריכים להיות באורך של עד 30 תווים, וצריך להשתמש באותיות רישיות.
score: הציון הכולל ברמת המאפיין, בטווח שבין [0, 100].
status: הסטטוס של המאפיין, שמציין אם הוא עבר או נכשל בסף האיכות (PASSאוFAIL).
columns: אופציונלי. מערך של תוצאות בעמודות. כל תוצאה כוללת:
name: שם העמודה.
score: הציון הכולל ברמת העמודה, בטווח שבין [0, 100].
status: הסטטוס של העמודה, שמציין אם היא עברה או נכשלה בסף האיכות (PASSאוFAIL).dimensions: מערך של ציוני מאפיינים לעמודה. כל ציון של מאפיין כולל:
name: שם המאפיין.
score: הציון של המאפיין, בטווח שבין 0 ל-100.
status: הסטטוס של המאפיין בעמודה, שמציין אם הוא עבר או לא עבר את סף האיכות (PASS,FAIL,UNKNOWNאוNOT_APPLICABLE).
details(מפה אופציונלית): צמדי מפתח/ערך שמספקים הקשר נוסף לגבי ההערכה.
evaluatedAssetCount(מספר שלם אופציונלי): מספר הנכסים שנבדקו.
כשמריצים את הפקודה לצירוף היבט, היא מחליפה את כל הנתונים הקיימים של ההיבט הספציפי הזה. לדוגמה, אם מעדכנים כרטיס מידע עם הציון 80 באמצעות קובץ חדש עם הציון 90, הציון 80 יוחלף. הוא לא ממזג את הנתונים.
כדי לצרף כרטיס מידע על איכות הנתונים:
gcloud
כדי לעדכן היבטים של רשומה, משתמשים בפקודה gcloud dataplex entries
update-aspects.
יוצרים קובץ JSON (
dq-aspect.json) עם התוכן הבא.{ "dataplex-types.global.data-quality-scorecard": { "data": { "score": 80, "status": "PASS", "dimensions": [ { "name": "completeness", "score": 90, "status": "PASS" }, { "name": "uniqueness", "score": 70, "status": "FAIL" } ], "columns": [ { "name": "col1", "score": 85, "status": "PASS" } ] } } }מריצים את הפקודה הבאה:
gcloud dataplex entries update-aspects ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --aspects=dq-aspect.json
מחליפים את המשתנים הבאים:
-
ENTRY_ID: מזהה הרשומה, לדוגמה:example-entry -
LOCATION: המיקום של הרשומה, לדוגמהus-central1 -
ENTRY_GROUP_ID: המזהה של קבוצת הרשומות, לדוגמהexample-entry-group -
PROJECT_ID: מזהה הפרויקט, לדוגמה:example-project
-
REST
כדי לעדכן היבטים של רשומה, משתמשים ב-method entry.patch.
יוצרים קובץ בשם
payload.jsonומדביקים בו את תוכן ה-JSON מהבקשה.{ "aspects": { "dataplex-types.global.data-quality-scorecard": { "data": { "score": 80, "status": "PASS", "dimensions": [ { "name": "completeness", "score": 90, "status": "PASS" }, { "name": "uniqueness", "score": 70, "status": "FAIL" } ], "columns": [ { "name": "col1", "score": 85, "status": "PASS" } ] } } } }מריצים את הפקודה הזו בטרמינל:
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -d @payload.json \ "https://dataplex.googleapis.com/v1/projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>/entries/<var>ENTRY_ID</var>?updateMask=aspects"מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט, לדוגמהexample-project -
LOCATION: המיקום של הרשומה, לדוגמהus-central1 -
ENTRY_GROUP_ID: המזהה של קבוצת הרשומות, לדוגמהexample-entry-group -
ENTRY_ID: המזהה של הרשומה, לדוגמה:example-entry
-
סוגים אחרים של היבטים לשימוש חוזר
אפשר להשתמש גם בסוגי ההיבטים הבאים של המערכת כדי להעשיר את הרשומות. התקצירים האלה מפורטים בקטעים הבאים. אפשר ללחוץ על כל קטע שניתן להרחבה כדי לראות סכימות של שדות ודוגמאות למטענים ייעודיים (payloads) של JSON.
אנשי קשר (dataplex-types.global.contacts)
משתמשים בסוג המאפיין contacts כדי להקצות בעלות, ניהול או תפקידים תפעוליים לרשומות.
-
identities(מערך): רשימה של אנשי קשר. כל איש קשר כוללrole(לדוגמה,owner,steward,producerאוadmin),nameו-id(כתובת אימייל).
מטען ייעודי (payload) לדוגמה (API בארכיטקטורת REST):
{ "aspects": { "dataplex-types.global.contacts": { "data": { "identities": [ { "role": "steward", "name": "Jane Doe", "id": "jane.doe@example.com" } ] } } } }
פרופיל נתונים (dataplex-types.global.data-profile)
כדי לתעד תוצאות של פרופילים סטטיסטיים שנוצרו מסריקות של נתוני מקור, משתמשים בסוג ההיבט data-profile. מידע נוסף זמין במאמר מידע על יצירת פרופילים של נתונים.
-
sourceDataInfo(רשומה): מטא-נתונים על הסריקה, כוללscope(PREVIEW,SAMPLEDאוALL),scannedRowsו-samplingPercentage. -
fields(מפה): נתונים סטטיסטיים ברמת העמודה, כוללnullness,uniquenessומדדים ספציפיים לסוג של עמודות מספריות, מחרוזות, תאריך ושעה ומערכים.
מטען ייעודי (payload) לדוגמה (API בארכיטקטורת REST):
{ "aspects": { "dataplex-types.global.data-profile": { "data": { "sourceDataInfo": { "scope": "ALL", "scannedRows": 100 }, "fields": { "col1": { "nullness": 0.0, "uniqueness": 0.1, "string": { "length": { "min": 1, "max": 20, "avg": 12.54 } } } } } } } }
גנרי (dataplex-types.global.generic)
אפשר להשתמש בסוג ההיבט generic כדי לתעד מידע על רשומות בפורמט חופשי ומטא-נתונים של מערכת המקור, בלי להגדיר סכימת היבט בהתאמה אישית.
-
type(מחרוזת): מחרוזת קטגוריות של רשומות שהמשתמש ציין. -
system(מחרוזת): מזהה מערכת המקור של הרשומה בהתאמה אישית.
מטען ייעודי (payload) לדוגמה (API בארכיטקטורת REST):
{ "aspects": { "dataplex-types.global.generic": { "data": { "type": "custom-type", "system": "custom-system" } } } }
סקירה כללית (dataplex-types.global.overview)
משתמשים בסוג ההיבט overview כדי לספק תיעוד בטקסט עשיר שקריא לאנשים וקישורים חיצוניים מועילים.
content(מחרוזת): תיאור בטקסט עשיר שתומך בעיצוב HTML.links(מערך): מקורות מידע חיצוניים וקישורים למסמכי תיעוד, שכל אחד מהם מכיל אתurlו-title.
מטען ייעודי (payload) לדוגמה (API בארכיטקטורת REST):
{ "aspects": { "dataplex-types.global.overview": { "data": { "content": "This is a rich text description.", "links": [ { "url": "https://example.com", "title": "Example Link" } ] } } } }
סכימה (dataplex-types.global.schema)
משתמשים בסוג ההיבט schema כדי לתאר את הסכימה הטבלאית, שמות העמודות, המצבים וסוגי הנתונים של נכסי הנתונים.
-
fields(מערך): רשימת עמודות, שכל אחת מהן מכילה אתname,dataType,metadataType(כמוSTRING,BOOLEAN),mode(NULLABLE,REQUIRED,REPEATED), ואתdescriptionהאופציונלי.
מטען ייעודי (payload) לדוגמה (API בארכיטקטורת REST):
{ "aspects": { "dataplex-types.global.schema": { "data": { "fields": [ { "name": "id", "dataType": "string", "metadataType": "STRING", "mode": "REQUIRED" } ] } } } }
שימוש (dataplex-types.global.usage)
משתמשים בסוג ההיבט usage כדי לעקוב אחרי מדדי צריכה, מספר צפיות ומבני שאילתות בסדרות עתיות.
-
metrics(מערך): מדדי צריכה, שכל אחד מהם מכיל אתname(כמוviewsאוreads) ונקודות על הגרף שלtimeSeriesעם מרווחי צבירה וערכים. -
refreshTime(datetime): חותמת הזמן של החישוב האחרון של מדדי השימוש.
מטען ייעודי (payload) לדוגמה (API בארכיטקטורת REST):
{ "aspects": { "dataplex-types.global.usage": { "data": { "metrics": [ { "name": "views", "timeSeries": [ { "interval": "30d", "value": 100 } ] } ], "refreshTime": "2025-01-01T12:00:00Z" } } } }
יצירת קישור כניסה
אתם יכולים ליצור קשר בין שתי רשומות על ידי יצירת קישור לרשומה.
קישור כניסה יכול להיות סימטרי, כמו synonym, או אסימטרי, כמו definition.
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Go במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
REST
כדי ליצור קישור לרשומה עם ההיבט הנדרש, משתמשים ב-method entryLinks.create, וכוללים את נתוני ההיבט בגוף הבקשה.
הוספת היבטים לקישור של רשומה
כדי להעשיר את המטא-נתונים במידע על הקשרים בין הרשומות, מוסיפים היבטים לקישורים של הרשומות.
אתם יכולים להגדיר סוגים של קישורי כניסה שדורשים היבט ספציפי. כשיוצרים קישור כניסה מהסוג הזה, צריך לציין את ההיבט הנדרש.
אתם יכולים להוסיף את ההיבטים האלה כשאתם יוצרים קישור כניסה, או על ידי עדכון של קישור כניסה קיים, באופן הבא:
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Go במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
REST
כדי לעדכן קישור של רשומה, משתמשים ב-method entryLinks.patch, וכוללים את נתוני ההיבט בגוף של entryLink.
חשוב לשים לב למגבלות הבאות כשמשתמשים בהיבטים עם קישורים לרשומות:
- אין תמיכה בהיבטים אופציונליים.
- אין תמיכה בהיבטי נתונים.
- אין תמיכה בהיבטים של סוגים בהתאמה אישית.
- אפשר לנהל רק היבטים נדרשים שמוגדרים לפי סוגי היבטים של המערכת, לדוגמה,
schema-join. - אי אפשר לחפש קישורים לרשומות על סמך התוכן של ההיבטים שלהן.
- אין תמיכה בייבוא או בייצוא של מאפייני קישורים לרשומות.
ניהול היבטים קיימים של רשומה
בקטע הזה מוסבר איך לעדכן ולמחוק את ההיבטים הקיימים של רשומה.
עדכון היבט
אתם יכולים לערוך את ההיבטים האופציונליים גם של רשומות בהתאמה אישית וגם של רשומות מערכת. אפשר לערוך את ההיבטים הנדרשים רק ברשומות בהתאמה אישית.
ברשומות של מערכות צד ראשון (1P), כמו טבלאות ב-BigQuery, אפשר לעדכן היבטים באמצעות ה-API של modifyEntry. כך אפשר להשתמש בהרשאות לעדכון המטא-נתונים של מערכת המקור (לדוגמה, עריכת נתונים ב-BigQuery (roles/bigquery.dataEditor)).
המסוף
נכנסים לדף Search של Knowledge Catalog במסוף Google Cloud .
מחפשים את הרשומה שרוצים לעדכן את ההיבטים שלה ולוחצים עליה.
דף הפרטים של הרשומה נפתח.
- לוחצים על הכרטיסייה פרטים.
- בקטע Aspects, מרחיבים את ההיבט שרוצים לעדכן ולוחצים על Edit.
- בחלון Edit aspect, מעדכנים את שדות החובה.
- לוחצים על Save.
gcloud
כדי לעדכן היבטים של רשומה או של עמודה ברשומה, משתמשים בפקודה gcloud
dataplex entries update או gcloud dataplex entries update-aspects.
כדי לעדכן היבטים באמצעות קובץ JSON:
gcloud dataplex entries update-aspects ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --aspects=ASPECTS_JSON_FILE
מחליפים את מה שכתוב בשדות הבאים:
-
ENTRY_ID: מזהה הרשומה. -
LOCATION: המיקום של הרשומה. -
ENTRY_GROUP_ID: המזהה של קבוצת הרשומות. -
PROJECT_ID: מזהה הפרויקט ASPECTS_JSON_FILE: הנתיב לקובץ ה-JSON שמכיל את מפת ההיבטים.
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Go במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Ruby
Ruby
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Ruby במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Ruby API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
REST
כדי לעדכן היבטים של רשומה או של עמודה ברשומה, משתמשים ב-method entry.patch.
מחיקת היבט
המסוף
נכנסים לדף Search של Knowledge Catalog במסוף Google Cloud .
מחפשים את הרשומה שרוצים למחוק את ההיבטים שלה ולוחצים עליה.
דף הפרטים של הרשומה נפתח.
- לוחצים על הכרטיסייה פרטים.
- בקטע Aspects, מרחיבים את ההיבט שרוצים למחוק ולוחצים על Delete.
- לוחצים על אישור.
gcloud
כדי למחוק היבט של רשומה, משתמשים בפקודה gcloud dataplex entries update עם הדגל --remove-aspects.
כדי למחוק היבט ברמת הרשומה:
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE'
כדי למחוק היבט ברמת העמודה:
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE@Schema.COLUMN_NAME'
מחליפים את מה שכתוב בשדות הבאים:
-
ENTRY_ID: מזהה הרשומה. -
LOCATION: המיקום של הרשומה. -
ENTRY_GROUP_ID: המזהה של קבוצת הרשומות. -
PROJECT_ID: מזהה הפרויקט -
ASPECT_TYPE: המזהה המלא של סוג ההיבט, לדוגמהdataplex-types.global.genericאו<var>PROJECT_ID</var>.<var>LOCATION</var>.<var>ASPECT_TYPE_ID</var>. -
COLUMN_NAME: שם העמודה.
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Go במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Ruby
Ruby
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Ruby במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Ruby API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
REST
כדי למחוק היבט של רשומה, משתמשים ב-method entry.patch.
ניהול היבטים קיימים של קישור לרשומה
בקטע הזה מוסבר איך לעדכן את ההיבטים הקיימים של קישור לרשומה.
עדכון היבט
בקישורים לרשומות, אפשר לעדכן רק היבטים נדרשים שמשתמשים בסוגי היבטים של המערכת שניתנים לשימוש חוזר.
מידע נוסף זמין במאמר הרשאות IAM לפעולות בקישורים לרשומות.
REST
כדי לעדכן קישור של רשומה עם ההיבט הנדרש, משתמשים ב-method entryLinks.patch, כולל נתוני ההיבט בגוף הבקשה.
מחיקת היבט
אי אפשר למחוק את יחס הגובה-רוחב הנדרש לקישור כניסה.
ניהול סוגי היבטים
בקטע הזה מוסבר איך להציג סוגי היבטים, ואיך לעדכן ולמחוק סוגי היבטים בהתאמה אישית.
הצגת הרשימה של סוגי ההיבטים הזמינים
המסוף
במסוף Google Cloud , נכנסים לדף Metadata types ב-Knowledge Catalog.
לוחצים על הכרטיסייה Aspect types.
בדף הזה מפורטים כל סוגי ההיבטים שזמינים ב-Knowledge Catalog.
- כדי לראות סוגי היבטים בהתאמה אישית, לוחצים על הכרטיסייה Custom. בכרטיסייה Custom, בעמודה Catalog source מוצג המיקום של המשאב ב-Knowledge Catalog.
כדי לראות את סוגי ההיבטים של המערכת, לוחצים על הכרטיסייה System.
למידע נוסף על סוגי היבטים בהתאמה אישית ושל המערכת, עיינו בקטע קטגוריות של סוגי היבטים במסמך הזה.
- אופציונלי: כדי לראות את רשימת סוגי ההיבטים בפרויקט שבחרתם, לוחצים על הכרטיסייה Custom ואז על המתג Show from all projects למצב כבוי.
המתג Show from all projects מופעל כברירת מחדל, והרשימה כוללת משאבים של Knowledge Catalog מהארגון שבחרתם.
gcloud
כדי להציג את כל סוגי ההיבטים הזמינים, משתמשים בפקודה gcloud dataplex
aspect-types list.
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Go במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Ruby
Ruby
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Ruby במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Ruby API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
REST
כדי להציג את כל סוגי ההיבטים הזמינים, משתמשים ב-method aspectTypes.list.
הצגת פרטים של סוג היבט
המסוף
במסוף Google Cloud , נכנסים לדף Metadata types ב-Knowledge Catalog.
לוחצים על הכרטיסייה Aspect types.
כדי לראות את הפרטים של סוג מאפיין ב-Knowledge Catalog, לוחצים על סוג המאפיין. נפתח דף הפרטים של סוג ההיבט, שבו אפשר לגשת לפרטים כמו השם המוצג, מזהה סוג ההיבט, התיאור, מזהה הפרויקט, המיקום, התוויות, תאריך היצירה ותאריך השינוי האחרון.
- כדי לראות את המבנה של סוג ההיבט שנבחר, לוחצים על הכרטיסייה Template.
- כדי לראות את רשימת 10 הרשומות הקשורות שנוצרו לאחרונה, לוחצים על הכרטיסייה Sample entries.
- כדי לחפש את כל הרשומות הקשורות, לוחצים על הצגת כל הרשומות הקשורות בחיפוש. הלחצן הזה מופיע רק אם יש לפחות רשומה אחת קשורה.
gcloud
כדי לקבל את הפרטים של סוג היבט, משתמשים בפקודה gcloud dataplex aspect-types
describe.
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Go במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Ruby
Ruby
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Ruby במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Ruby API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
REST
כדי לקבל את הפרטים של סוג היבט, משתמשים ב-method aspectTypes.get.
עדכון של סוג היבט מותאם אישית
אתם יכולים לעדכן את השם המוצג, התיאור, שדות התבנית והתוויות של סוג היבט בהתאמה אישית. אי אפשר למחוק שדה קיים בתבנית.
אי אפשר לעדכן את המזהה והמיקום של סוג ההיבט אחרי שיוצרים אותו.
המסוף
במסוף Google Cloud , נכנסים לדף Metadata types ב-Knowledge Catalog.
לוחצים על הכרטיסייה Aspect types.
לוחצים על סוג ההיבט שרוצים לעדכן.
בדף Aspect type details, לוחצים על Edit.
עורכים את השם המוצג, התיאור, שדות התבנית והתוויות, לפי הצורך.
אופציונלי: כדי לסמן שדה בסוג ההיבט כהוצא משימוש, מבצעים את השלבים הבאים:
- בקטע תבנית, מרחיבים את השדה.
- בוחרים באפשרות הוצא משימוש.
- בשדה Deprecation reason, מזינים את הסיבה להוצאה משימוש של השדה שנבחר.
לוחצים על סיום.
לוחצים על Save.
gcloud
כדי לעדכן סוג היבט בהתאמה אישית, משתמשים בפקודה gcloud dataplex aspect-types
update.
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Go במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Ruby
Ruby
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Ruby במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Ruby API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
REST
כדי לעדכן סוג היבט בהתאמה אישית, משתמשים ב-method aspectTypes.patch.
מחיקת סוג היבט בהתאמה אישית
המסוף
במסוף Google Cloud , נכנסים לדף Metadata types ב-Knowledge Catalog.
לוחצים על הכרטיסייה Aspect types.
לוחצים על סוג ההיבט שרוצים למחוק.
בדף Aspect type details, לוחצים על Delete. מאשרים את הפעולה כשמוצגת בקשה לעשות זאת.
gcloud
כדי למחוק סוג היבט בהתאמה אישית, משתמשים בפקודה gcloud dataplex aspect-types
delete.
C#
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
המשך
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Go במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Go API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Java API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Node.js API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Python API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Ruby
Ruby
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Ruby במדריך למתחילים של Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog Ruby API.
כדי לבצע אימות ב-Knowledge Catalog, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
REST
כדי למחוק סוג היבט קיים בהתאמה אישית, משתמשים ב-method aspectTypes.delete.
המאמרים הבאים
- איך מחפשים משאבים ב-Knowledge Catalog
- איך מנהלים רשומות ומטמיעים מקורות בהתאמה אישית
- איך מייבאים מטא-נתונים ל-Knowledge Catalog
- מידע נוסף על מטא-נתונים ב-Knowledge Catalog
- איך להגדיר הקשר בסיסי לנתונים
- תרחישים לדוגמה לשימוש ב-Knowledge Catalog