ODBCDriver2

تنسيق ODBCDriver2 هو تنسيق ثنائي للإخراج فقط، يُستخدم لنقل نتائج الاستعلامات عبر HTTP إلى برنامج تشغيل ClickHouse لـ ODBC. يطلبه برنامج التشغيل بتعيين default_format إلى ODBCDriver2؛ ولا يختاره المستخدمون مباشرةً في العادة.

جميع الأعداد الصحيحة في الدفق قيم موقَّعة من 32 بت، مُرمَّزة بترتيب البايتات قليل النهاية. تُرمَّز السلسلة النصية بطولها بالبايتات، متبوعًا ببايتاتها. للإخراج البنية التالية:

1. القيمة 2، التي تشير إلى وجود صفَّي ترويسة بعدها.
2. ترويسة الأسماء، وتحتوي على القيمة number_of_columns + 1، والسلسلة النصية name، واسم كل عمود.
3. ترويسة الأنواع، وتحتوي على القيمة number_of_columns + 1، والسلسلة النصية type، واسم كل نوع بيانات في ClickHouse. تُزال الأغلفة LowCardinality من أسماء هذه الأنواع.
4. صفوف البيانات. يحتوي كل صف على قيمة واحدة مُسلسلة نصيًا ومسبوقة بطولها لكل عمود في نتيجة الاستعلام. لا تتضمن صفوف البيانات عدد صفوفها أو أعمدتها، وينتهي الدفق عند EOF.

تُرمَّز قيمة NULL بطول -1؛ أما السلسلة الفارغة غير NULL فطولها 0. تستخدم الإجماليات، عند وجودها، ترميز الصف نفسه وتأتي بعد الصفوف العادية.

يوضح الاستعلام التالي القيم التي تغطيها اختبارات التنسيق:

SELECT
    1 AS x,
    [2, 3] AS y,
    'Hello' AS z,
    NULL AS a
FORMAT ODBCDriver2

بما أن النتيجة ثنائية، فأعد توجيهها إلى ملف بدلاً من الطرفية:

clickhouse-client --query \
    "SELECT 1 AS x, [2, 3] AS y, 'Hello' AS z, NULL AS a FORMAT ODBCDriver2" \
    > result.bin

في الاستخدام المعتاد، يضيف برنامج التشغيل default_format=ODBCDriver2 إلى طلبات HTTP التي يرسلها، ثم يفك ترميز الاستجابة.

يستخدم ODBCDriver2 إعدادات التسلسل النصي القياسية للقيم المفردة. ولا يتضمن أي إعدادات خاصة بالتنسيق نفسه.