‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

יצירת גרסה של קטגוריית מטא-נתונים

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

גרסאות של קטגוריות מטא-נתונים מאפשרות לפתח את סכימת הקטגוריות. סוגים ומנתחים (parsers) תמיד מתייחסים לגרסה ספציפית של מאגר, כך שכאשר יוצרים גרסה חדשה, היא לא משפיעה על צינורות העיבוד הקיימים של הנתונים. כדי להשתמש בגרסה החדשה של הדלי, צריך לשדרג את הסוגים ואת כלי הניתוח, או ליצור סוגים וכלי ניתוח חדשים. אפשר ליצור גרסה של קטגוריית אחסון של מטא-נתונים באמצעות Configuration API או ממשק האינטרנט של MDE.

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

כדי להשתמש במדריך הזה, צריך ליצור מראש קטגוריה של מטא-נתונים עבור MDE.

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

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

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

מוסיפים שדות אופציונליים חדשים.
סימון שדה חובה כשדה אופציונלי.

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

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

יצירת גרסה חדשה של קטגוריית מטא-נתונים

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

REST

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

POST /metadata/v1/buckets/BUCKET_NAME/versions

{
  "schema": "BUCKET_SCHEMA",
  "provider": "local"
}

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

‫BUCKET_NAME: שם הקטגוריה שרוצים ליצור.
‫BUCKET_TYPE: סוג ה-bucket שרוצים ליצור. חייב להיות אחד מהערכים הבאים: TAG, RECORD או LOOKUP. ה-natural_key של מופע מטא-נתונים בקטגוריית TAG חייב להיות שם תג. הפרמטר natural_key של מופע מטא-נתונים בקטגוריית RECORD יכול להיות כל מפתח. ה-natural_key של מופע מטא-נתונים בדלי LOOKUP יכול להיות כל מפתח, אבל רשומות לא יכולות להפנות למופעים בדלי חיפוש, והמופעים לא נכתבים ל-data sink כלשהו. דליים של חיפושים משמשים רק כמקור של נתוני הפניה שאפשר לאחזר באמצעות כלי ניתוח שמבוסס על פונקציית Whistle‏ lookupByKey, ומשמשים להעשרת רשומות.
‫BUCKET_SCHEMA: סכימת JSON של הדלי. הסכימה מגבילה את המופעים שאפשר ליצור בקטגוריה.
‫INSTANCE_OVERWRITE_MODE: TRUE או FALSE. המאפיין הזה קובע אם נוצרים מופעים חדשים על ידי מיזוג המופע שצוין עם המופע האחרון של מפתח טבעי נתון, או אם נוצרים מופעים חדשים כמו שהם.

המסוף

כדי ליצור גרסה חדשה של דלי מטא-נתונים, לוחצים על Create New Version (יצירת גרסה חדשה) בקטע METADATA (מטא-נתונים) בממשק האינטרנט של Cloud Management MC:
מוצג לוח הגדרות עם טופס לעדכון הפרמטרים של גרסת קטגוריית המטא-נתונים החדשה:

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