الانتقال إلى المحتوى الرئيسي
clickhouse-cpp هي مكتبة العميل الرسمية لـ ClickHouse بلغة C++، وتوفّر واجهة سريعة وآمنة نوعيًا لـ ClickHouse باستخدام بروتوكوله الثنائي الأصلي. إرشادات البناء وأمثلة الاستخدام ووثائق إضافية متاحة في مستودع GitHub الخاص بالمشروع: https://github.com/ClickHouse/clickhouse-cpp.
المكتبة قيد التطوير النشط. وعلى الرغم من أنها تدعم بالفعل الوظائف الأساسية في ClickHouse، فقد لا تكون بعض الميزات وأنواع البيانات مُنفَّذة بالكامل أو مدعومة بعد.ملاحظاتك قيّمة للغاية، وهي تساعد في توجيه أولويات الميزات الجديدة والتحسينات. إذا واجهت قيودًا أو وظائف مفقودة أو سلوكًا غير متوقع، فيُرجى مشاركة ملاحظاتك أو طلبات الميزات عبر متتبّع المشكلات على  https://github.com/ClickHouse/clickhouse-cpp/issues

تضمين المكتبة في مشروعك

أبسط طريقة لتضمين المكتبة في مشروعك هي استخدام الوحدة FetchContent الخاصة بـ CMake. يتيح لك هذا النهج تحديد إصدار دقيق من المكتبة وبناءها كجزء من سير عمل CMake المعتاد.
يُفعِّل الخيار WITH_OPENSSL دعم TLS في المكتبة، وهو مطلوب عند الاتصال بـ ClickHouse Cloud أو بعمليات نشر ClickHouse الأخرى المفعَّل فيها SSL. ومع أنه يمكن الاستغناء عنه في الاتصالات غير المعتمدة على TLS، فإن تمكينه يُوصى به عمومًا. يتطلب البناء مع دعم SSL تثبيت حزم تطوير OpenSSL. ثبّت libssl-dev على Debian وUbuntu أو مشتقاتهما؛ وopenssl-devel على Fedora وRed Hat؛ أو openssl على macOS باستخدام Homebrew. بعد إتاحة التبعية، اربط هدفك بهدف المكتبة المُصدَّر:

أمثلة

إعداد كائن Client

أنشئ مثيل Client لإنشاء اتصال بـ ClickHouse. يوضّح المثال التالي كيفية الاتصال بمثيل ClickHouse محلي، حيث لا تكون كلمة المرور مطلوبة ولا يكون SSL مفعّلًا.
في البيئات الأكثر تقدمًا، يلزم إجراء تهيئة إضافية. يوضّح المثال التالي كيفية الاتصال بمثيل ClickHouse Cloud باستخدام عدة معلمات إضافية:

إنشاء الجداول وتشغيل الاستعلامات دون بيانات

لتنفيذ استعلام لا يعيد أي بيانات، مثل إنشاء الجداول، استخدم الأسلوب Execute. وينطبق النهج نفسه على تعليمات أخرى مثل ALTER TABLE وDROP وما إلى ذلك.

إدراج البيانات

لإدراج البيانات في جدول، أنشئ Block واملأه بكائنات الأعمدة المطابقة لبنية الجدول. تُضاف البيانات عمودًا تلو الآخر، ثم تُدرَج في عملية واحدة باستخدام الأسلوب Insert، وهو مُحسَّن لتنفيذ عمليات كتابة دفعية بكفاءة.

اختيار البيانات

لتنفيذ استعلام يُرجع بيانات، استخدم الطريقة Select ومرّر دالة callback لمعالجة النتيجة. تُعاد نتائج الاستعلام على شكل كائنات Block، بما يعكس تمثيل بيانات ClickHouse الأصلي الموجّه بالأعمدة.

أنواع البيانات المدعومة

  • UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64
  • UInt128, Int128
  • Decimal32, Decimal64, Decimal128
  • Float32, Float64
  • Date
  • DateTime, DateTime64
  • DateTime([timezone]), DateTime64(N, [timezone])
  • UUID
  • Enum8, Enum16
  • String
  • FixedString(N)
  • LowCardinality(String) و LowCardinality(FixedString(N))
  • Nullable(T)
  • Array(T)
  • Tuple
  • Map
  • IPv4, IPv6
  • Point, Ring, Polygon, MultiPolygon
آخر تعديل في ٢ يوليو ٢٠٢٦