> ## 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.

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

# PostgreSQLWire

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

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

يُحوِّل التنسيق `PostgreSQLWire` جزء مجموعة النتائج من بروتوكول PostgreSQL السلكي إلى تمثيل متسلسل. ويكتب
رسالة `RowDescription` تتضمن أسماء الأعمدة وأنواعها، تليها رسالة `DataRow` لكل صف في النتائج.
تستخدم القيم تمثيلها النصي، وتستخدم قيم `NULL` ترميز الحقل الفارغ في البروتوكول، وتُكتب القيم المنطقية على هيئة
`t` أو `f`.

هذا تنسيق ثنائي للإخراج فقط، ومخصص للعملاء المتصلين عبر
[واجهة PostgreSQL](/ar/concepts/features/interfaces/postgresql) في ClickHouse. تضبط الواجهة `PostgreSQLWire` كتنسيق افتراضي للجلسة
وتستخدمه عندما لا يتضمن الاستعلام عبارة `FORMAT` صريحة. وتتجاوز العبارة الصريحة الإعداد الافتراضي؛
ولا تُنتج تنسيقات الإخراج الأخرى مجموعة نتائج PostgreSQL صالحة. تكتب الواجهة رسائل البروتوكول المحيطة،
مثل رسائل المصادقة وإكمال الأمر والاستعداد للاستعلام. لا يُقصد من `PostgreSQLWire` عرض
نتائج الاستعلامات أو تخزينها في ملف مستقل.

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

بعد تفعيل واجهة PostgreSQL، استخدم عميلاً متوافقاً لتنفيذ استعلام:

```shell theme={null}
psql -p 9005 -h 127.0.0.1 -U default -d default \
    -c "SELECT number, number % 2 = 0 AS even FROM numbers(3)"
```

بما أن الاستعلام لا يتضمن عبارة `FORMAT`، ترسل الواجهة النتيجة باستخدام `PostgreSQLWire`.

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

يستخدم `PostgreSQLWire` إعدادات التسلسل النصي القياسية للقيم الفردية. ولا يتضمن إعدادات خاصة بالتنسيق
نفسه؛ إذ تُسلسَل القيم المنطقية دائمًا باستخدام تمثيلي PostgreSQL: `t` و`f`.