> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # إعدادات التنسيقات > إعدادات تتحكم في تنسيقات الإدخال والإخراج. export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => { const cells = [["النوع", {type}], ["القيمة الافتراضية", {default_value}]]; if (changeable_without_restart) { const isYes = String(changeable_without_restart).trim().toLowerCase() === "yes"; const badge = isYes ? نعم : لا; cells.push(["يمكن تغييره دون إعادة التشغيل", badge]); } return {cells.map(([h]) => )} {cells.map(([h, v]) => )}

{h}
{v}

; }; export const galaxyOnClick = eventName => () => { try { if (typeof window !== "undefined" && window.galaxy && eventName) { window.galaxy.track(eventName, { interaction: "click" }); } } catch (e) {} }; export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => { if (link) { return Beta ; } return

ميزة Beta. مزيد من المعلومات.

; }; export const ExperimentalBadge = () => { return

ميزة تجريبية. تعرّف على المزيد.

; }; تُنشأ هذه الإعدادات تلقائيًا من [الشفرة المصدرية](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/FormatFactorySettings.h).

## allow\_special\_bool\_values\_inside\_variant

يسمح بتحليل قيم Bool ضمن النوع Variant من قيم Bool النصية الخاصة مثل "on" و"off" و"enable" و"disable" وما إلى ذلك.

## bool\_false\_representation

النص المستخدم لتمثيل القيمة المنطقية false في تنسيقات TSV/CSV/Vertical/Pretty.

## bool\_true\_representation

النص المستخدم لتمثيل القيمة المنطقية `true` في تنسيقات TSV/CSV/Vertical/Pretty.

## check\_conversion\_from\_numbers\_to\_enum

يتم طرح استثناء أثناء التحويل من Numbers إلى Enum إذا لم تكن القيمة موجودة في Enum. القيم الممكنة: * 0 — معطّل. * 1 — مفعّل. **مثال** ```text theme={null} CREATE TABLE tab ( val Enum('first' = 1, 'second' = 2, 'third' = 3) ) ENGINE = Memory; INSERT INTO tab SETTINGS check_conversion_from_numbers_to_enum = 1 VALUES (4); -- returns an error ```

## column\_names\_for\_schema\_inference

قائمة أسماء الأعمدة المستخدمة في استنتاج المخطط للتنسيقات التي لا تتضمن أسماء أعمدة. التنسيق: 'column1,column2,column3,...'

## date\_time\_64\_output\_format\_cut\_trailing\_zeros\_align\_to\_groups\_of\_thousands

قصّ الأصفار اللاحقة في قيم datetime64 ديناميكيًا لضبط مقياس الإخراج إلى \[0, 3, 6]، بما يتوافق مع 'الثواني' و'المللي ثانية' و'الميكروثانية'

## date\_time\_input\_format

يتيح اختيار محلّل للتمثيل النصي للتاريخ والوقت. لا ينطبق هذا الإعداد على [دوال التاريخ والوقت](/ar/reference/functions/regular-functions/date-time-functions). القيم الممكنة: * `'best_effort'` — يفعّل التحليل الموسّع. يمكن لـ ClickHouse تحليل التنسيق الأساسي `YYYY-MM-DD HH:MM:SS` وجميع تنسيقات التاريخ والوقت وفق [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). على سبيل المثال، `'2018-06-08T01:02:03.000Z'`. * `'best_effort_us'` — مشابه لـ `best_effort` (راجع الفرق في [parseDateTimeBestEffortUS](/ar/reference/functions/regular-functions/type-conversion-functions#parseDateTimeBestEffortUS) * `'basic'` — يستخدم المحلّل الأساسي. يمكن لـ ClickHouse تحليل التنسيق الأساسي `YYYY-MM-DD HH:MM:SS` أو `YYYY-MM-DD` فقط. على سبيل المثال، `2019-08-20 10:18:56` أو `2019-08-20`. راجع أيضًا: * [نوع البيانات DateTime.](/ar/reference/data-types/datetime) * [دوال التعامل مع التواريخ والأوقات.](/ar/reference/functions/regular-functions/date-time-functions)

## date\_time\_output\_format

يسمح باختيار تنسيقات إخراج مختلفة للتمثيل النصي للتاريخ والوقت. القيم الممكنة: * `simple` - تنسيق إخراج بسيط. يُخرج ClickHouse التاريخ والوقت بتنسيق `YYYY-MM-DD hh:mm:ss`. على سبيل المثال، `2019-08-20 10:18:56`. يُجرى الحساب وفقًا للمنطقة الزمنية الخاصة بنوع البيانات (إن وُجدت) أو المنطقة الزمنية الخاصة بالخادم. * `iso` - تنسيق إخراج ISO. يُخرج ClickHouse التاريخ والوقت بتنسيق [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) `YYYY-MM-DDThh:mm:ssZ`. على سبيل المثال، `2019-08-20T10:18:56Z`. لاحظ أن الإخراج يكون بتوقيت UTC (`Z` تعني UTC). * `unix_timestamp` - تنسيق إخراج Unix timestamp. يُخرج ClickHouse التاريخ والوقت بتنسيق [Unix timestamp](https://en.wikipedia.org/wiki/Unix_time). على سبيل المثال، `1566285536`. راجع أيضًا: * [نوع البيانات DateTime.](/ar/reference/data-types/datetime) * [دوال العمل مع التواريخ والأوقات.](/ar/reference/functions/regular-functions/date-time-functions)

## date\_time\_overflow\_behavior

يحدّد هذا الإعداد السلوك عند تحويل [Date](/ar/reference/data-types/date) و[Date32](/ar/reference/data-types/date32) و[DateTime](/ar/reference/data-types/datetime) و[DateTime64](/ar/reference/data-types/datetime64) أو الأعداد الصحيحة إلى Date أو Date32 أو DateTime أو DateTime64، عندما يتعذّر تمثيل القيمة في النوع الناتج. القيم الممكنة: * `ignore` — تجاهل الفيض بصمت. النتيجة غير معرّفة. * `throw` — رفع استثناء عند حدوث فيض. * `saturate` — تشبيع النتيجة. إذا كانت القيمة أصغر من أصغر قيمة يمكن أن يمثّلها النوع الهدف، فستكون النتيجة هي أصغر قيمة قابلة للتمثيل. وإذا كانت القيمة أكبر من أكبر قيمة يمكن أن يمثّلها النوع الهدف، فستكون النتيجة هي أكبر قيمة قابلة للتمثيل. القيمة الافتراضية: `ignore`.

## errors\_output\_format

طريقة كتابة الأخطاء في المخرجات النصية.

## format\_avro\_schema\_registry\_connection\_timeout

لتنسيق AvroConfluent: مهلة الاتصال، بالثواني، لعميل HTTP الخاص بـ Confluent Schema Registry. يُستخدم ذلك لكلٍّ من جلب المخطط وتسجيله. يجب أن تكون القيمة أكبر من 0 وأقل من 600 (10 دقائق).

## format\_avro\_schema\_registry\_max\_retries

بالنسبة إلى تنسيق AvroConfluent: الحد الأقصى لعدد مرات إعادة المحاولة عند حدوث إخفاقات عابرة عند التواصل مع Confluent Schema Registry (مهلات النقل، رفض الاتصال، أخطاء DNS، HTTP 5xx/408/429). اضبطه على 0 لتعطيل إعادة المحاولة. الحد الأقصى المسموح به هو 20. لا تتم إعادة المحاولة في أخطاء التحقق من المخطط (HTTP 409، ‏Avro JSON غير صالح البنية).

## format\_avro\_schema\_registry\_receive\_timeout

لتنسيق AvroConfluent: مهلة الاستقبال بالثواني لعميل HTTP الخاص بـ Confluent Schema Registry. تُستخدم لكلٍّ من جلب المخطط وتسجيله. يجب أن تكون أكبر من 0 وأقل من 600 (10 دقائق).

## format\_avro\_schema\_registry\_retry\_initial\_backoff\_ms

لتنسيق AvroConfluent: فترة التراجع الأولية بالملي ثانية قبل إعادة محاولة طلب فاشل إلى Confluent Schema Registry. وتتضاعف فترة التراجع مع كل إعادة محاولة لاحقة، بحد أقصى 10 ثوانٍ. ويجب أن تكون أكبر من 0 وأقل من أو تساوي 60000.

## format\_avro\_schema\_registry\_send\_timeout

لتنسيق AvroConfluent: مهلة الإرسال، بالثواني، لعميل HTTP الخاص بـ Confluent Schema Registry. تُستخدم لكلٍّ من مخطط fetch ومخطط registration. يجب أن تكون أكبر من 0 وأقل من 600 (10 دقائق).

## format\_avro\_schema\_registry\_url

لتنسيق AvroConfluent: عنوان URL الخاص بـ Confluent Schema Registry.

## format\_binary\_max\_array\_size

الحد الأقصى المسموح به لحجم Array بتنسيق RowBinary. يمنع ذلك تخصيص كميات كبيرة من الذاكرة في حال كانت البيانات تالفة. وتعني القيمة 0 عدم وجود حد.

## format\_binary\_max\_object\_size

العدد الأقصى المسموح به للمسارات في كائن واحد ضمن تنسيق RowBinary لنوع JSON. يمنع ذلك تخصيص قدر كبير من الذاكرة في حال كانت البيانات تالفة. وتعني القيمة 0 عدم وجود حد.

## format\_binary\_max\_string\_size

الحد الأقصى المسموح به لحجم String في صيغة تنسيق RowBinary. يمنع ذلك تخصيص كميات كبيرة من الذاكرة في حالة البيانات التالفة. تعني القيمة 0 عدم وجود حد

## format\_capn\_proto\_enum\_comparising\_mode

كيفية ربط Enum في ClickHouse مع Enum في CapnProto

## format\_capn\_proto\_max\_message\_size

الحد الأقصى لحجم رسالة CapnProto واحدة، بالبايت. يحمي هذا من البيانات سيئة التكوين أو التالفة التي قد تتسبب في تخصيص مفرط للذاكرة. القيمة الافتراضية هي 1 GiB.

## format\_capn\_proto\_use\_autogenerated\_schema

استخدم مخطط CapnProto الذي جرى إنشاؤه تلقائيًا عند عدم تعيين `format_schema`

## format\_csv\_allow\_double\_quotes

إذا كانت القيمة مضبوطة على true، فاسمح بالسلاسل النصية بين علامتَي اقتباس مزدوجتَين.

## format\_csv\_allow\_single\_quotes

إذا ضُبط هذا الإعداد على true، فاسمح بالسلاسل النصية المحاطة بعلامات اقتباس مفردة.

## format\_csv\_delimiter

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

## format\_csv\_null\_representation

تمثيل مخصّص للقيمة NULL بتنسيق CSV

## format\_custom\_escaping\_rule

قاعدة إفلات الحقول (لتنسيق CustomSeparated)

## format\_custom\_field\_delimiter

الفاصل بين الحقول (في تنسيق CustomSeparated)

## format\_custom\_result\_after\_delimiter

اللاحقة بعد مجموعة النتائج (لتنسيق CustomSeparated)

## format\_custom\_result\_before\_delimiter

البادئة التي تسبق مجموعة النتائج (لتنسيق CustomSeparated)

## format\_custom\_row\_after\_delimiter

الفاصل بعد حقل العمود الأخير (لتنسيق CustomSeparated)

## format\_custom\_row\_before\_delimiter

الفاصل الذي يسبق حقل العمود الأول (في تنسيق CustomSeparated)

## format\_custom\_row\_between\_delimiter

الفاصل بين الصفوف (لتنسيق CustomSeparated)

## format\_display\_secrets\_in\_show\_and\_select

يُفعِّل أو يعطِّل إظهار القيم السرية في استعلامات `SHOW` و`SELECT` الخاصة بالجداول، وقواعد البيانات، ودوال الجداول، والقواميس. يجب أيضًا أن يكون لدى المستخدم الذي يرغب في رؤية القيم السرية [`display_secrets_in_show_and_select` إعداد الخادم](/ar/reference/settings/server-settings/settings#display_secrets_in_show_and_select) مفعّلًا، وأن يمتلك امتياز [`displaySecretsInShowAndSelect`](/ar/reference/statements/grant#displaysecretsinshowandselect). القيم الممكنة: * 0 — معطّل. * 1 — مفعّل.

## format\_json\_object\_each\_row\_column\_for\_object\_name

اسم العمود الذي سيُستخدم لتخزين/كتابة أسماء العناصر بتنسيق [JSONObjectEachRow](/ar/reference/formats/JSON/JSONObjectEachRow). يجب أن يكون نوع العمود String. وإذا كانت القيمة فارغة، فستُستخدم الأسماء الافتراضية `row_{i}` كأسماء للعناصر.

## format\_protobuf\_use\_autogenerated\_schema

استخدم Protobuf المُولَّد تلقائيًا إذا لم يتم تعيين format\_schema

## format\_regexp

التعبير النمطي (لصيغة Regexp)

## format\_regexp\_escaping\_rule

قاعدة إفلات الحقل (لتنسيق Regexp)

## format\_regexp\_skip\_unmatched

تجاوز الأسطر غير المطابقة للتعبير النمطي (لتنسيق Regexp)

## format\_schema

تكون هذه المعلمة مفيدة عند استخدام تنسيقات تتطلب تعريف مخطط، مثل [Cap'n Proto](https://capnproto.org/) أو [Protobuf](https://developers.google.com/protocol-buffers/). وتعتمد القيمة على التنسيق.

## format\_schema\_message\_name

حدِّد اسم الرسالة المطلوبة في المخطّط المعرَّف في `format_schema`. للحفاظ على التوافق مع تنسيق `format_schema` القديم (`file_name:message_name`): * إذا لم يتم تحديد `format_schema_message_name`، فسيُستنتج اسم الرسالة من جزء `message_name` في قيمة `format_schema` القديمة. * إذا تم تحديد `format_schema_message_name` أثناء استخدام التنسيق القديم، فسيتم الإبلاغ عن خطأ.

## format\_schema\_source

حدِّد مصدر `format_schema`. القيم الممكنة: * 'file' (الافتراضي): تكون `format_schema` اسم ملف مخطط موجود في الدليل `format_schemas`. * 'string': تكون `format_schema` هي المحتوى الحرفي للمخطط. * 'query': تكون `format_schema` استعلامًا لاسترجاع المخطط. عند ضبط `format_schema_source` على 'query'، تنطبق الشروط التالية: * يجب أن يُرجع الاستعلام قيمة واحدة فقط: صفًا واحدًا يتضمن عمودًا نصيًا واحدًا. * تُعامَل نتيجة الاستعلام على أنها محتوى المخطط. * تُخزَّن هذه النتيجة مؤقتًا محليًا في الدليل `format_schemas`. * يمكنك مسح ذاكرة التخزين المؤقت المحلية باستخدام الأمر: `SYSTEM DROP FORMAT SCHEMA CACHE FOR Files`. * بعد تخزينها مؤقتًا، لا تُنفَّذ الاستعلامات المتطابقة مرة أخرى لجلب المخطط حتى تُمسَح ذاكرة التخزين المؤقت صراحةً * بالإضافة إلى ملفات ذاكرة التخزين المؤقت المحلية، تُخزَّن رسائل Protobuf أيضًا مؤقتًا في الذاكرة. وحتى بعد مسح ملفات ذاكرة التخزين المؤقت المحلية، يجب مسح ذاكرة التخزين المؤقت الموجودة في الذاكرة باستخدام `SYSTEM DROP FORMAT SCHEMA CACHE [FOR Protobuf]` لتحديث المخطط بالكامل. * شغّل الاستعلام `SYSTEM DROP FORMAT SCHEMA CACHE` لمسح ذاكرة التخزين المؤقت لكلٍّ من ملفات التخزين المؤقت ومخططات رسائل Protobuf دفعةً واحدة.

## format\_template\_resultset

مسار الملف الذي يحتوي على سلسلة التنسيق لمجموعة النتائج (لتنسيق Template)

## format\_template\_resultset\_format

سلسلة التنسيق لمجموعة النتائج (لتنسيق Template)

## format\_template\_row

المسار إلى الملف الذي يحتوي على سلسلة التنسيق للصفوف (لتنسيق تنسيق Template)

## format\_template\_row\_format

سلسلة تنسيق الصفوف (لتنسيق Template)

## format\_template\_rows\_between\_delimiter

الفاصل بين الصفوف (لتنسيق Template)

## format\_tsv\_null\_representation

تمثيل مخصص للقيمة NULL في تنسيق TSV

## input\_format\_allow\_errors\_num

يحدّد الحد الأقصى لعدد الأخطاء المسموح بها عند القراءة من التنسيقات النصية (CSV وTSV وما إلى ذلك). القيمة الافتراضية هي 0. احرص دائمًا على إقرانه مع `input_format_allow_errors_ratio`. إذا حدث خطأ أثناء قراءة الصفوف، لكن ظلّ عدّاد الأخطاء أقل من `input_format_allow_errors_num`، فسيتجاهل ClickHouse الصف وينتقل إلى الصف التالي. إذا تم تجاوز كلٍّ من `input_format_allow_errors_num` و`input_format_allow_errors_ratio`، فسيطرح ClickHouse استثناءً.

## input\_format\_allow\_errors\_ratio

يحدّد الحد الأقصى للنسبة المئوية المسموح بها من الأخطاء عند القراءة من التنسيقات النصية (CSV وTSV وما إلى ذلك). تُحدَّد نسبة الأخطاء كعدد ذي فاصلة عائمة بين 0 و1. القيمة الافتراضية هي 0. استخدمه دائمًا مع `input_format_allow_errors_num`. إذا حدث خطأ أثناء قراءة الصفوف، لكن ظلّ عدّاد الأخطاء أقل من `input_format_allow_errors_ratio`، فإن ClickHouse يتجاهل الصف وينتقل إلى الصف التالي. إذا تم تجاوز كلٍّ من `input_format_allow_errors_num` و`input_format_allow_errors_ratio`، فإن ClickHouse يُصدر استثناءً.

## input\_format\_allow\_seeks

السماح بعمليات seek (أو القراءة بالنطاقات) عند قراءة تنسيقات الإدخال ORC وParquet وArrow. عند التمكين، وإذا كان المصدر يدعم ذلك (مثل ملف محلي أو S3 أو HTTP مع دعم النطاقات وحجم معروف)، يمكن لـ ClickHouse قراءة نطاقات البايت المطلوبة فقط واستخدام ذاكرة أقل. عند التعطيل، أو عندما لا يدعم المصدر عمليات seek (مثل عدم توفر حجم الملف أو إذا كان التدفق غير قابل لإعادة التموضع)، قد تلجأ بعض أدوات القراءة إلى تحميل الملف بالكامل في الذاكرة. مُمكَّن افتراضيًا.

## input\_format\_arrow\_allow\_missing\_columns

السماح بالأعمدة المفقودة عند قراءة تنسيقات إدخال Arrow

## input\_format\_arrow\_case\_insensitive\_column\_matching

تجاهل حالة الأحرف عند مطابقة أعمدة Arrow مع أعمدة CH.

## input\_format\_arrow\_skip\_columns\_with\_unsupported\_types\_in\_schema\_inference

تخطَّ الأعمدة ذات الأنواع غير المدعومة عند استنتاج المخطط لتنسيق Arrow

## input\_format\_avro\_allow\_missing\_fields

في تنسيق Avro/AvroConfluent: عند عدم العثور على الحقل في المخطط، تُستخدم القيمة الافتراضية بدلًا من إرجاع خطأ

## input\_format\_avro\_null\_as\_default

لتنسيق Avro/AvroConfluent: أدرِج القيمة الافتراضية عند وجود `null` في عمود غير Nullable

## input\_format\_binary\_decode\_types\_in\_binary\_format

قراءة أنواع البيانات بالتنسيق الثنائي بدلًا من أسماء الأنواع في تنسيق الإدخال RowBinaryWithNamesAndTypes

## input\_format\_binary\_max\_type\_complexity

الحد الأقصى لعدد عُقد الأنواع عند فك ترميز الأنواع الثنائية (ليس العمق، بل العدد الإجمالي). `Map(String, UInt32)` = 3 عُقد. يوفّر حماية من المدخلات الضارة. 0 = غير محدود.

## input\_format\_binary\_read\_json\_as\_string

قراءة قيم نوع البيانات [JSON](/ar/reference/data-types/newjson) كقيم [String](/ar/reference/data-types/string) بتنسيق الإدخال RowBinary.

## input\_format\_bson\_skip\_fields\_with\_unsupported\_types\_in\_schema\_inference

تخطّي الحقول ذات الأنواع غير المدعومة أثناء استنتاج المخطط لتنسيق BSON.

## input\_format\_capn\_proto\_skip\_fields\_with\_unsupported\_types\_in\_schema\_inference

تخطّي الأعمدة ذات الأنواع غير المدعومة أثناء استنتاج المخطط لتنسيق CapnProto

## input\_format\_column\_name\_matching\_mode

يحدّد وضع مطابقة أسماء الأعمدة عند إدخال البيانات عبر تنسيقات مختلفة (بما في ذلك، على سبيل المثال لا الحصر، JSONEachRow و CSVWithNames و JSONColumns و BSONEachRow و RowBinaryWithNames). الأوضاع المدعومة: * match\_case: مطابقة حساسة لحالة الأحرف * ignore\_case: مطابقة غير حساسة لحالة الأحرف * auto: يحاول أولًا المطابقة مع مراعاة حالة الأحرف، وإذا فشل، يحاول المطابقة دون مراعاة حالة الأحرف.

## input\_format\_connection\_handling

عند تمكين هذا الخيار، إذا انقطع الاتصال بشكل غير متوقع، فسيجري تحليل أي بيانات متبقية في المخزن المؤقت ومعالجتها بدلًا من اعتبارها خطأ يؤدي تمكين هذا الخيار إلى تعطيل التحليل المتوازي ويجعل إزالة التكرار غير ممكنة

## input\_format\_csv\_allow\_cr\_end\_of\_line

إذا ضُبطت القيمة على true، فسيُسمح باستخدام \r في نهاية السطر من دون أن يتبعه

## input\_format\_csv\_allow\_variable\_number\_of\_columns

تجاهل الأعمدة الإضافية في إدخال CSV (إذا كان الملف يحتوي على أعمدة أكثر من المتوقّع)، واعتبر الحقول المفقودة في إدخال CSV قيماً افتراضية

## input\_format\_csv\_allow\_whitespace\_or\_tab\_as\_delimiter

السماح باستخدام المسافات وعلامات الجدولة (\t) كمحدد للحقول في سلاسل CSV

## input\_format\_csv\_arrays\_as\_nested\_csv

عند قراءة Array من CSV، يُتوقَّع أن عناصره قد جرى تحويلها إلى تمثيل تسلسلي بتنسيق CSV متداخل ثم وُضعت داخل سلسلة نصية. مثال: "\[""Hello"", ""world"", ""42"""" TV""]". يمكن حذف الأقواس المربعة المحيطة بالمصفوفة.

## input\_format\_csv\_deserialize\_separate\_columns\_into\_tuple

إذا تم تعيينه على true، فيمكن فك تسلسل الأعمدة المنفصلة المكتوبة بتنسيق CSV إلى عمود Tuple.

## input\_format\_csv\_detect\_header

اكتشاف الترويسة التي تتضمن الأسماء والأنواع تلقائيًا في تنسيق CSV

## input\_format\_csv\_empty\_as\_default

تعامل مع الحقول الفارغة في إدخال CSV على أنها قيم افتراضية.

## input\_format\_csv\_enum\_as\_number

اعتبار قيم enum المُدرجة في تنسيقات CSV على أنها فهارس enum

## input\_format\_csv\_skip\_first\_lines

تجاهل عددًا محددًا من الأسطر في بداية البيانات بتنسيق CSV

## input\_format\_csv\_skip\_trailing\_empty\_lines

تخطي الأسطر الفارغة الختامية في تنسيق CSV

## input\_format\_csv\_trim\_whitespaces

يزيل المسافات وأحرف علامات الجدولة (\t) من بداية سلاسل CSV ونهايتها

## input\_format\_csv\_try\_infer\_numbers\_from\_strings

إذا كان هذا الإعداد ممكّنًا، فسيحاول ClickHouse أثناء استدلال المخطط استنتاج الأعداد من الحقول النصية. وقد يكون ذلك مفيدًا إذا كانت بيانات CSV تحتوي على أعداد UInt64 بين علامتَي اقتباس. يكون معطّلًا افتراضيًا.

## input\_format\_csv\_try\_infer\_strings\_from\_quoted\_tuples

فسِّر Tuples المحاطة بعلامتَي اقتباس في بيانات الإدخال على أنها قيمة من النوع String.

## input\_format\_csv\_use\_best\_effort\_in\_schema\_inference

يستخدم بعض التحسينات والأساليب الاستدلالية لاستنتاج المخطط في تنسيق CSV

## input\_format\_csv\_use\_default\_on\_bad\_values

يسمح بتعيين القيمة الافتراضية للعمود عند فشل إلغاء تسلسل حقل CSV بسبب قيمة غير صالحة

## input\_format\_custom\_allow\_variable\_number\_of\_columns

تجاهل الأعمدة الإضافية في مُدخل CustomSeparated (إذا كان الملف يحتوي على أعمدة أكثر من المتوقع)، واعتبر الحقول المفقودة في مُدخل CustomSeparated قيماً افتراضية

## input\_format\_custom\_detect\_header

يكتشف تلقائيًا صف الرأس الذي يحتوي على الأسماء والأنواع في تنسيق CustomSeparated

## input\_format\_custom\_skip\_trailing\_empty\_lines

تجاهل الأسطر الفارغة الختامية في تنسيق CustomSeparated

## input\_format\_defaults\_for\_omitted\_fields

عند تنفيذ استعلامات `INSERT`، تُستبدل قيم أعمدة الإدخال المُهملة بالقيم الافتراضية للأعمدة المقابلة. ينطبق هذا الخيار على تنسيقات [JSONEachRow](/ar/reference/formats/JSON/JSONEachRow) (وتنسيقات JSON الأخرى)، و[CSV](/ar/reference/formats/CSV/CSV)، و[TabSeparated](/ar/reference/formats/TabSeparated/TabSeparated)، و[TSKV](/ar/reference/formats/TabSeparated/TSKV)، و[Parquet](/ar/reference/formats/Parquet/Parquet)، و[Arrow](/ar/reference/formats/Arrow/Arrow)، و[Avro](/ar/reference/formats/Avro/Avro)، و[ORC](/ar/reference/formats/ORC)، و[Native](/ar/reference/formats/Native)، والتنسيقات ذات اللواحق `WithNames`/`WithNamesAndTypes`. عند تفعيل هذا الخيار، تُرسَل بيانات تعريف الجدول الموسَّعة من الخادم إلى العميل. ويستهلك ذلك موارد حوسبة إضافية على الخادم، وقد يؤثر سلبًا في الأداء. القيم الممكنة: * 0 — معطّل. * 1 — مفعّل.

## input\_format\_force\_null\_for\_omitted\_fields

فرض تهيئة الحقول المُغفلة بقيم NULL

## input\_format\_geojson\_unsupported\_geometry\_handling

يتحكم هذا الإعداد في ما يحدث عندما يلزم تخزين نوع شكل هندسي صالح من `GeoJSON` لا يمكن تمثيله بالنوع `Geometry` في ClickHouse (مثل `GeometryCollection` أو `MultiPoint`) في العمود `geometry` أثناء قراءة مُدخلات `GeoJSON`. القيم الممكنة: * `'throw'` (الافتراضي) — طرح استثناء. * `'null'` — إدراج قيمة `NULL` في العمود `geometry` ومتابعة التحليل. ينطبق هذا فقط عندما يكون العمود `geometry` materialized. أما إذا لم يكن عمود إخراج مطلوبًا، فسيتم التحقق من صحة هذا الشكل الهندسي من حيث البنية، لكنه لا يفعّل آلية المعالجة هذه.

## input\_format\_hive\_text\_allow\_variable\_number\_of\_columns

تجاهل الأعمدة الإضافية في إدخال Hive Text (إذا كان الملف يحتوي على أعمدة أكثر من المتوقع)، واعتبر الحقول المفقودة في إدخال Hive Text قيماً افتراضية

## input\_format\_hive\_text\_collection\_items\_delimiter

الفاصل بين عناصر المجموعات (array أو map) في Hive Text File

## input\_format\_hive\_text\_fields\_delimiter

الفاصل بين الحقول في تنسيق Hive Text File

## input\_format\_hive\_text\_map\_keys\_delimiter

الفاصل بين كل زوج مفتاح/قيمة في Map ضمن Hive Text File

## input\_format\_import\_nested\_json

يُمكّن أو يعطّل إدراج بيانات JSON ذات الكائنات المتداخلة. التنسيقات المدعومة: * [JSONEachRow](/ar/reference/formats/JSON/JSONEachRow) القيم الممكنة: * 0 — معطّل. * 1 — مفعّل. انظر أيضًا: * [استخدام البُنى المتداخلة](/ar/guides/clickhouse/data-formats/json/formats#accessing-nested-json-objects) مع تنسيق `JSONEachRow`.

## input\_format\_ipv4\_default\_on\_conversion\_error

ستُستخدم القيم الافتراضية عند إلغاء تسلسل IPv4 بدلًا من طرح استثناء عند حدوث خطأ في التحويل. يكون معطّلًا افتراضيًا.

## input\_format\_ipv6\_default\_on\_conversion\_error

سيُستخدم فك تسلسل IPV6 القيمَ الافتراضية بدلًا من إطلاق استثناء عند حدوث خطأ في التحويل. معطّل افتراضيًا.

## input\_format\_json\_compact\_allow\_variable\_number\_of\_columns

السماح بعدد متغيّر من الأعمدة في الصفوف ضمن تنسيقات الإدخال JSONCompact/JSONCompactEachRow. تجاهل الأعمدة الإضافية في الصفوف التي تحتوي على أعمدة أكثر من العدد المتوقع، واعتبر الأعمدة المفقودة قيماً افتراضية. معطّل افتراضياً.

## input\_format\_json\_defaults\_for\_missing\_elements\_in\_named\_tuple

يُدرِج القيم الافتراضية للعناصر المفقودة في كائن JSON أثناء تحليل Tuple مُسمّى. لا يعمل هذا الإعداد إلا عند تمكين الإعداد `input_format_json_named_tuples_as_objects`. مُمكَّن افتراضيًا.

## input\_format\_json\_empty\_as\_default

عند التمكين، تُستبدل حقول الإدخال الفارغة في JSON بالقيم الافتراضية. وبالنسبة إلى تعبيرات القيم الافتراضية المعقدة، يجب أيضاً تمكين `input_format_defaults_for_omitted_fields`. القيم الممكنة: * 0 — تعطيل. * 1 — تمكين.

## input\_format\_json\_ignore\_unknown\_keys\_in\_named\_tuple

تجاهل المفاتيح غير المعروفة في كائن JSON عند استخدام Tupleات مُسمّاة. مفعّل افتراضيًا.

## input\_format\_json\_ignore\_unnecessary\_fields

تجاهل الحقول غير الضرورية وعدم تحليلها. قد لا يؤدي تمكين هذا الخيار إلى إطلاق استثناءات عند وجود سلاسل JSON ذات تنسيق غير صالح أو حقول مكررة

## input\_format\_json\_infer\_array\_of\_dynamic\_from\_array\_of\_different\_types

إذا كان مفعّلًا، فسيستخدم ClickHouse أثناء استدلال المخطط النوع Array(Dynamic) لمصفوفات JSON التي تتضمن قيمًا من أنواع بيانات مختلفة. مثال: ```sql theme={null} SET input_format_json_infer_array_of_dynamic_from_array_of_different_types=1; DESC format(JSONEachRow, '{"a" : [42, "hello", [1, 2, 3]]}'); ``` ```response theme={null} ┌─name─┬─type───────────┐ │ a │ Array(Dynamic) │ └──────┴────────────────┘ ``` ```sql theme={null} SET input_format_json_infer_array_of_dynamic_from_array_of_different_types=0; DESC format(JSONEachRow, '{"a" : [42, "hello", [1, 2, 3]]}'); ``` ```response theme={null} ┌─name─┬─type─────────────────────────────────────────────────────────────┐ │ a │ Tuple(Nullable(Int64), Nullable(String), Array(Nullable(Int64))) │ └──────┴──────────────────────────────────────────────────────────────────┘ ``` مفعّل بشكل افتراضي.

## input\_format\_json\_infer\_incomplete\_types\_as\_strings

السماح باستخدام النوع String لمفاتيح JSON التي لا تحتوي في عيّنة البيانات إلا على `Null`/`{}`/`[]` أثناء استدلال المخطط. في تنسيقات JSON، يمكن قراءة أي قيمة على أنها String، ويمكننا تجنب الأخطاء مثل `Cannot determine type for column 'column_name' by first 25000 rows of data, most likely this column contains only Nulls or empty Arrays/Maps` أثناء استدلال المخطط باستخدام النوع String للمفاتيح ذات الأنواع غير المعروفة. مثال: ```sql theme={null} SET input_format_json_infer_incomplete_types_as_strings = 1, input_format_json_try_infer_named_tuples_from_objects = 1; DESCRIBE format(JSONEachRow, '{"obj" : {"a" : [1,2,3], "b" : "hello", "c" : null, "d" : {}, "e" : []}}'); SELECT * FROM format(JSONEachRow, '{"obj" : {"a" : [1,2,3], "b" : "hello", "c" : null, "d" : {}, "e" : []}}'); ``` النتيجة: ``` ┌─name─┬─type───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐ │ obj │ Tuple(a Array(Nullable(Int64)), b Nullable(String), c Nullable(String), d Nullable(String), e Array(Nullable(String))) │ │ │ │ │ │ └──────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘ ┌─obj────────────────────────────┐ │ ([1,2,3],'hello',NULL,'{}',[]) │ └────────────────────────────────┘ ``` مفعّل افتراضيًا.

## input\_format\_json\_map\_as\_array\_of\_tuples

فك تسلسل أعمدة Map على شكل مصفوفات JSON من نوع Tuple. معطّل افتراضيًا.

## input\_format\_json\_max\_depth

الحد الأقصى لعمق الحقل في JSON. هذا ليس حدًا صارمًا، ولا يجب تطبيقه بدقة تامة.

## input\_format\_json\_named\_tuples\_as\_objects

حلّل الأعمدة من نوع Tuple مُسمّى باعتبارها كائنات JSON. مفعّل افتراضيًا.

## input\_format\_json\_read\_arrays\_as\_strings

السماح بتحليل مصفوفات JSON كسلاسل نصية في تنسيقات إدخال JSON. مثال: ```sql theme={null} SET input_format_json_read_arrays_as_strings = 1; SELECT arr, toTypeName(arr), JSONExtractArrayRaw(arr)[3] from format(JSONEachRow, 'arr String', '{"arr" : [1, "Hello", [1,2,3]]}'); ``` النتيجة: ``` ┌─arr───────────────────┬─toTypeName(arr)─┬─arrayElement(JSONExtractArrayRaw(arr), 3)─┐ │ [1, "Hello", [1,2,3]] │ String │ [1,2,3] │ └───────────────────────┴─────────────────┴───────────────────────────────────────────┘ ``` مُفعَّل بشكل افتراضي.

## input\_format\_json\_read\_bools\_as\_numbers

السماح بتفسير القيم المنطقية كأرقام في تنسيقات إدخال JSON. مفعّل افتراضيًا.

## input\_format\_json\_read\_bools\_as\_strings

السماح بتحليل القيم المنطقية باعتبارها سلاسل نصية في تنسيقات إدخال JSON. مفعّل افتراضيًا.

## input\_format\_json\_read\_numbers\_as\_strings

السماح بتحليل الأرقام كسلاسل نصية في تنسيقات إدخال JSON. مُمكَّن افتراضيًا.

## input\_format\_json\_read\_objects\_as\_strings

السماح بتحليل كائنات JSON كسلاسل نصية في تنسيقات إدخال JSON. مثال: ```sql theme={null} SET input_format_json_read_objects_as_strings = 1; CREATE TABLE test (id UInt64, obj String, date Date) ENGINE=Memory(); INSERT INTO test FORMAT JSONEachRow {"id" : 1, "obj" : {"a" : 1, "b" : "Hello"}, "date" : "2020-01-01"}; SELECT * FROM test; ``` النتيجة: ``` ┌─id─┬─obj──────────────────────┬───────date─┐ │ 1 │ {"a" : 1, "b" : "Hello"} │ 2020-01-01 │ └────┴──────────────────────────┴────────────┘ ``` مُفعَّل بشكل افتراضي.

## input\_format\_json\_throw\_on\_bad\_escape\_sequence

يتم طرح استثناء إذا كانت سلسلة JSON تحتوي على تسلسل إفلات غير صحيح في تنسيقات إدخال JSON. وإذا كان هذا الخيار معطّلًا، فستبقى تسلسلات الإفلات غير الصحيحة كما هي في البيانات. مفعّل افتراضيًا.

## input\_format\_json\_try\_infer\_named\_tuples\_from\_objects

إذا كان هذا الإعداد مُمكّنًا، فسيحاول ClickHouse أثناء استدلال المخطط استنتاج Tuple مُسمّى من كائنات JSON. وسيحتوي الـ Tuple المُسمّى الناتج على جميع العناصر من كل كائنات JSON المقابلة في بيانات العيّنة. مثال: ```sql theme={null} SET input_format_json_try_infer_named_tuples_from_objects = 1; DESC format(JSONEachRow, '{"obj" : {"a" : 42, "b" : "Hello"}}, {"obj" : {"a" : 43, "c" : [1, 2, 3]}}, {"obj" : {"d" : {"e" : 42}}}') ``` النتيجة: ``` ┌─name─┬─type───────────────────────────────────────────────────────────────────────────────────────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐ │ obj │ Tuple(a Nullable(Int64), b Nullable(String), c Array(Nullable(Int64)), d Tuple(e Nullable(Int64))) │ │ │ │ │ │ └──────┴────────────────────────────────────────────────────────────────────────────────────────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘ ``` مفعّل تلقائيًا.

## input\_format\_json\_try\_infer\_numbers\_from\_strings

إذا كان هذا الإعداد مُمكّنًا، فسيحاول ClickHouse أثناء استدلال المخطط استنتاج الأرقام من الحقول النصية. وقد يكون ذلك مفيدًا إذا كانت بيانات JSON تحتوي على أرقام UInt64 بين علامتَي اقتباس. مُعطّل افتراضيًا.

## input\_format\_json\_use\_string\_type\_for\_ambiguous\_paths\_in\_named\_tuples\_inference\_from\_objects

استخدم النوع String بدلًا من استثناء عند وجود مسارات غير واضحة في كائنات JSON أثناء استنتاج Tuples المسماة

## input\_format\_json\_validate\_types\_from\_metadata

بالنسبة إلى تنسيقات الإدخال JSON/JSONCompact/JSONColumnsWithMetadata، إذا كان هذا الإعداد مضبوطًا على 1، فستُقارَن الأنواع المستمدة من البيانات الوصفية في بيانات الإدخال بأنواع الأعمدة المقابلة في الجدول. مفعّل افتراضيًا.

## input\_format\_max\_block\_size\_bytes

يحدّ من حجم الكتل المتكوّنة أثناء تحليل البيانات في تنسيقات الإدخال، بالبايت. ويُستخدم في تنسيقات الإدخال المعتمدة على الصفوف عندما تتكوّن الكتلة من جهة ClickHouse. تعني القيمة 0 عدم وجود حدّ بالبايت.

## input\_format\_max\_block\_wait\_ms

يحدّد الحد الأقصى لوقت الانتظار، بالمللي ثانية، قبل إصدار كتلة بيانات أثناء التحليل في تنسيقات الإدخال المعتمدة على الصفوف. وتعني القيمة 0 عدم وجود حد. لا يعمل هذا الخيار إلا إذا كان `input_format_connection_handling` مفعّلًا. كما أن تعيين قيمة له يعطّل التحليل المتوازي ويجعل deduplication غير ممكن. بالنسبة إلى inserts المتدفقة، يجب أيضًا تعيين `min_insert_block_size_rows=0` و `min_insert_block_size_bytes=0`. وإلا فقد تستمر كتل البيانات التي تم تحليلها في التراكم في الذاكرة خلال مرحلة squashing للكتل إلى أن يتم بلوغ تلك thresholds، مما يمنع تنفيذ inserts في الوقت المناسب. **مثال: بث أحدث تغييرات Wikipedia إلى ClickHouse** ```bash theme={null} clickhouse-client --query 'CREATE TABLE wikipedia_edits (data JSON)' curl -sS --globoff -H 'Accept: application/json' --no-buffer \ 'https://stream.wikimedia.org/v2/stream/recentchange' \ | clickhouse-client \ --query 'INSERT INTO wikipedia_edits FORMAT JSONAsObject' \ --input_format_max_block_wait_ms 1000 \ --input_format_connection_handling 1 \ --min_insert_block_size_rows 0 \ --min_insert_block_size_bytes 0 ```

## input\_format\_max\_bytes\_to\_read\_for\_schema\_inference

الحد الأقصى لكمية البيانات، بالبايت، التي يمكن قراءتها للاستدلال التلقائي على المخطط.

## input\_format\_max\_rows\_to\_read\_for\_schema\_inference

الحد الأقصى لعدد صفوف البيانات التي ستُقرأ للاستدلال التلقائي على المخطط.

## input\_format\_msgpack\_number\_of\_columns

عدد الأعمدة في بيانات MsgPack المُدخلة. يُستخدم لاستنتاج المخطط تلقائيًا من البيانات.

## input\_format\_mysql\_dump\_map\_column\_names

طابِق الأعمدة في تفريغ MySQL مع الأعمدة في جدول ClickHouse حسب الأسماء

## input\_format\_mysql\_dump\_table\_name

اسم الجدول في ملف تفريغ MySQL الذي تُقرأ منه البيانات

## input\_format\_native\_allow\_types\_conversion

السماح بتحويل أنواع البيانات في تنسيق الإدخال Native

## input\_format\_native\_decode\_types\_in\_binary\_format

قراءة أنواع البيانات بالصيغة الثنائية بدلًا من أسماء الأنواع في تنسيق الإدخال Native

## input\_format\_null\_as\_default

يؤدي هذا الإعداد إلى تمكين أو تعطيل تهيئة الحقول ذات القيمة [NULL](/ar/reference/syntax#literals) باستخدام [القيم الافتراضية](/ar/reference/statements/create/table#default_values)، إذا كان نوع بيانات هذه الحقول غير [Nullable](/ar/reference/data-types/nullable). إذا كان نوع العمود غير Nullable وكان هذا الإعداد معطّلًا، فإن إدراج `NULL` يؤدي إلى حدوث استثناء. أما إذا كان نوع العمود Nullable، فتُدرَج قيم `NULL` كما هي، بغض النظر عن هذا الإعداد. ينطبق هذا الإعداد على معظم تنسيقات الإدخال. بالنسبة إلى تعبيرات القيم الافتراضية المعقدة، يجب أيضًا تمكين `input_format_defaults_for_omitted_fields`. القيم الممكنة: * 0 — يؤدي إدراج `NULL` في عمود غير Nullable إلى حدوث استثناء. * 1 — تُهيَّأ الحقول ذات القيمة `NULL` باستخدام القيم الافتراضية للعمود.

## input\_format\_orc\_allow\_missing\_columns

السماح بالأعمدة المفقودة عند قراءة تنسيقات إدخال ORC

## input\_format\_orc\_case\_insensitive\_column\_matching

تجاهل حالة الأحرف الكبيرة والصغيرة عند مطابقة أعمدة ORC مع أعمدة CH.

## input\_format\_orc\_dictionary\_as\_low\_cardinality

تعامل مع الأعمدة المرمّزة بقاموس ORC باعتبارها أعمدة LowCardinality أثناء قراءة ملفات ORC.

## input\_format\_orc\_filter\_push\_down

عند قراءة ملفات ORC، يتم تخطي شرائط كاملة أو مجموعات صفوف استنادًا إلى تعبيرات WHERE/PREWHERE، أو إحصاءات الحد الأدنى/الحد الأقصى، أو مرشح بلوم في البيانات الوصفية لـ ORC.

## input\_format\_orc\_reader\_time\_zone\_name

اسم المنطقة الزمنية لقارئ صفوف ORC؛ والمنطقة الزمنية الافتراضية لهذا القارئ هي GMT.

## input\_format\_orc\_row\_batch\_size

حجم الدفعة أثناء قراءة شرائط ORC.

## input\_format\_orc\_skip\_columns\_with\_unsupported\_types\_in\_schema\_inference

تخطَّ الأعمدة ذات الأنواع غير المدعومة عند استدلال المخطط لتنسيق ORC

## input\_format\_orc\_use\_fast\_decoder

استخدم تنفيذًا أسرع لوحدة فك ترميز ORC.

## input\_format\_parallel\_parsing

يُفعِّل أو يُعطِّل التحليل المتوازي لتنسيقات البيانات مع الحفاظ على الترتيب. وهو مدعوم فقط لتنسيقات [TabSeparated (TSV)](/ar/reference/formats/TabSeparated/TabSeparated) و[TSKV](/ar/reference/formats/TabSeparated/TSKV) و[CSV](/ar/reference/formats/CSV/CSV) و[JSONEachRow](/ar/reference/formats/JSON/JSONEachRow). القيم الممكنة: * 1 — مُمكَّن. * 0 — مُعطَّل.

## input\_format\_parquet\_allow\_geoparquet\_parser

استخدم محلل الأعمدة الجغرافية لتحويل Array(UInt8) إلى أنواع Point/Linestring/Polygon/MultiLineString/MultiPolygon

## input\_format\_parquet\_allow\_missing\_columns

السماح بالأعمدة المفقودة عند قراءة تنسيق إدخال Parquet

## input\_format\_parquet\_bloom\_filter\_push\_down

عند قراءة ملفات Parquet، يتم تخطي مجموعات الصفوف بأكملها استنادًا إلى تعبير WHERE ومرشح bloom filter في البيانات الوصفية لـ Parquet.

## input\_format\_parquet\_case\_insensitive\_column\_matching

تجاهل حالة الأحرف عند مطابقة أعمدة Parquet مع أعمدة CH.

## input\_format\_parquet\_enable\_json\_parsing

عند قراءة ملفات Parquet، فسّر أعمدة JSON باستخدام عمود JSON في ClickHouse.

## input\_format\_parquet\_enable\_row\_group\_prefetch

تمكين الجلب المسبق لمجموعات الصفوف أثناء تحليل Parquet. حاليًا، لا يدعم الجلب المسبق سوى التحليل أحادي الخيط.

## input\_format\_parquet\_filter\_push\_down

عند قراءة ملفات Parquet، تُتخطّى مجموعات الصفوف كاملةً استنادًا إلى تعبيرات WHERE/PREWHERE وإحصاءات الحد الأدنى/الحد الأقصى في البيانات الوصفية لـ Parquet.

## input\_format\_parquet\_local\_file\_min\_bytes\_for\_seek

الحد الأدنى من البايتات المطلوب للقراءة المحلية (ملف) لتنفيذ عملية seek، بدلًا من القراءة مع التجاهل في تنسيق إدخال Parquet

## input\_format\_parquet\_local\_time\_as\_utc

يحدّد نوع البيانات الذي يستخدمه استدلال المخطط لطوابع Parquet الزمنية عندما تكون isAdjustedToUTC=false. إذا كانت القيمة true: ‏DateTime64(..., 'UTC')، وإذا كانت false: ‏DateTime64(...). لا يُعد أيّ من السلوكين صحيحًا تمامًا، لأن ClickHouse لا يوفّر نوع بيانات للوقت المحلي وفق الساعة الفعلية. وعلى نحو غير بديهي، يُرجَّح أن يكون الخيار 'true' أقلَّ خطأً، لأن تنسيق الطابع الزمني 'UTC' باعتباره String سيُنتج تمثيلًا للوقت المحلي الصحيح.

## input\_format\_parquet\_max\_block\_size

الحد الأقصى لحجم الكتلة لقارئ Parquet.

## input\_format\_parquet\_memory\_high\_watermark

الحد التقريبي للذاكرة لقارئ Parquet v3. يقيّد عدد مجموعات الصفوف أو الأعمدة التي يمكن قراءتها بالتوازي. عند قراءة عدة ملفات ضمن استعلام واحد، يُطبَّق هذا الحد على إجمالي استخدام الذاكرة لجميع تلك الملفات.

## input\_format\_parquet\_memory\_low\_watermark

يتم جدولة عمليات الجلب المسبق بشكل أكثر كثافة إذا كان استخدام الذاكرة أقل من العتبة. وقد يكون هذا مفيدًا، على سبيل المثال، إذا كان هناك العديد من مرشحات bloom الصغيرة لقراءتها عبر الشبكة.

## input\_format\_parquet\_page\_filter\_push\_down

تخطَّ الصفحات استنادًا إلى القيم الصغرى/العظمى في فهرس العمود.

## input\_format\_parquet\_prefer\_block\_bytes

متوسط حجم الكتلة بالبايتات الذي يُخرجه قارئ Parquet

## input\_format\_parquet\_preserve\_order

تجنّب إعادة ترتيب الصفوف عند القراءة من ملفات Parquet. لا يُنصح بهذا لأن ترتيب الصفوف لا يكون مضمونًا عادةً، كما أن أجزاءً أخرى من مسار تنفيذ الاستعلام قد تُخلّ به. استخدم `ORDER BY _row_number` بدلًا من ذلك.

## input\_format\_parquet\_skip\_columns\_with\_unsupported\_types\_in\_schema\_inference

تجاهَل الأعمدة ذات الأنواع غير المدعومة عند استنتاج المخطط لتنسيق Parquet

## input\_format\_parquet\_use\_offset\_index

تعديل طفيف على طريقة قراءة الصفحات من ملف Parquet عند عدم استخدام تصفية الصفحات.

## input\_format\_parquet\_verify\_checksums

تحقّق من المجاميع الاختبارية للصفحات عند قراءة ملفات Parquet.

## input\_format\_protobuf\_flatten\_google\_wrappers

فعِّل مغلِّفات Google للأعمدة العادية غير المتداخلة، مثل google.protobuf.StringValue 'str' للعمود String ‏'str'. بالنسبة إلى الأعمدة Nullable، تُفسَّر المغلِّفات الفارغة على أنها القيم الافتراضية، بينما تُعامَل القيم المفقودة على أنها NULL

## input\_format\_protobuf\_oneof\_presence

يحدّد أي حقل من protobuf oneof تم العثور عليه، وذلك من خلال تعيين قيمة enum في عمود خاص

## input\_format\_protobuf\_skip\_fields\_with\_unsupported\_types\_in\_schema\_inference

تخطَّ الحقول ذات الأنواع غير المدعومة عند استنتاج المخطط لتنسيق Protobuf

## input\_format\_record\_errors\_file\_path

مسار الملف المستخدم لتسجيل الأخطاء أثناء قراءة التنسيقات النصية (CSV، TSV).

## input\_format\_skip\_unknown\_fields

يُمكّن أو يعطّل تخطي إدراج البيانات الزائدة. عند كتابة البيانات، يُطلق ClickHouse استثناءً إذا كانت بيانات الإدخال تحتوي على أعمدة غير موجودة في الجدول الهدف. وإذا كان التخطي مُمكّنًا، فلن يُدرج ClickHouse البيانات الزائدة ولن يُطلق استثناءً. التنسيقات المدعومة: * [JSONEachRow](/ar/reference/formats/JSON/JSONEachRow) (وتنسيقات JSON الأخرى) * [BSONEachRow](/ar/reference/formats/BSONEachRow) (وتنسيقات JSON الأخرى) * [TSKV](/ar/reference/formats/TabSeparated/TSKV) * جميع التنسيقات التي تحمل اللواحق WithNames/WithNamesAndTypes * [MySQLDump](/ar/reference/formats/MySQLDump) * [Native](/ar/reference/formats/Native) القيم الممكنة: * 0 — معطّل. * 1 — مُمكّن.

## input\_format\_try\_infer\_dates

إذا كان هذا الإعداد مُمكّنًا، فسيحاول ClickHouse استنتاج النوع `Date` من الحقول النصية أثناء استنتاج المخطط في التنسيقات النصية. وإذا جرى تحليل جميع الحقول في أحد الأعمدة ضمن بيانات الإدخال بنجاح على أنها تواريخ، فسيكون النوع الناتج `Date`، أما إذا تعذّر تحليل حقل واحد على الأقل على أنه تاريخ، فسيكون النوع الناتج `String`. مُمكّن افتراضيًا.

## input\_format\_try\_infer\_datetimes

إذا كان مفعّلًا، فسيحاول ClickHouse استنتاج النوع `DateTime64` من الحقول النصية أثناء استنتاج المخطط في التنسيقات النصية. إذا جرى تحليل جميع الحقول في أحد الأعمدة ضمن بيانات الإدخال بنجاح على أنها قيم datetime، فسيكون النوع الناتج `DateTime64`، أما إذا تعذّر تحليل حقل واحد على الأقل على أنه datetime، فسيكون النوع الناتج `String`. مفعّل افتراضيًا.

## input\_format\_try\_infer\_datetimes\_only\_datetime64

عند تمكين input\_format\_try\_infer\_datetimes، يُستنتج DateTime64 فقط دون أنواع DateTime

## input\_format\_try\_infer\_exponent\_floats

حاوِل استنتاج القيم العائمة بالتدوين الأسي أثناء استنتاج المخطط في التنسيقات النصية (باستثناء JSON، حيث تُستنتج الأعداد بالتدوين الأسي دائمًا)

## input\_format\_try\_infer\_integers

إذا كان هذا الخيار مُمكّنًا، فسيحاول ClickHouse استنتاج الأعداد الصحيحة بدلًا من الأعداد ذات الفاصلة العائمة أثناء استنتاج المخطط في التنسيقات النصية. إذا كانت جميع الأرقام في العمود ضمن بيانات الإدخال أعدادًا صحيحة، فسيكون نوع النتيجة `Int64`، أما إذا وُجد رقم واحد على الأقل ذو فاصلة عائمة، فسيكون نوع النتيجة `Float64`. مُمكّن افتراضيًا.

## input\_format\_try\_infer\_variants

إذا كان مُمكّنًا، فسيحاول ClickHouse استنتاج النوع [`Variant`](/ar/reference/data-types/variant) ضمن استنتاج المخطط لتنسيقات النص عندما يكون هناك أكثر من نوع محتمل لعناصر العمود/المصفوفة. القيم الممكنة: * 0 — معطّل. * 1 — مُمكّن.

## input\_format\_tsv\_allow\_variable\_number\_of\_columns

تجاهل الأعمدة الإضافية في إدخال TSV (إذا كان الملف يحتوي على أعمدة أكثر من المتوقّع)، واعتبر الحقول المفقودة في إدخال TSV قيماً افتراضية

## input\_format\_tsv\_crlf\_end\_of\_line

إذا تم ضبطه على true، فستقرأ الدالة file تنسيق TSV باستخدام \r\n بدلًا من \n.

## input\_format\_tsv\_detect\_header

اكتشاف ترويسة تتضمن الأسماء والأنواع في تنسيق TSV تلقائيًا

## input\_format\_tsv\_empty\_as\_default

اعتبر الحقول الفارغة في إدخال TSV قيماً افتراضية.

## input\_format\_tsv\_enum\_as\_number

تعامل مع قيم enum المُدرجة في تنسيقات TSV باعتبارها فهارس enum.

## input\_format\_tsv\_skip\_first\_lines

تخطي عدد الأسطر المحدد في بداية البيانات بتنسيق TSV

## input\_format\_tsv\_skip\_trailing\_empty\_lines

تخطّي الأسطر الفارغة الختامية في تنسيق TSV

## input\_format\_tsv\_use\_best\_effort\_in\_schema\_inference

استخدم بعض التحسينات والقواعد الاستدلالية لاستنتاج المخطط في تنسيق TSV

## input\_format\_values\_accurate\_types\_of\_literals

في تنسيق Values: عند تحليل التعبيرات وتفسيرها باستخدام القالب، تحقّق من النوع الفعلي للقيمة الحرفية لتجنّب مشكلات تجاوز السعة والدقة المحتملة.

## input\_format\_values\_deduce\_templates\_of\_expressions

بالنسبة إلى تنسيق Values: إذا تعذّر تحليل الحقل بواسطة streaming parser، فشغّل SQL parser، واستنتج قالب تعبير SQL، ثم حاول تحليل جميع الصفوف باستخدام القالب، وبعد ذلك فسّر التعبير لجميع الصفوف.

## input\_format\_values\_interpret\_expressions

بالنسبة إلى تنسيق Values: إذا تعذّر على محلل التدفق تحليل الحقل، فشغِّل محلل SQL وحاول تفسيره كتعبير SQL.

## input\_format\_with\_names\_use\_header

يُفعّل أو يعطّل التحقق من ترتيب الأعمدة عند إدراج البيانات. لتحسين أداء الإدراج، نوصي بتعطيل هذا التحقق إذا كنت متأكدًا من أن ترتيب أعمدة بيانات الإدخال مطابق لما هو موجود في الجدول الهدف. التنسيقات المدعومة: * [CSVWithNames](/ar/reference/formats/CSV/CSVWithNames) * [CSVWithNamesAndTypes](/ar/reference/formats/CSV/CSVWithNamesAndTypes) * [TabSeparatedWithNames](/ar/reference/formats/TabSeparated/TabSeparatedWithNames) * [TabSeparatedWithNamesAndTypes](/ar/reference/formats/TabSeparated/TabSeparatedWithNamesAndTypes) * [JSONCompactEachRowWithNames](/ar/reference/formats/JSON/JSONCompactEachRowWithNames) * [JSONCompactEachRowWithNamesAndTypes](/ar/reference/formats/JSON/JSONCompactEachRowWithNamesAndTypes) * [JSONCompactStringsEachRowWithNames](/ar/reference/formats/JSON/JSONCompactStringsEachRowWithNames) * [JSONCompactStringsEachRowWithNamesAndTypes](/ar/reference/formats/JSON/JSONCompactStringsEachRowWithNamesAndTypes) * [RowBinaryWithNames](/ar/reference/formats/RowBinary/RowBinaryWithNames) * [RowBinaryWithNamesAndTypes](/ar/reference/formats/RowBinary/RowBinaryWithNamesAndTypes) * [CustomSeparatedWithNames](/ar/reference/formats/CustomSeparated/CustomSeparatedWithNames) * [CustomSeparatedWithNamesAndTypes](/ar/reference/formats/CustomSeparated/CustomSeparatedWithNamesAndTypes) القيم الممكنة: * 0 — معطّل. * 1 — مُمكّن.

## input\_format\_with\_types\_use\_header

يحدد ما إذا كان محلل التنسيق سيتحقق من تطابق أنواع البيانات في بيانات الإدخال مع أنواع البيانات في الجدول الهدف. التنسيقات المدعومة: * [CSVWithNamesAndTypes](/ar/reference/formats/CSV/CSVWithNamesAndTypes) * [TabSeparatedWithNamesAndTypes](/ar/reference/formats/TabSeparated/TabSeparatedWithNamesAndTypes) * [JSONCompactEachRowWithNamesAndTypes](/ar/reference/formats/JSON/JSONCompactEachRowWithNamesAndTypes) * [JSONCompactStringsEachRowWithNamesAndTypes](/ar/reference/formats/JSON/JSONCompactStringsEachRowWithNamesAndTypes) * [RowBinaryWithNamesAndTypes](/ar/reference/formats/RowBinary/RowBinaryWithNamesAndTypes) * [CustomSeparatedWithNamesAndTypes](/ar/reference/formats/CustomSeparated/CustomSeparatedWithNamesAndTypes) القيم الممكنة: * 0 — معطّل. * 1 — مُمكّن.

## insert\_distributed\_one\_random\_shard

يُفعِّل أو يعطِّل الإدراج العشوائي في إحدى الشظايا عند الإدراج في جدول [Distributed](/ar/reference/engines/table-engines/special/distributed) في حال عدم وجود مفتاح توزيع. افتراضيًا، عند إدراج البيانات في جدول `Distributed` يحتوي على أكثر من شظية واحدة، يرفض خادم ClickHouse أي طلب إدراج إذا لم يكن هناك مفتاح توزيع. وعند ضبط `insert_distributed_one_random_shard = 1`، يُسمح بعمليات الإدراج وتُوجَّه البيانات عشوائيًا إلى جميع الشظايا. القيم الممكنة: * 0 — يُرفض الإدراج إذا كانت هناك عدة شظايا ولم يتم تحديد مفتاح توزيع. * 1 — يتم الإدراج عشوائيًا بين جميع الشظايا المتاحة عند عدم تحديد مفتاح توزيع.

## interval\_output\_format

يتيح اختيار تنسيقات إخراج مختلفة للتمثيل النصي لأنواع interval. القيم الممكنة: * `kusto` - تنسيق إخراج بأسلوب KQL. يعرض ClickHouse قيم interval بتنسيق [KQL](https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-timespan-format-strings#the-constant-c-format-specifier). على سبيل المثال، ستُنسَّق `toIntervalDay(2)` على الشكل `2.00:00:00`. يُرجى ملاحظة أنه بالنسبة إلى أنواع interval ذات الطول المتغير (مثل `IntervalMonth` و`IntervalYear`)، يُؤخَذ في الاعتبار متوسط عدد الثواني لكل interval. * `numeric` - تنسيق إخراج رقمي. يعرض ClickHouse قيم interval وفق تمثيلها الرقمي الداخلي. على سبيل المثال، ستُنسَّق `toIntervalDay(2)` على الشكل `2`. انظر أيضًا: * [Interval](/ar/reference/data-types/special-data-types/interval)

## into\_outfile\_create\_parent\_directories

يُنشئ المجلدات الأصلية تلقائيًا عند استخدام INTO OUTFILE إذا لم تكن موجودة مسبقًا.

## json\_type\_escape\_dots\_in\_keys

عند تفعيل هذا الإعداد، تُفلَت النقاط في مفاتيح JSON أثناء التحليل.

## max\_dynamic\_subcolumns\_in\_json\_type\_parsing

الحد الأقصى لعدد الأعمدة الفرعية الديناميكية التي يمكن إنشاؤها في كل عمود عند تحليل عمود JSON. يتيح ذلك التحكم في عدد الأعمدة الفرعية الديناميكية أثناء التحليل، بغض النظر عن المعلَمات الديناميكية المحددة في نوع البيانات.

## output\_format\_always\_write\_decimal\_point\_in\_float\_and\_decimal

يطبع الفاصلة العشرية دائمًا للأعداد ذات الفاصلة العائمة وأعداد Decimal في التنسيقات النصية، حتى عندما تكون القيمة عددًا صحيحًا. على سبيل المثال، يُخرج `1.` بدلًا من `1`. هذا الإعداد معطّل افتراضيًا.

## output\_format\_arrow\_compression\_method

طريقة الضغط المستخدمة لتنسيق إخراج Arrow. برامج الترميز المدعومة: lz4\_frame وzstd وnone (غير مضغوط)

## output\_format\_arrow\_date\_as\_uint16

اكتب قيم Date كأرقام 16 بت عادية (تُقرأ مجددًا كـ UInt16)، بدلًا من تحويلها إلى نوع Arrow DATE32 ‏32 بت (تُقرأ مجددًا كـ Date32).

## output\_format\_arrow\_fixed\_string\_as\_fixed\_byte\_array

استخدم نوع Arrow ‏FIXED\_SIZE\_BINARY بدلًا من Binary لأعمدة FixedString.

## output\_format\_arrow\_low\_cardinality\_as\_dictionary

تمكين إخراج النوع LowCardinality كنوع Dictionary Arrow

## output\_format\_arrow\_string\_as\_string

استخدم نوع Arrow String بدلًا من Binary لأعمدة String

## output\_format\_arrow\_unsupported\_types\_as\_binary

يُخرِج الأنواع التي لا يتوفر لها تحويل على هيئة بيانات ثنائية خام. إذا كانت القيمة false، فستؤدي هذه الأنواع إلى ظهور استثناء UNKNOWN\_TYPE.

## output\_format\_arrow\_use\_64\_bit\_indexes\_for\_dictionary

استخدم دائمًا أعدادًا صحيحة 64 بت لفهارس القواميس بتنسيق Arrow

## output\_format\_arrow\_use\_signed\_indexes\_for\_dictionary

استخدم الأعداد الصحيحة الموقَّعة لفهارس القواميس بتنسيق Arrow

## output\_format\_avro\_codec

برنامج ترميز الضغط المستخدَم للإخراج. القيم الممكنة: 'null'، و'deflate'، و'snappy'، و'zstd'.

## output\_format\_avro\_confluent\_subject

بالنسبة إلى تنسيق إخراج AvroConfluent: اسم الموضوع الذي يُسجَّل المخطط ضمنه في Confluent Schema Registry. وهو مطلوب عند كتابة إخراج AvroConfluent.

## output\_format\_avro\_rows\_in\_file

الحد الأقصى لعدد الصفوف في الملف (إذا كان التخزين يسمح بذلك)

## output\_format\_avro\_string\_column\_pattern

لتنسيق Avro: التعبير النمطي لأعمدة String المطلوب اختيارها كسلسلة AVRO.

## output\_format\_avro\_sync\_interval

فاصل المزامنة، بالبايت.

## output\_format\_binary\_encode\_types\_in\_binary\_format

كتابة أنواع البيانات بالتنسيق الثنائي بدلًا من أسماء الأنواع في تنسيق الإخراج RowBinaryWithNamesAndTypes

## output\_format\_binary\_write\_json\_as\_string

تُكتب قيم نوع البيانات [JSON](/ar/reference/data-types/newjson) كقيم [String](/ar/reference/data-types/string) بتنسيق JSON في تنسيق الإخراج RowBinary.

## output\_format\_bson\_string\_as\_string

استخدم النوع BSON String بدلًا من Binary في الأعمدة من النوع String.

## output\_format\_compression\_level

مستوى الضغط الافتراضي إذا كانت مخرجات الاستعلام مضغوطة. يُطبَّق هذا الإعداد عندما يتضمن استعلام `SELECT` ‎`INTO OUTFILE` أو عند الكتابة إلى دوال الجداول `file` و`url` و`hdfs` و`s3` و`azureBlobStorage`. القيم الممكنة: من `1` إلى `22`

## output\_format\_compression\_zstd\_window\_log

يمكن استخدامه عندما تكون طريقة ضغط المخرجات هي `zstd`. إذا كانت القيمة أكبر من `0`، فإن هذا الإعداد يحدد صراحةً حجم نافذة الضغط (أساس `2`) ويفعّل وضع المدى الطويل لضغط zstd. ويمكن أن يساعد ذلك في تحقيق نسبة ضغط أفضل. القيم الممكنة: أعداد غير سالبة. لاحظ أنه إذا كانت القيمة صغيرة جدًا أو كبيرة جدًا، فستُطلق `zstdlib` استثناءً. وتتراوح القيم المعتادة من `20` (window size = `1MB`) إلى `30` (window size = `1GB`).

## output\_format\_csv\_crlf\_end\_of\_line

إذا ضُبطت القيمة على true، فستكون نهاية السطر في تنسيق CSV هي \r\n بدلًا من \n.

## output\_format\_csv\_serialize\_tuple\_into\_separate\_columns

إذا ضُبط هذا الإعداد على true، فستُسلسَل Tuples في تنسيق CSV كأعمدة منفصلة (أي يُفقد تداخلها داخل Tuple)

## output\_format\_decimal\_trailing\_zeros

يُخرج الأصفار اللاحقة عند طباعة قيم Decimal. على سبيل المثال: 1.230000 بدلًا من 1.23. مُعطّل افتراضيًا.

## output\_format\_float\_precision

عندما تكون القيمة غير صفرية، تُنسَّق مخرجات الأعداد ذات الفاصلة العائمة (`Float32` و`Float64` و`BFloat16`) بحيث لا يزيد عدد الخانات بعد الفاصلة العشرية على هذا العدد (مع إزالة الأصفار اللاحقة). وعندما تكون القيمة 0 (وهي القيمة الافتراضية)، يُستخدم أقصر تمثيل يضمن التحويل ذهابًا وإيابًا. أما القيم الكبيرة جدًا التي لا يناسبها التدوين الثابت، والقيم الصغيرة جدًا من حيث المقدار بحيث إن التقريب إلى الدقة المطلوبة سيؤدي إلى فقدان جميع الخانات المعنوية (أي سيصبح الجزء المعنوي `±0`)، فتُخرَج بالتدوين العلمي بدلًا من ذلك. وفي حالات الرجوع الاحتياطي هذه، قد يحتوي الجزء المعنوي على عدد من الخانات الكسرية أكبر من العدد المطلوب. النطاق الصالح: من 0 إلى 100.

## output\_format\_image\_height

ارتفاع صورة الإخراج، بالبكسل، لتنسيقات إخراج الصور مثل `PNG`. القيمة الافتراضية: 1024.

## output\_format\_image\_terminal\_mode

بالنسبة إلى تنسيقات إخراج الصور مثل `PNG`، أخرج الصورة مباشرةً إلى الطرفية باستخدام بروتوكول الصور المضمّنة بدلًا من كتابة البايتات الخام للصورة. القيم الممكنة: * \`\` (فارغ) — اكتب البايتات الخام للصورة (الافتراضي). * `iterm` — استخدم بروتوكول الصور المضمّنة في iTerm2. * `kitty` — استخدم بروتوكول الرسومات في Kitty. * `sixel` — استخدم بروتوكول Sixel. * `auto` — إذا كان الإخراج إلى طرفية، فاكتشف إمكاناتها واستخدم `iterm` أو `kitty` أو `sixel` (بهذا الترتيب)؛ وإلا فاكتب البايتات الخام للصورة. القيمة الافتراضية: \`\` (فارغ).

## output\_format\_image\_width

عرض صورة الإخراج، بالبكسل، لتنسيقات إخراج الصور مثل `PNG`. القيمة الافتراضية: 1024.

## output\_format\_json\_array\_of\_rows

يتيح إخراج جميع الصفوف كمصفوفة JSON بتنسيق [JSONEachRow](/ar/reference/formats/JSON/JSONEachRow). القيم الممكنة: * 1 — يُخرج ClickHouse جميع الصفوف كمصفوفة، بحيث يكون كل صف بتنسيق `JSONEachRow`. * 0 — يُخرج ClickHouse كل صف على حدة بتنسيق `JSONEachRow`. **مثال على استعلام مع تمكين هذا الإعداد** الاستعلام: ```sql theme={null} SET output_format_json_array_of_rows = 1; SELECT number FROM numbers(3) FORMAT JSONEachRow; ``` النتيجة: ```text theme={null} [ {"number":"0"}, {"number":"1"}, {"number":"2"} ] ``` **مثال على استعلام عند تعطيل الإعداد** الاستعلام: ```sql theme={null} SET output_format_json_array_of_rows = 0; SELECT number FROM numbers(3) FORMAT JSONEachRow; ``` النتيجة: ```text theme={null} {"number":"0"} {"number":"1"} {"number":"2"} ```

## output\_format\_json\_escape\_forward\_slashes

يتحكم هذا الإعداد في إفلات الشرطات المائلة للأمام في مخرجات السلاسل النصية ضمن تنسيق إخراج JSON. والغرض من ذلك هو التوافق مع JavaScript. لا تخلط بينها وبين أحرف الشرطة المائلة العكسية `backslash` التي يجري إفلاتها دائمًا. مفعّل افتراضيًا.

## output\_format\_json\_map\_as\_array\_of\_tuples

يُسلسِل الأعمدة من النوع Map كمصفوفات JSON من قيم Tuple. معطّل افتراضيًا.

## output\_format\_json\_named\_tuples\_as\_objects

تسلسل أعمدة الأزواج المرتبة المسماة ككائنات JSON. مُمكَّن افتراضيًا.

## output\_format\_json\_pretty\_print

يحدّد هذا الإعداد طريقة عرض البُنى المتداخلة، مثل Tuples وMaps وArrays، داخل المصفوفة `data` عند استخدام تنسيق إخراج JSON. على سبيل المثال، بدلًا من الإخراج: ```json theme={null} "data": [ { "tuple": {"a":1,"b":2,"c":3}, "array": [1,2,3], "map": {"a":1,"b":2,"c":3} } ], ``` سيكون تنسيق المخرجات كما يلي: ```json theme={null} "data": [ { "tuple": { "a": 1, "b": 2, "c": 3 }, "array": [ 1, 2, 3 ], "map": { "a": 1, "b": 2, "c": 3 } } ], ``` مُفعَّل بشكل افتراضي.

## output\_format\_json\_quote\_64bit\_floats

يتحكم في إحاطة [الأعداد ذات الفاصلة العائمة](/ar/reference/data-types/float) بعلامات اقتباس عند إخراجها بتنسيقات JSON\* ذات 64 بت. يكون هذا الخيار معطّلًا افتراضيًا.

## output\_format\_json\_quote\_64bit\_integers

يتحكم هذا الإعداد في وضع [الأعداد الصحيحة](/ar/reference/data-types/int-uint) ذات 64 بت أو الأكبر (مثل `UInt64` أو `Int128`) بين علامتَي اقتباس عند إخراجها بتنسيق [JSON](/ar/reference/formats/JSON/JSON). تُوضَع هذه الأعداد الصحيحة بين علامتَي اقتباس افتراضيًا. وهذا السلوك متوافق مع معظم تطبيقات JavaScript. القيم الممكنة: * 0 — تُخرَج الأعداد الصحيحة من دون علامات اقتباس. * 1 — تُوضَع الأعداد الصحيحة بين علامتَي اقتباس.

## output\_format\_json\_quote\_decimals

يتحكم في وضع القيم العشرية بين علامتَي تنصيص في تنسيقات إخراج JSON. يكون معطّلًا افتراضيًا.

## output\_format\_json\_quote\_denormals

يتيح إخراج `+nan` و`-nan` و`+inf` و`-inf` في تنسيق الإخراج [JSON](/ar/reference/formats/JSON/JSON). القيم الممكنة: * 0 — معطّل. * 1 — مفعّل. **مثال** ضع في الاعتبار الجدول التالي `account_orders`: ```text theme={null} ┌─id─┬─name───┬─duration─┬─period─┬─area─┐ │ 1 │ Andrew │ 20 │ 0 │ 400 │ │ 2 │ John │ 40 │ 0 │ 0 │ │ 3 │ Bob │ 15 │ 0 │ -100 │ └────┴────────┴──────────┴────────┴──────┘ ``` عندما تكون `output_format_json_quote_denormals = 0`، يُرجِع الاستعلام قيَم `null` في الإخراج: ```sql theme={null} SELECT area/period FROM account_orders FORMAT JSON; ``` ```json theme={null} { "meta": [ { "name": "divide(area, period)", "type": "Float64" } ], "data": [ { "divide(area, period)": null }, { "divide(area, period)": null }, { "divide(area, period)": null } ], "rows": 3, "statistics": { "elapsed": 0.003648093, "rows_read": 3, "bytes_read": 24 } } ``` عند ضبط `output_format_json_quote_denormals = 1`، يُرجِع الاستعلام: ```json theme={null} { "meta": [ { "name": "divide(area, period)", "type": "Float64" } ], "data": [ { "divide(area, period)": "inf" }, { "divide(area, period)": "-nan" }, { "divide(area, period)": "-inf" } ], "rows": 3, "statistics": { "elapsed": 0.000070241, "rows_read": 3, "bytes_read": 24 } } ```

## output\_format\_json\_skip\_null\_value\_in\_named\_tuples

تجاوز أزواج المفتاح والقيمة التي تكون قيمتها null عند إجراء تسلسل لأعمدة `named tuple` ككائنات JSON. ولا يكون هذا صالحًا إلا إذا كانت `output_format_json_named_tuples_as_objects` مضبوطة على `true`.

## output\_format\_json\_validate\_utf8

يتحكّم في التحقّق من تسلسلات UTF-8 في تنسيقات إخراج JSON، ولا يؤثر في التنسيقات JSON/JSONCompact/JSONColumnsWithMetadata، إذ إنها تتحقق دائمًا من UTF-8. يكون معطّلًا افتراضيًا.

## output\_format\_markdown\_escape\_special\_characters

عند التفعيل، تُطبَّق عملية إفلات على الأحرف الخاصة في Markdown. يحدّد [Common Mark](https://spec.commonmark.org/0.30/#example-12) الأحرف الخاصة التالية التي يمكن إفلاتها بواسطة : ``` ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~ ``` القيم الممكنة: * 0 — تعطيل. * 1 — تمكين.

## output\_format\_msgpack\_uuid\_representation

كيفية إخراج UUID بتنسيق MsgPack.

## output\_format\_native\_encode\_types\_in\_binary\_format

كتابة أنواع البيانات بتنسيق ثنائي بدلًا من أسماء الأنواع في صيغة الإخراج Native

## output\_format\_native\_use\_flattened\_dynamic\_and\_json\_serialization

اكتب بيانات أعمدة [JSON](/ar/reference/data-types/newjson) و[Dynamic](/ar/reference/data-types/dynamic) بتنسيق مسطّح (جميع الأنواع/المسارات كأعمدة فرعية منفصلة).

## output\_format\_native\_write\_json\_as\_string

كتابة بيانات عمود [JSON](/ar/reference/data-types/newjson) على هيئة عمود [String](/ar/reference/data-types/string) يحتوي على سلاسل JSON، بدلاً من تسلسل JSON الأصلي الافتراضي في Native format.

## output\_format\_orc\_compression\_block\_size

حجم كتلة الضغط، بالبايت، لتنسيق الإخراج ORC.

## output\_format\_orc\_compression\_method

طريقة الضغط لتنسيق الإخراج ORC. خوارزميات الضغط المدعومة: lz4 وsnappy وzlib وzstd وnone (غير مضغوط)

## output\_format\_orc\_dictionary\_key\_size\_threshold

بالنسبة إلى عمود نصي في output format ORC، إذا كان عدد القيم المميزة أكبر من هذه النسبة من إجمالي عدد الصفوف غير NULL، فقم بتعطيل الترميز بالقاموس. وإلا فسيكون الترميز بالقاموس ممكّنًا

## output\_format\_orc\_row\_index\_stride

تباعد فهرس الصفوف المستهدف في تنسيق إخراج ORC

## output\_format\_orc\_string\_as\_string

استخدم نوع ORC String بدلًا من Binary لأعمدة String

## output\_format\_orc\_writer\_time\_zone\_name

اسم المنطقة الزمنية لكاتب ORC، والمنطقة الزمنية الافتراضية لكاتب ORC هي GMT.

## output\_format\_parallel\_formatting

يُفعِّل أو يعطّل التنسيق المتوازي لتنسيقات البيانات. وهو مدعوم فقط لتنسيقات [TSV](/ar/reference/formats/TabSeparated/TabSeparated) و[TSKV](/ar/reference/formats/TabSeparated/TSKV) و[CSV](/ar/reference/formats/CSV/CSV) و[JSONEachRow](/ar/reference/formats/JSON/JSONEachRow). القيم الممكنة: * 1 — مُمكَّن. * 0 — مُعطَّل.

## output\_format\_parquet\_batch\_size

تحقّق من حجم الصفحة كل هذا العدد من الصفوف. يُنصح بتقليله إذا كان لديك أعمدة يتجاوز متوسط حجم القيم فيها بضعة كيلوبايتات.

## output\_format\_parquet\_bloom\_filter\_bits\_per\_value

العدد التقريبي للبتات المستخدمة لكل قيمة مميزة في مرشحات بلوم في Parquet. معدلات الإيجابيات الكاذبة التقديرية: * 6 بتات - 10% * 10.5 بتات - 1% * 16.9 بتات - 0.1% * 26.4 بتات - 0.01% * 41 بتًا - 0.001%

## output\_format\_parquet\_bloom\_filter\_flush\_threshold\_bytes

يحدّد موضع وضع مرشحات Bloom داخل ملف Parquet. وتُكتب مرشحات Bloom في مجموعات بحجم تقريبي يساوي هذه القيمة. وعلى وجه التحديد: * إذا كانت القيمة 0، فستُكتب مرشحات Bloom الخاصة بكل مجموعة صفوف مباشرةً بعد مجموعة الصفوف، * إذا كانت أكبر من الحجم الإجمالي لجميع مرشحات Bloom، فستُجمَّع مرشحات Bloom لجميع مجموعات الصفوف في الذاكرة، ثم تُكتب معًا قرب نهاية الملف، * بخلاف ذلك، ستُجمَّع مرشحات Bloom في الذاكرة وتُكتب كلما تجاوز حجمها الإجمالي هذه القيمة.

## output\_format\_parquet\_compression\_method

طريقة الضغط لتنسيق إخراج Parquet. codecs المدعومة: snappy وlz4 وbrotli وzstd وgzip وnone (غير مضغوط)

## output\_format\_parquet\_data\_page\_size

حجم الصفحة المستهدف بالبايتات قبل الضغط.

## output\_format\_parquet\_date\_as\_uint16

اكتب قيم Date كأرقام عادية بعرض 16 بت (تُقرأ لاحقًا كـ UInt16)، بدلًا من تحويلها إلى نوع DATE في Parquet بعرض 32 بت (تُقرأ لاحقًا كـ Date32).

## output\_format\_parquet\_datetime\_as\_uint32

اكتب قيم DateTime كطابع زمني Unix خام (تُقرأ مجددًا كـ UInt32)، بدلًا من تحويلها إلى الملّي ثانية (تُقرأ مجددًا كـ DateTime64(3)).

## output\_format\_parquet\_enum\_as\_byte\_array

كتابة enum باستخدام النوع الفيزيائي في Parquet: BYTE\_ARRAY والنوع المنطقي: ENUM

## output\_format\_parquet\_fixed\_string\_as\_fixed\_byte\_array

استخدم نوع Parquet FIXED\_LEN\_BYTE\_ARRAY بدلًا من Binary لأعمدة FixedString.

## output\_format\_parquet\_geometadata

يسمح بكتابة معلومات حول أعمدة Geo في البيانات الوصفية لـ Parquet وترميز الأعمدة بتنسيق WKB.

## output\_format\_parquet\_max\_dictionary\_size

إذا تجاوز حجم القاموس هذا العدد من البايتات، فسيتم التبديل إلى ترميز بدون قاموس. اضبطها على 0 لتعطيل ترميز القاموس.

## output\_format\_parquet\_parallel\_encoding

نفّذ ترميز Parquet باستخدام عدة خيوط تنفيذ.

## output\_format\_parquet\_row\_group\_size

الحجم المستهدف لمجموعة الصفوف، بعدد الصفوف.

## output\_format\_parquet\_row\_group\_size\_bytes

حجم مجموعة الصفوف المستهدف بالبايتات، قبل الضغط.

## output\_format\_parquet\_string\_as\_string

استخدم نوع String في Parquet بدلًا من Binary لأعمدة String.

## output\_format\_parquet\_write\_bloom\_filter

كتابة مرشحات بلوم في ملفات Parquet.

## output\_format\_parquet\_write\_checksums

يضع قيم التحقق crc32 في رؤوس صفحات Parquet.

## output\_format\_parquet\_write\_page\_index

يكتب فهرس الأعمدة وفهرس الإزاحة (أي الإحصاءات الخاصة بكل صفحة بيانات، والتي يمكن استخدامها لتطبيق pushdown للمرشحات عند القراءة) في ملفات Parquet.

## output\_format\_pretty\_color

يستخدم تسلسلات إفلات ANSI في تنسيقات Pretty. 0 - معطّل، 1 - مفعّل، 'auto' - مفعّل إذا كان الإخراج طرفية.

## output\_format\_pretty\_display\_footer\_column\_names

يعرض أسماء الأعمدة في التذييل عند وجود عدد كبير من صفوف الجدول. القيم الممكنة: * 0 — لا تُعرض أسماء الأعمدة في التذييل. * 1 — تُعرض أسماء الأعمدة في التذييل إذا كان عدد الصفوف أكبر من أو يساوي قيمة العتبة المحددة بواسطة [output\_format\_pretty\_display\_footer\_column\_names\_min\_rows](#output_format_pretty_display_footer_column_names_min_rows) (50 افتراضيًا). **مثال** الاستعلام: ```sql theme={null} SELECT *, toTypeName(*) FROM (SELECT * FROM system.numbers LIMIT 1000); ``` النتيجة: ```response theme={null} ┌─number─┬─toTypeName(number)─┐ 1. │ 0 │ UInt64 │ 2. │ 1 │ UInt64 │ 3. │ 2 │ UInt64 │ ... 999. │ 998 │ UInt64 │ 1000. │ 999 │ UInt64 │ └─number─┴─toTypeName(number)─┘ ```

## output\_format\_pretty\_display\_footer\_column\_names\_min\_rows

يحدّد الحد الأدنى لعدد الصفوف التي يُعرض عندها تذييل يتضمن أسماء الأعمدة إذا كان الإعداد [output\_format\_pretty\_display\_footer\_column\_names](#output_format_pretty_display_footer_column_names) مفعّلًا.

## output\_format\_pretty\_fallback\_to\_vertical

إذا كان هذا الخيار مُمكّنًا وكان الجدول عريضًا ولكنه قصير، فسيعرضه تنسيق Pretty كما يعرضه التنسيق Vertical. راجع `output_format_pretty_fallback_to_vertical_max_rows_per_chunk` و `output_format_pretty_fallback_to_vertical_min_table_width` لضبط هذا السلوك بمزيد من التفصيل.

## output\_format\_pretty\_fallback\_to\_vertical\_max\_rows\_per\_chunk

لن يُفعَّل التحويل الاحتياطي إلى التنسيق Vertical (راجع `output_format_pretty_fallback_to_vertical`) إلا إذا كان عدد السجلات في الـ chunk لا يتجاوز القيمة المحددة.

## output\_format\_pretty\_fallback\_to\_vertical\_min\_columns

لن يُفعَّل التبديل الاحتياطي إلى تنسيق Vertical (راجع `output_format_pretty_fallback_to_vertical`) إلا إذا تجاوز عدد الأعمدة القيمة المحددة.

## output\_format\_pretty\_fallback\_to\_vertical\_min\_table\_width

لن يُفعَّل التحويل الاحتياطي إلى تنسيق Vertical (راجع `output_format_pretty_fallback_to_vertical`) إلا إذا كان مجموع أطوال الأعمدة في جدول ما يساوي القيمة المحددة على الأقل، أو إذا كانت هناك قيمة واحدة على الأقل تحتوي على محرف سطر جديد.

## output\_format\_pretty\_glue\_chunks

إذا وصلت البيانات المعروضة بتنسيقات Pretty على شكل عدة أجزاء، حتى مع وجود تأخير، وكان للجزء التالي عروض الأعمدة نفسها كما في الجزء السابق، فاستخدم تسلسلات إفلات ANSI للعودة إلى السطر السابق والكتابة فوق تذييل الجزء السابق لمتابعته ببيانات الجزء الجديد. وهذا يجعل النتيجة أكثر راحة بصريًا. 0 - معطّل، 1 - مفعّل، 'auto' - مفعّل عند الإخراج إلى طرفية.

## output\_format\_pretty\_grid\_charset

ترميز الأحرف المستخدم لطباعة حدود الجدول. ترميزات الأحرف المتاحة: ASCII وUTF-8 (الافتراضي). في interactive mode، ينتقل `clickhouse-client` تلقائيًا إلى `ASCII` عندما لا تدعم الطرفية UTF-8 (وفقًا لمتغيرات البيئة `LC_ALL` و`LC_CTYPE` و`LANG`)، ما لم يُحدَّد هذا الإعداد صراحةً.

## output\_format\_pretty\_highlight\_digit\_groups

إذا كان مفعّلًا وكان الإخراج يُعرض في طرفية، فستُميَّز كل خانة رقمية تمثل الآلاف والملايين وما إلى ذلك بتسطير.

## output\_format\_pretty\_highlight\_trailing\_spaces

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

## output\_format\_pretty\_max\_column\_name\_width\_cut\_to

إذا كان اسم العمود طويلًا جدًا، فسيُقص إلى هذا الطول. سيُقص العمود إذا كان أطول من `output_format_pretty_max_column_name_width_cut_to` بالإضافة إلى `output_format_pretty_max_column_name_width_min_chars_to_cut`.

## output\_format\_pretty\_max\_column\_name\_width\_min\_chars\_to\_cut

الحد الأدنى لعدد الأحرف المطلوب اقتطاعها إذا كان اسم العمود طويلاً جداً. سيُقتطع اسم العمود إذا تجاوز طوله `output_format_pretty_max_column_name_width_cut_to` بالإضافة إلى `output_format_pretty_max_column_name_width_min_chars_to_cut`.

## output\_format\_pretty\_max\_column\_pad\_width

الحد الأقصى للعرض المستخدَم لحشو جميع القيم في عمود ضمن تنسيقات Pretty.

## output\_format\_pretty\_max\_rows

الحد الأقصى للصفوف لتنسيقات Pretty.

## output\_format\_pretty\_max\_value\_width

الحد الأقصى لعرض القيمة المعروضة في تنسيقات Pretty. وإذا زاد عن ذلك، فسيتم اقتطاعه. القيمة 0 تعني - عدم الاقتطاع مطلقًا.

## output\_format\_pretty\_max\_value\_width\_apply\_for\_single\_value

لا تُقتطع القيم (راجع الإعداد `output_format_pretty_max_value_width`) إلا إذا لم تكن قيمة مفردة في block. وإلا فسيتم إخراجها بالكامل، وهو ما يفيد في استعلام `SHOW CREATE TABLE`.

## output\_format\_pretty\_multiline\_fields

إذا كان مفعّلًا، فستعرض تنسيقات Pretty الحقول متعددة الأسطر داخل خلية الجدول، بحيث تظل حدود الجدول محفوظة. أما إذا لم يكن مفعّلًا، فسيتم عرضها كما هي، ما قد يؤدي إلى تشويه الجدول (ومن مزايا إبقائه معطّلًا أن نسخ القيم متعددة الأسطر ولصقها سيكون أسهل).

## output\_format\_pretty\_named\_tuples\_as\_json

يتحكم هذا الإعداد في ما إذا كانت الـ tuples المسماة في تنسيق Pretty تُعرَض ككائنات JSON منسّقة بشكل جميل.

## output\_format\_pretty\_row\_numbers

إضافة أرقام الصفوف قبل كل صف في تنسيق الإخراج Pretty

## output\_format\_pretty\_single\_large\_number\_tip\_threshold

اطبع تلميحًا رقميًا سهل القراءة على الجانب الأيمن من الجدول إذا كانت الكتلة تتكوّن من رقم واحد يتجاوز هذه القيمة (باستثناء 0)

## output\_format\_pretty\_squash\_consecutive\_ms

انتظر الكتلة التالية لمدة تصل إلى العدد المحدد من الملّي ثواني، ثم ادمجها مع الكتلة السابقة قبل الكتابة. يؤدي ذلك إلى تجنب الإخراج المتكرر لكتل صغيرة جدًا، مع إبقاء عرض البيانات ممكنًا بشكل متدفق.

## output\_format\_pretty\_squash\_max\_wait\_ms

أخرج الكتلة المعلّقة بتنسيقات Pretty إذا انقضى منذ الإخراج السابق أكثر من عدد المللي ثانية المحدد.

## output\_format\_pretty\_use\_nbsp\_for\_padding

عند تمكينه، يُعرَض الحشو في تنسيقات الإخراج `Pretty` باستخدام `U+00A0` بدلًا من مسافة ASCII. يبقى الإخراج متطابقًا بصريًا في الخط أحادي المسافة، لكن يظل الحشو محفوظًا عند استخدام الأدوات التي تضغط أو تقتطع تتابعات المسافات العادية. لا يسري هذا إلا عندما تكون قيمة `output_format_pretty_grid_charset` هي `UTF-8`.

## output\_format\_protobuf\_nullables\_with\_google\_wrappers

عند تسلسل أعمدة Nullable باستخدام Google wrappers، تُسلسَل القيم الافتراضية على شكل wrappers فارغة. وإذا كان هذا الخيار معطّلًا، فلن تُسلسَل القيم الافتراضية ولا قيم NULL

## output\_format\_schema

المسار إلى الملف الذي سيُحفَظ فيه المخطط الذي يُنشأ تلقائيًا بتنسيق [Cap'n Proto](/ar/reference/formats/CapnProto) أو [Protobuf](/ar/reference/formats/Protobuf/Protobuf).

## output\_format\_sql\_insert\_include\_column\_names

إضافة أسماء الأعمدة إلى استعلام INSERT

## output\_format\_sql\_insert\_max\_batch\_size

الحد الأقصى لعدد الصفوف في تعليمة INSERT واحدة.

## output\_format\_sql\_insert\_quote\_names

أحِط أسماء الأعمدة بعلامتَي الاقتباس '\`'

## output\_format\_sql\_insert\_table\_name

اسم الجدول في استعلام INSERT الناتج

## output\_format\_sql\_insert\_use\_replace

استخدم تعليمة REPLACE بدلًا من INSERT

## output\_format\_trim\_fixed\_string

يزيل بايتات NULL اللاحقة من قيم FixedString في تنسيقات الإخراج النصية. على سبيل المثال، تُطبع `toFixedString('John', 8)` على هيئة `John` بدلًا من `John\0\0\0\0`.

## output\_format\_tsv\_crlf\_end\_of\_line

إذا ضُبطت على true، فستكون نهاية السطر بتنسيق TSV هي \r\n بدلًا من \n.

## output\_format\_values\_escape\_quote\_with\_quote

إذا كانت القيمة true، فسيتم إفلات ' باستخدام ''، وإلا فستُقتبس باستخدام \\'

## output\_format\_write\_statistics

يكتب إحصاءات عن الصفوف المقروءة والبايتات والزمن المستغرق في تنسيقات الإخراج المناسبة. مُمكَّن افتراضيًا