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

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

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

  • קבוצת רשומות

  • הערך

  • סוג הרשומה

  • סוג ההיבט

  • קישור לכניסה

  • משימת מטא-נתונים

  • פיד מטא-נתונים

  • מילון מונחים

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

  • מונח במילון

  • מוצר נתונים

  • דומיין נתונים

  • תהליך שושלת נתונים

  • הרצת שושלת

  • אירוע של שושלת נתונים

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

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

אלה הפורמטים של רכיבי התוכן השונים:

  • קבוצת ערכים: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/{ENTRY_GROUP_ID}

  • ערך: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/{ENTRY_GROUP_ID}/entries/{ENTRY_ID}

  • סוג הרשומה: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryTypes/{ENTRY_TYPE_ID}

  • סוג ההיבט: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/aspectTypes/{ASPECT_TYPE_ID}

  • קישור לכניסה: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/{ENTRY_GROUP_ID}/entryLinks/{ENTRY_LINK_ID}

  • משימת מטא-נתונים: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/metadataJobs/{METADATA_JOB_ID}

  • פיד מטא-נתונים: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/metadataFeeds/{METADATA_FEED_ID}

  • מילון מונחים: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/glossaries/{GLOSSARY_ID}

  • קטגוריית מילון מונחים: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/glossaries/{GLOSSARY_ID}/categories/{GLOSSARY_CATEGORY_ID}

  • מונח במילון: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/glossaries/{GLOSSARY_ID}/terms/{GLOSSARY_TERM_ID}

  • מוצר נתונים: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/dataProducts/{DATA_PRODUCT_ID}

  • דומיין נתונים: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/dataDomains/{DATA_DOMAIN_ID}

  • תהליך: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/processes/{PROCESS_ID}

  • ריצה: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/processes/{PROCESS_ID}/runs/{RUN_ID}

  • אירוע של שושלת נתונים: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/processes/{PROCESS_ID}/runs/{RUN_ID}/lineageEvents/{LINEAGE_EVENT_ID}

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

מזהה פרויקט

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

מיקום

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

מזהה

‫ID הוא הפלח האחרון בנתיב המשאב.

ברוב המשאבים (קבוצות רשומות, סוגי רשומות, סוגי היבטים, קישורי רשומות, משימות מטא-נתונים, פידים של מטא-נתונים, מילונים, קטגוריות מילון, מונחי מילון, מוצרי נתונים ודומיינים של נתונים), משתנים כמו {ENTRY_GROUP_ID},‏ {ENTRY_TYPE_ID},‏ {ASPECT_TYPE_ID},‏ {ENTRY_LINK_ID},‏ {METADATA_JOB_ID},‏ {METADATA_FEED_ID},‏ {GLOSSARY_ID},‏ {GLOSSARY_CATEGORY_ID},‏ {GLOSSARY_TERM_ID},‏ {DATA_PRODUCT_ID} ו-{DATA_DOMAIN_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}, {RUN_ID} ו-{LINEAGE_EVENT_ID} צריכים לעמוד בהנחיות הבאות:

  • הוא יכול לכלול עד 200 תווים.

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

שמות של רשומות ב-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_NAME}/entryGroups/@bigquery/entries/bigquery.googleapis.com/projects/test-project/datasets/test_dataset/tables/test_table