Skip to main content

الوصف

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

مثال على الاستخدام

بعد تفعيل واجهة PostgreSQL، استخدم عميلاً متوافقاً لتنفيذ استعلام:
بما أن الاستعلام لا يتضمن عبارة FORMAT، ترسل الواجهة النتيجة باستخدام PostgreSQLWire.

إعدادات التنسيق

يستخدم PostgreSQLWire إعدادات التسلسل النصي القياسية للقيم الفردية. ولا يتضمن إعدادات خاصة بالتنسيق نفسه؛ إذ تُسلسَل القيم المنطقية دائمًا باستخدام تمثيلي PostgreSQL: t وf.
آخر تعديل في ١٤ أغسطس ٢٠٢٦