- الواجهات الرئيسية هي
Clientالمتزامن وAsyncClientالأصلي المعتمد على aiohttp ضمنclickhouse_connect.driver. كما توفّر حزمة برنامج التشغيل سياقات الاستعلام والإدراج، ومساعدات البث، ودعم DB-API، وطرق HTTP منخفضة المستوى. - تتولى حزمة
clickhouse_connect.datatypesتسلسل أنواع ClickHouse وإلغاء تسلسلها باستخدام التنسيق الثنائي العمودي الأصلي لـ ClickHouse. - تُسرّع امتدادات Cython الاختيارية في
clickhouse_connect.drivercمسارات التسلسل والتحويل والتخزين المؤقت الشائعة. ويظل مسار بايثون خالص متاحًا على المنصات التي يتعذر فيها بناء هذه الامتدادات. - تتضمن الحزمة معلومات الأنواع وفق PEP 561، بحيث تتمكن أدوات التحقق من الأنواع اللاحقة من استخدام التعليقات التوضيحية الخاصة بالواجهات العامة لبرنامج التشغيل وDB-API وSQLAlchemy.
- تدعم لهجة SQLAlchemy في
clickhouse_connect.cc_sqlalchemyواجهة SQLAlchemy Core، وانعكاس المخطط، وبنود الاستعلام ومحركات الجداول الخاصة بـ ClickHouse، وعمليات ترحيل Alembic. تعمل عمليات قراءة ORM الأساسية وعمليات الإدراج، لكن هذه اللهجة مصممة لأعباء العمل التحليلية لا لسلوك ORM الكامل القائم على وحدة العمل. - يُعد برنامج التشغيل الأساسي وتنفيذ ClickHouse Connect SQLAlchemy الطريقة المفضلة لربط ClickHouse مع Apache Superset. استخدم اتصال قاعدة البيانات
ClickHouse Connectأو سلسلة اتصال لهجة SQLAlchemy clickhousedb.
تستخدم برامج ClickHouse Connect العميلة القياسية واجهة HTTP. ويدعم ذلك موازنات تحميل HTTP والوكيلات وضوابط الشبكات المؤسسية الشائعة. كما يوفّر ClickHouse Connect أيضًا واجهة خلفية chDB تجريبية تعمل داخل العملية.
المتطلبات والتوافق
تتضمن الحزمة حزم wheel مُصرَّفة حيثما كانت متاحة، وتلجأ إلى تنفيذ ببايثون خالص عندما يتعذر بناء امتدادات Cython. PyArrow مدعوم على بايثون من 3.10 إلى 3.14. يتطلب بايثون 3.14 إصدار PyArrow 22 أو أحدث.
التثبيت
- نفّذ
git cloneلـ مستودع GitHub. - انتقل إلى جذر المشروع وشغّل
pip install .. يثبّت نظام البناء Cython تلقائيًا لتجميع امتدادات C الاختيارية.
clickhouse_connect.__version__.
سياسة الدعم
الاستخدام الأساسي
اجمع بيانات الاتصال الخاصة بك
تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في ClickHouse Cloud console.
حدِّد خدمة ثم انقر على Connect:

curl.

إنشاء اتصال
- الاتصال بخادم ClickHouse على localhost.
- الاتصال بخدمة ClickHouse Cloud.
استخدم مثيل عميل ClickHouse Connect للاتصال بخادم ClickHouse على localhost:
استخدم مثيل عميل ClickHouse Connect للاتصال بخدمة ClickHouse Cloud:
التفاعل مع قاعدة البيانات
command الخاصة بالعميل:
insert الخاصة بالعميل مع مصفوفة ثنائية الأبعاد من الصفوف والقيم:
query الخاصة بالعميل:
الواجهة الخلفية المضمّنة لـ chDB
chdb، ثم اختر الواجهة الخلفية باستخدام interface="chdb" أو عبر chdb:// DSN:
path="/data/my_chdb" أو استخدم dsn="chdb:///data/my_chdb" للتخزين الدائم. يتيح chDB مسار engine واحدًا لكل عملية. ولا يدعم العميل غير المتزامن أو البيانات الخارجية.