סקירה כללית של הסכימה

סכימת Pub/Sub היא תכונה אופציונלית שבה אפשר להשתמש כדי לאכוף את הפורמט של שדה הנתונים בהודעת Pub/Sub.

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

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

סוגים של סכימות

אפשר ליצור סכימה ב-Pub/Sub באמצעות אחת מהמסגרות הבאות:

לדוגמה, הסכימה הבאה מגדירה את המלאי של מחסן, קודם בפורמט Avro ואז בפורמט Protocol Buffer.

פורמט Apache Avro

{
 "type" : "record",
 "name" : "Avro",
 "fields" : [
   {
     "name" : "ProductName",
     "type" : "string",
     "default": ""
   },
   {
     "name" : "SKU",
     "type" : "int",
     "default": 0
   },
   {
     "name" : "InStock",
     "type" : "boolean",
     "default": false
   }
 ]
}

פורמט מאגר אחסון לפרוטוקולים

syntax = "proto3";
message ProtocolBuffer {
  string product_name = 1;
  int32 SKU = 2;
  bool in_stock = 3;
}

מידע חשוב על סכימות

בהמשך מופיע מידע חשוב לגבי יצירה וניהול של סכימות Pub/Sub.

  • כדי שסכימה תפעל עם Pub/Sub, צריך להגדיר רק סוג אחד ברמה העליונה. אין תמיכה בהצהרות ייבוא שמפנות לסוגים אחרים.

  • אפשר לשייך את אותו סכימה לכמה נושאים.

  • אתם יכולים לבדוק באופן ידני אם הודעה מאומתת מול סכימה.

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

מכסות ומגבלות של סכימות

לסכימות יש את המגבלות הבאות:

  • הגודל של שדה הגדרת הסכימה לא יכול להיות גדול מ-300KB.

  • בכל פרויקט יכולים להיות עד 10,000 סכימות.

  • בסכימה אחת יכולות להיות עד 20 גרסאות.

    מידע על סכימות ומגבלות שקשורות ל-Pub/Sub זמין במאמר מכסות ומגבלות ב-Pub/Sub.

המאמרים הבאים