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

סכימת 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.

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