הנחיות למתן שם למשאב ב-Knowledge Catalog

Google Cloud משאב הוא כל רכיב שאתם יוצרים או משתמשים בו בתוךGoogle Cloud. המשאבים האלה הם אבני הבניין של האפליקציות והמערכות שפועלות בפלטפורמה.

מידע נוסף על מתן שמות כלליים Google Cloud למשאבים זמין במאמר שמות משאבים.

פורמט שמות המשאבים

בטבלה הבאה מפורטים הפורמטים של השמות המלאים של המשאבים ב-Knowledge Catalog:

משאב פורמט השם המלא של המשאב
קבוצת כניסות projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}
כניסה projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}/entries/{ENTRY_ID}
סוג הכניסה projects/{PROJECT_ID}/locations/{LOCATION}/entryTypes/{ENTRY_TYPE_ID}
סוג ההיבט projects/{PROJECT_ID}/locations/{LOCATION}/aspectTypes/{ASPECT_TYPE_ID}
קישור לדף הנחיתה projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}/entryLinks/{ENTRY_LINK_ID}
משימת מטא-נתונים projects/{PROJECT_ID}/locations/{LOCATION}/metadataJobs/{METADATA_JOB_ID}
פיד מטא-נתונים projects/{PROJECT_ID}/locations/{LOCATION}/metadataFeeds/{METADATA_FEED_ID}
מילון מונחים projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}
קטגוריה של מילון מונחים projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}/categories/{GLOSSARY_CATEGORY_ID}
מונח במילון projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}/terms/{GLOSSARY_TERM_ID}
מוצר נתונים projects/{PROJECT_ID}/locations/{LOCATION}/dataProducts/{DATA_PRODUCT_ID}
דומיין נתונים projects/{PROJECT_ID}/locations/{LOCATION}/dataDomains/{DATA_DOMAIN_ID}
תהליך שושלת נתונים projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}
הפעלה של מעקב אחר מקורות נתונים projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}/runs/{RUN_ID}
אירוע של שרשרת היוחסין projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}/runs/{RUN_ID}/lineageEvents/{LINEAGE_EVENT_ID}

רכיבים של שם המשאב

בקטעים הבאים מפורט כל רכיב.

מזהה פרויקט

הערך צריך להיות מזהה הפרויקט או מספר הפרויקט, שזמינים במסוף Google Cloud . לדוגמה, my-cool-project הוא מזהה פרויקט, ו-123456789123 הוא מספר פרויקט.

מיקום

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

מזהה המשאב

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

מזהי משאבים רגילים

פרט למזהי רשומות ולמזהי משאבים של שושלת הנתונים, כל משתני מזהה המשאב, כמו {ENTRY_GROUP_ID} ו-{GLOSSARY_ID}, צריכים לעמוד בהנחיות הבאות:

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

קבוצות של רשומות במערכת

מזהי רשומות

ההנחיות למתן שמות ל-{ENTRY_ID} שונות:

  • הוא יכול לכלול עד 4,000 תווים.

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

    לדוגמה:

    • אם השם המלא של משאב של מכונת Looker הוא //looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance, אז ההצעה {ENTRY_ID} היא looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance.

מזהי משאבים של שושלת נתונים

משאבי שושלת הנתונים מייצגים היררכיה של פעולות טרנספורמציה של נתונים:

  • מזהה תהליך ({PROCESS_ID}): מזהה את ההגדרה של טרנספורמציה של נתונים (כמו שאילתת SQL ספציפית או צינור עיבוד נתונים מסוג ETL).
  • מזהה הרצה ({RUN_ID}): מזהה מופע ביצוע יחיד של תהליך אב.
  • מזהה אירוע של שושלת נתונים ({LINEAGE_EVENT_ID}): מזהה אירוע נפרד של העברת נתונים בין מקורות ליעדים שהתרחש במהלך הרצה.

כשיוצרים משאבי שושלת מותאמים אישית באמצעות ה-API, המשתנים {PROCESS_ID}, {RUN_ID} ו-{LINEAGE_EVENT_ID} צריכים לעמוד בהנחיות הבאות:

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

במקרים של שושלת נתונים אוטומטית (כמו שאילתות BigQuery, Managed Service for Apache Spark או הטמעת נתונים של OpenLineage), Knowledge Catalog יוצר את המזהים האלה באופן אוטומטי.

שמות של רשומות ב-BigQuery

כשמבצעים אינטראקציה עם משאבי BigQuery באמצעות ממשקי Knowledge Catalog API, צריך להשתמש בפורמט ספציפי למזהה קבוצת הרשומות ולמזהה הרשומה.

  • מזהה קבוצת כניסות: @bigquery
  • מזהה רשומה: bigquery.googleapis.com/projects/{PROJECT_ID}/datasets/{DATASET_ID}/tables/{TABLE_ID}

דוגמה

אם הטבלה שלכם ב-BigQuery היא projects/test-project/datasets/test_dataset/tables/test_table, השם המלא של הערך ב-Knowledge Catalog הוא:

projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/@bigquery/entries/bigquery.googleapis.com/projects/test-project/datasets/test_dataset/tables/test_table