عن المشروع

chconn هو برنامج تشغيل Go نقي لـ ClickHouse يتواصل عبر بروتوكول TCP الأصلي، ومحسّن للوصول عالي الأداء والموجه بالأعمدة إلى البيانات. يدعم الأدوية الجنيسة (generics) بالكامل، مما يتيح عمليات أعمدة آمنة النوع لكل من الإدراج والاختيار. تشمل الميزات الرئيسية: - **الإدراج والاختيار الموجه بالأعمدة**: إلحاق البيانات بأعمدة محددة النوع وإدراجها بالجملة أو قراءتها كتلة تلو الأخرى لأقصى إنتاجية. - **الاستعلامات الموجهة بالصفوف**: تكرار بأسلوب SQL مألوف باستخدام `Query` و`Scan`. - **مسح البُنى (Struct scanning)**: ربط النتائج مباشرة ببُنى Go حسب اسم الحقل أو موضعه، مع خيارات مثل `RowToStructByName` و`RowToStructByNameLax` و`RowToStructByPos` و`RowTo`. - **الإدراج بالبث**: إلحاق صفوف أو كتابة دفعات أعمدة لإدراجات متعددة الدفعات. - **الاستعلامات ذات المعاملات**: معاملات استعلام آمنة النوع باستخدام صيغة ClickHouse الأصلية. - **تجميع الاتصالات**: تجمّع قابل للتهيئة بحد أدنى/أقصى للاتصالات، ومدة الصلاحية، ووقت الخمول، وفحوصات السلامة. - **دعم شامل للأنواع**: يشمل الأنواع الرقمية، والسلاسل النصية، والتواريخ، وUUID، وعناوين IP، والتعدادات، والمصفوفات، والقيم القابلة للعدم (nullable)، والكاردينالية المنخفضة، والخرائط، والصفوف المركبة (tuples)، والأنواع المتداخلة، وJSON، والمتغيرات (variants)، والديناميكية، والأنواع الجغرافية، والمزيد. - **الضغط**: دعم LZ4 وZSTD. - **TLS/SSL**: أوضاع SSL متعددة. - **مولّد الشيفرة (chgen)**: توليد بُنى نماذج Go وتعريفات الأعمدة من جداول ClickHouse أو ملفات SQL. - **باني SQL**: باني سلس لاستعلامات SELECT مع الربط (joins) والشروط والتجميع والمزيد. - **تصدير JSON**: تصدير نتائج الاستعلام ككائنات JSON أو مصفوفات أو لكل صف. - **استدعاءات التقدم والملف الشخصي**: مراقبة تنفيذ الاستعلام في الوقت الفعلي. - **معالجة الأخطاء**: أخطاء ClickHouse محددة النوع مع رموز وتتبعات مكدس، بالإضافة إلى أخطاء مرجعية (sentinel errors). - **دعم السياق (Context)**: جميع العمليات تقبل السياق للمهلات والإلغاء. إصدارات Go المدعومة هي أحدث إصدارين مستقرين، وClickHouse 24.3+. تم اختبار برنامج التشغيل مقابل ClickHouse 24.3 و24.8 و25.3 و25.8 و26.2. تُظهر المعايير تحسينات كبيرة في الأداء وتخصيص الذاكرة مقارنة ببرامج تشغيل ClickHouse الأخرى لـ Go.