عن المشروع

مجموعة التحقق من برنامج التشغيل هي إطار عمل اختبار قابل لإعادة الاستخدام وقابل للتوصيل للتحقق من صحة برامج تشغيل ADBC (اتصال قاعدة بيانات Arrow)، تم بناؤها باستخدام Python ومكتبة اختبار pytest. تقوم بتشغيل ميزات وأنواع بيانات ADBC المختلفة عن طريق تشغيل استعلامات SQL ضد برامج التشغيل المستهدفة، وتولد جداول وثائق تسرد الميزات المدعومة وغير المدعومة. يمكن للمجموعة استيعاب بناء جمل وقواعد سلوك خاصة بقاعدة البيانات. تنظم حالات الاختبار تحت دليل queries/base، مع كل اختبار فردي يتكون من جميع الملفات في دليل واحد تشترك في اسم ملف أساسي. تدعم المجموعة ثلاثة أنواع استعلامات أساسية: 1. استعلامات SELECT: اختبار تشغيل استعلام والتحقق من نتيجته، يتكون من ملف query.sql، مخطط النتيجة المتوقع (query.schema.json)، بيانات النتيجة المتوقعة بتنسيق JSON Lines (query.json)، بالإضافة إلى ملفات SQL الإعداد الاختيارية، وبيانات معلمات الربط، ومخطط الربط، واستعلام الربط. 2. استعلامات المخطط: اختبار استرداد مخطط مجموعة النتائج للاستعلام دون تنفيذه، يتطلب فقط query.sql وملف المخطط المتوقع. 3. استعلامات الاستيعاب: اختبار الاستيعاب المجمع لبيانات Arrow ثم الاستعلام عن الجدول المحمل، يتطلب مخطط الإدخال وملفات البيانات، مع مخطط النتيجة المتوقع وبياناته الاختيارية. يمكن لجميع حالات الاختبار تضمين ملف بيانات وصفية query.toml اختياري للتحكم في سلوك الاختبار وإخراج الوثائق: علامة hide تتجاوز تشغيل الاختبار بالكامل لبرنامج تشغيل معين، علامة skip تحدد الاختبار على أنه غير مدعوم مع سبب مقدم، sort-keys تحدد الأعمدة لفرز مجموعات النتائج بها قبل المقارنة، ويمكن للعلامات إضافة تنبيهات، أو تحديد الدعم الجزئي، أو تحديد اسم نوع SQL للوثائق. يمكن لبرامج التشغيل تجاوز حالات الاختبار الأساسية بتعديلات خاصة ببرنامج التشغيل عن طريق وضع الملفات في نفس المسار النسبي في دليل الخصائص الفريدة المخصص لها، مما يتجنب الحاجة إلى تكرار حالات الاختبار الكاملة. كبديل لتعريفات الاختبار المنفصلة لكل ملف، يمكن استخدام ملف .txtcase واحد، مع تعليقات // part: تحدد أي قسم يتوافق مع أي نوع ملف أصلي. لا يمكن خلط ملفات .txtcase مع ملفات منفصلة لنفس حالة الاختبار، حيث سيؤدي ذلك إلى أخطاء في اكتشاف الاختبار. يشير المشروع إلى أن الوثائق الرسمية لا تزال قيد التقدم، ويوصي المستخدمين بالرجوع إلى تطبيقات برامج تشغيل ADBC الحالية لمعرفة كيفية دمج مجموعة التحقق.