יצירת גרסה של סוג

במדריך הזה נסביר איך ליצור גרסה חדשה של סוג קיים ב-Manufacturing Data Engine‏ (MDE).

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

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

הגבלות על יצירת גרסאות

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

בגרסאות חדשות יכול להיות:

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

הגרסאות החדשות לא יכולות:

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

יצירת גרסה חדשה של סוג

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

REST

מריצים את בקשת ה-API הבאה בארכיטקטורת REST:

POST /configuration/v1/types/TYPE_NAME/versions

{
  "metadataBuckets": [
    {
      "bucketName": "EXISTING_BUCKET_NAME",
      "version": "EXISTING_BUCKET_VERSION"
    },
    {
      "bucketName": "NEW_BUCKET_NAME",
      "version": "NEW_BUCKET_VERSION"
    }
  ],
  "storageSpecs": [
    {
      "sink": "BIG_QUERY",
      "disabled": "false",
      "materializeCloudMetadata": "true"
    },
    {
      "sink": "BIG_TABLE",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "GCS",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "PUBSUB_PROTO",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "PUBSUB_JSON",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    }
  ]
}

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

• ‫TYPE_NAME: השם של הסוג שעבורו נוצרת גרסה חדשה.
• ‫EXISTING_BUCKET_NAME: שם הקטגוריה הקיימת שכבר משויכת לסוג הזה.
• ‫EXISTING_BUCKET_VERSION: גרסת הבאקט הקיים שכבר משויכת לסוג הזה.
• ‫NEW_BUCKET_NAME: שם הקטגוריה החדשה.
• ‫NEW_BUCKET_VERSION: הגרסה של הדלי החדש.

המסוף

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

   

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

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

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

   

2. נפתח הטופס Create New Type Version (יצירת גרסה חדשה של סוג) שבו אפשר לשנות את ההגדרות של הסוג שנבחר:

   

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

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