إعدادات جلسة http_*

هذه الإعدادات متاحة في system.settings، وقد تم إنشاؤها تلقائيًا من المصدر. عند تمكينه، تتعرّف واجهة HTTP على المكوّن /database/ في مسار URL وتستخدمه كقاعدة البيانات الحالية. هذا إعداد لكل مستخدم يتحكم في تفسير الطلبات الموجّهة بنمط المسار. أما التوجيه نفسه فيتحكم به على مستوى الخادم إعداد التكوين http_allow_path_requests (وهو معطّل افتراضيًا)، ويجب تمكينه لكي تتمكن واجهة HTTP من توجيه طلب بنمط المسار (مثل /my_db/my_table.csv) إلى معالج الاستعلامات أصلًا — إذ يُتخذ قرار التوجيه قبل مصادقة الطلب، ولذلك لا يمكن أن يعتمد على إعداد لكل مستخدم. عندما يكون http_allow_path_requests معطّلًا، تُرجع المسارات غير المعروفة استجابة 404 عادية. بعد التوجيه، يُعاد التحقق من هذا الإعداد وفقًا للإعدادات الفعالة للمستخدم الذي تمت مصادقته، لذا يمكن تمكينه انتقائيًا لكل مستخدم أو Role أو profile. عند تمكين هذا الإعداد، تتعرّف واجهة HTTP على المكوّنات /name=value/ في المسار (بنمط تقسيم Hive) وتحولها إلى عوامل تصفية مدمجة باستخدام AND. كما تتعرّف على المعاملات >, <, >=, <=, !=, <>. كما هو الحال مع http_allow_database_as_path، فإن هذا إعداد خاص بكل مستخدم؛ ويُتحكّم في توجيه الطلبات بنمط المسار على مستوى الخادم عبر إعداد التهيئة http_allow_path_requests (إذ يحدث التوجيه قبل المصادقة). عند تفعيله، تُعامل أي معلمة URL لا يُتعرّف عليها بوصفها معلمة معروفة أو إعدادًا أو بادئة param_* كعامل تصفية، وتُدمج باستخدام AND. يُقبل شكلان:

• يتحول name=value البسيط إلى تعبير مساواة `name` = 'value' (يُحاط المعرّف بعلامات اقتباس معكوسة، وتُقتبس القيمة كقيمة حرفية نصية).
• يجعل عامل المقارنة (!=، >، <، >=، <=، <>) منها مقارنة: إما بفصله عبر المعلمة (?a!=2، ?a>=2) أو بكتابته مباشرةً عندما لا يحتوي URL على = للفصل عنده (?a<>2، ?f(x)>3). وفي هذه الحالة، يُحلَّل name[=value] المُعاد تجميعه كتعبير SQL كامل.

عند تمكينه، تتعرّف واجهة HTTP على آخر مكوّن من مسار URL باعتباره اسم جدول بالصيغة table أو table.format أو table.format.compression. ويُفسَّر المسار على أنه SELECT * FROM table. مثل http_allow_database_as_path، يُعد هذا إعدادًا لكل مستخدم؛ ويُتحكَّم عالميًا في توجيه الطلبات بنمط المسار عبر إعداد التكوين http_allow_path_requests على مستوى الخادم (يحدث التوجيه قبل المصادقة). مهلة اتصال HTTP (بالثواني). القيم الممكنة:

• أي عدد صحيح موجب.
• 0 - معطّل (مهلة لا نهائية).

يتيح الإعداد http_make_head_request تنفيذ طلب HEAD عند قراءة البيانات عبر HTTP لاسترجاع معلومات عن الملف المطلوب قراءته، مثل حجمه. وبما أنه مُمكَّن افتراضيًا، فقد يكون من الأفضل تعطيل هذا الإعداد في الحالات التي لا يدعم فيها الخادم طلبات HEAD. يُفعِّل أو يعطِّل التحقق من صحة المجموع الاختباري عند فك ضغط بيانات HTTP POST الواردة من العميل. يُستخدم هذا فقط مع تنسيق الضغط الأصلي في ClickHouse (ولا يُستخدم مع gzip أو deflate). لمزيد من المعلومات، اقرأ وصف واجهة HTTP. القيم الممكنة:

• 0 — معطّل.
• 1 — مفعّل.

مهلة استقبال HTTP (بالثواني). القيم الممكنة:

• أي عدد صحيح موجب (بالثواني). 0 ليست مهلة لا نهائية، وقد تتسبب في فشل إعداد الاتصال (تتطلب مهلات مقبس POSIX فترة زمنية موجبة).

مهلة إرسال HTTP (بالثواني). القيم الممكنة:

• أي عدد صحيح موجب (بالثواني). لا تمثل القيمة 0 مهلة لا نهائية، وقد تتسبب في فشل إعداد الاتصال (تتطلب مهلات مقبس POSIX فترة زمنية موجبة).

تخطَّ عناوين URL لأنماط glob التي تُرجع الخطأ HTTP_NOT_FOUND فعِّل التخزين المؤقت لاستجابة HTTP على جانب الخادم. يكتب الاستثناء بتنسيق الإخراج لضمان إنتاج مخرجات صالحة. يعمل مع تنسيقات JSON وXML. يحدد مستوى ضغط البيانات في الاستجابة لطلب HTTP إذا كان enable_http_compression = 1. القيم الممكنة: أرقام من 1 إلى 12. تتطلب المستويات الأعلى من 9 البنية الافتراضية مع libdeflate؛ أما البنية من دون libdeflate فتدعم المستويات من 1 إلى 9.