> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> وثائق تنسيق ODBCDriver2

# ODBCDriver2

| الإدخال | الإخراج | الاسم المستعار |
| ------- | ------- | -------------- |
| ✗       | ✔       |                |

<div id="description">
  ## الوصف
</div>

تنسيق `ODBCDriver2` هو تنسيق ثنائي للإخراج فقط، يُستخدم لنقل نتائج الاستعلامات عبر HTTP إلى
[برنامج تشغيل ClickHouse لـ `ODBC`](/ar/concepts/features/interfaces/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`. تستخدم الإجماليات، عند وجودها،
ترميز الصف نفسه وتأتي بعد الصفوف العادية.

<div id="example-usage">
  ## مثال على الاستخدام
</div>

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

```sql theme={null}
SELECT
    1 AS x,
    [2, 3] AS y,
    'Hello' AS z,
    NULL AS a
FORMAT ODBCDriver2
```

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

```shell theme={null}
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 التي يرسلها، ثم يفك ترميز الاستجابة.

<div id="format-settings">
  ## إعدادات التنسيق
</div>

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