حزم الخادم

الخادم في البروتوكول الأصلي

value	name	description
0	Hello	استجابة الخادم للمصافحة
1	Data	مثل بيانات العميل
2	Exception	استثناء أثناء معالجة الاستعلام
3	Progress	تقدّم الاستعلام
4	Pong	استجابة Ping
5	EndOfStream	تم نقل جميع الحزم
6	ProfileInfo	بيانات التنميط
7	Totals	القيم الإجمالية
8	Extremes	القيم القصوى (الحد الأدنى، الحد الأقصى)
9	TablesStatusResponse	استجابة لطلب TableStatus
10	Log	سجل نظام الاستعلام
11	TableColumns	وصف الأعمدة
12	UUIDs	قائمة بمُعرّفات الأجزاء الفريدة
13	ReadTaskRequest	String (UUID) يصف طلبًا يلزم له الحصول على المهمة التالية
14	ProfileEvents	حزمة تحتوي على أحداث profile من الخادم

يمكن ضغط Data وTotals وExtremes.

​

Hello

استجابة لـ client hello.

الحقل	النوع	القيمة	الوصف
name	String	Clickhouse	اسم الخادم
version_major	UVarInt	21	الإصدار الرئيسي للخادم
version_minor	UVarInt	12	الإصدار الثانوي للخادم
revision	UVarInt	54452	مراجعة الخادم
tz	String	Europe/Moscow	المنطقة الزمنية للخادم
display_name	String	Clickhouse	اسم الخادم في واجهة المستخدم
version_patch	UVarInt	3	إصدار التصحيح للخادم

​

Exception

استثناء من الخادم أثناء معالجة الاستعلام.

الحقل	النوع	القيمة	الوصف
code	Int32	60	راجع ErrorCodes.cpp.
name	String	DB::Exception	الإصدار الرئيسي للخادم
message	String	DB::Exception: Table X doesn't exist	الإصدار الثانوي للخادم
stack_trace	String	~	تتبّع المكدس في C++
nested	Bool	true	مزيد من الأخطاء

قد تأتي الاستثناءات في قائمة متتابعة إلى أن تصبح قيمة nested هي false.

​

Progress

يبلّغ الخادم دوريًا عن Progress تنفيذ الاستعلام.

يُبلَّغ عن Progress على شكل فروقات. وللحصول على الإجماليات، قم بتجميعه على جانب العميل.

الحقل	النوع	القيمة	الوصف
rows	UVarInt	65535	عدد الصفوف
bytes	UVarInt	871799	عدد البايتات
total_rows	UVarInt	0	إجمالي الصفوف
wrote_rows	UVarInt	0	الصفوف الواردة من العميل
wrote_bytes	UVarInt	0	البايتات الواردة من العميل

​

Pong

استجابة إلى Ping الخاص بالعميل، ولا تتضمن جسم الحزمة.

​

نهاية الدفق

لن تُرسَل أي حزم Data أخرى، إذ جرى بث نتيجة الاستعلام بالكامل من الخادم إلى العميل.

لا يوجد جسم للحزمة.

​

معلومات profile

الحقل	النوع
rows	UVarInt
blocks	UVarInt
bytes	UVarInt
applied_limit	Bool
rows_before_limit	UVarInt
calculated_rows_before_limit	Bool

​

Log

كتلة بيانات تحتوي على سجل الخادم.

تُرمَّز على هيئة كتلة بيانات من الأعمدة، لكنها لا تُضغط مطلقًا.

العمود	النوع
time	DateTime
time_micro	UInt32
host_name	String
query_id	String
thread_id	UInt64
priority	Int8
source	String
text	String

​

أحداث profile

كتلة بيانات تحتوي على أحداث profile.

تُرمَّز على شكل كتلة بيانات من الأعمدة، لكنها لا تُضغط مطلقًا.

يكون نوع value هو UInt64 أو Int64، حسب إصدار الخادم.

العمود	النوع
host_name	String
current_time	DateTime
thread_id	UInt64
type	Int8
name	String
value	UInt64 or Int64