مدقق توافق مخطط Avro

ما تحتاج إلى معرفته

تقبل مخططات Avro بصيغة JSON، بحد أقصى 1,000,000 حرف لكل مخطط، و50,000 قيمة JSON و64 مستوى تداخل. وفي الأوضاع الانتقالية، تقبل حتى 50 إصدارًا أقدم. يعمل الفحص في عامل خلفية بالمتصفح. التنزيلات هي تقرير JSON وقائمة مشكلات CSV.

الأوضاع

يعني التوافق مع الإصدارات الأقدم أن المخطط الجديد يستطيع قراءة البيانات التي كتبها المخطط القديم، وهو ما يحتاج إليه ترقية المستهلك. ويعني التوافق مع الإصدارات الأحدث أن المخطط القديم يستطيع قراءة البيانات التي كتبها المخطط الجديد. ويفحص التوافق الكامل الاتجاهين. تقارن الأوضاع الانتقالية المخطط الجديد بكل إصدار أقدم تدرجه، من الأقدم إلى الأحدث، بدلًا من الإصدار الأحدث فقط.

قواعد الحل

تتبع الفحوص قسم Schema Resolution من مواصفة Avro 1.11: يُرقّى int إلى long وfloat وdouble؛ وlong إلى float وdouble؛ وfloat إلى double؛ ويمكن ترقية string وbytes كل منهما إلى الآخر. تتطابق السجلات بالاسم الكامل أو الاسم غير المؤهل أو اسم مستعار للقارئ. يحتاج حقل القارئ الذي لا يملكه الكاتب إلى قيمة افتراضية صالحة. يجب أن يتضمن تعداد القارئ كل رمز لدى الكاتب ما لم يكن له افتراضي. يجب أن يُحل كل فرع من اتحاد الكاتب لدى القارئ.

حدود الفحص

يفحص هذا حل المخطط في Avro لا القواعد الإضافية لسجل مخططات بعينه. يجب أن تتساوى precision وscale في الأنواع المنطقية العشرية الصالحة، لكل من ترميزي bytes وfixed. تُفسّر الأنواع المنطقية المجهولة أو غير الصالحة وفق نوع Avro الأساسي. تُفحص القيم الافتراضية للاتحاد مقابل الفرع الأول؛ وتُتحقق القيم الافتراضية المتداخلة تكراريًا.