> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# إعدادات التنسيق لـ input_format_*
> إعدادات التنسيق في ClickHouse ضمن المجموعة المُولَّدة input_format_*.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
النوع
{type}
القيمة الافتراضية
{default_value}
{changeable_without_restart &&
يمكن تغييره دون إعادة التشغيل
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
يتم إنشاء هذه الإعدادات تلقائيًا من [المصدر](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/FormatFactorySettings.h).
## 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` (مثل عدم معرفة حجم الملف، أو إذا كان الدفق غير قابل لإجراء `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\_arrow\_use\_native\_reader
استخدم قارئ ClickHouse الأصلي لتنسيقي Arrow وArrowStream بدلًا من القارئ المعتمد على مكتبة Apache 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](/docs/ar/reference/data-types/newjson) باعتبارها قيم [String](/docs/ar/reference/data-types/string) بتنسيق JSON في تنسيق الإدخال 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.
اكتشاف صف الرأس الذي يحتوي على الأسماء والأنواع تلقائيًا في تنسيق CSV
## input\_format\_csv\_empty\_as\_default
اعتبر الحقول الفارغة في إدخال CSV قيماً افتراضية.
## input\_format\_csv\_enum\_as\_number
اعتبر قيم `enum` المُدرجة في تنسيقات CSV فهارسَ `enum`
## input\_format\_csv\_missing\_nullable\_as\_empty\_string
يتحكم هذا الإعداد في كيفية قراءة `Nullable(String)` عند وجود قيمة مفقودة في CSV. وتكون القيمة المفقودة عبارة عن فراغ بين الفواصل أو قبلها أو بعدها، من دون أن تكون محاطة بعلامات اقتباس. إذا كان هذا الإعداد مفعّلًا، فبصرف النظر عن قيمة `input_format_csv_empty_as_default`، ستُفسَّر القيمة المفقودة لـ `Nullable(String)` على أنها `String` فارغة، وليس NULL.
## 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 قيماً افتراضية
اكتشاف سطر صف الرأس الذي يحتوي على الأسماء والأنواع تلقائيًا في تنسيق CustomSeparated
## input\_format\_custom\_skip\_trailing\_empty\_lines
تجاهل الأسطر الفارغة في نهاية تنسيق CustomSeparated
## input\_format\_defaults\_for\_omitted\_fields
عند تنفيذ استعلامات `INSERT`، تُستبدل قيم أعمدة الإدخال المُغفلة بالقيم الافتراضية للأعمدة المقابلة. ينطبق هذا الخيار على تنسيق [JSONEachRow](/docs/ar/reference/formats/JSON/JSONEachRow) (وتنسيقات JSON الأخرى)، و[CSV](/docs/ar/reference/formats/CSV/CSV)، و[TabSeparated](/docs/ar/reference/formats/TabSeparated/TabSeparated)، و[TSKV](/docs/ar/reference/formats/TabSeparated/TSKV)، و[Parquet](/docs/ar/reference/formats/Parquet/Parquet)، و[Arrow](/docs/ar/reference/formats/Arrow/Arrow)، و[Avro](/docs/ar/reference/formats/Avro/Avro)، و[ORC](/docs/ar/reference/formats/ORC)، و[Native](/docs/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` مُجسَّدًا فعليًا. وإذا لم يكن عمود إخراج مطلوبًا، فيُتحقق من أن هذا الشكل الهندسي صحيح البنية، لكنه لا يفعّل هذا السلوك.
## 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
الفاصل بين المفتاح والقيمة في كل زوج ضمن Hive Text File
## input\_format\_import\_nested\_json
يُمكّن أو يعطّل إدراج بيانات JSON التي تحتوي على كائنات متداخلة.
التنسيقات المدعومة:
* [JSONEachRow](/docs/ar/reference/formats/JSON/JSONEachRow)
القيم الممكنة:
* 0 — معطّل.
* 1 — مفعّل.
انظر أيضًا:
* [استخدام البُنى Nested](/docs/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 أثناء تحليل الـ named 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 الخاص بـ named tuples.
مفعَّل افتراضيًا.
## 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
إلغاء تسلسل أعمدة maps كمصفوفات JSON من Tuples.
معطّل افتراضيًا.
## input\_format\_json\_max\_depth
الحد الأقصى لعمق حقل في JSON. هذا ليس حدًا صارمًا، ولا يجب تطبيقه بدقة تامة.
## input\_format\_json\_named\_tuples\_as\_objects
حلّل الأعمدة من نوع named 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` مُمكّنًا. كما أن تعيين قيمة له يعطّل أيضًا التحليل المتوازي ويجعل إزالة التكرار غير ممكنة.
بالنسبة إلى عمليات الإدراج المتدفقة، يجب أيضًا تعيين `min_insert_block_size_rows=0` و `min_insert_block_size_bytes=0`. وإلا، فقد تستمر الكتل التي تم تحليلها في التراكم في الذاكرة خلال مرحلة دمج الكتل حتى الوصول إلى تلك العتبات، مما يمنع تنفيذ عمليات الإدراج في الوقت المناسب.
**مثال: بث أحدث تغييرات 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 dump مع الأعمدة في جدول 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](/docs/ar/reference/syntax#literals) باستخدام [القيم الافتراضية](/docs/ar/reference/statements/create/table#default_values)، إذا كان نوع بيانات هذه الحقول غير [Nullable](/docs/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، أو إحصاءات الحد الأدنى/الحد الأقصى، أو مرشح bloom في البيانات الوصفية لـ 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)](/docs/ar/reference/formats/TabSeparated/TabSeparated) و[TSKV](/docs/ar/reference/formats/TabSeparated/TSKV) و[CSV](/docs/ar/reference/formats/CSV/CSV) و[JSONEachRow](/docs/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](/docs/ar/reference/formats/JSON/JSONEachRow) (وتنسيقات JSON الأخرى)
* [BSONEachRow](/docs/ar/reference/formats/BSONEachRow) (وتنسيقات JSON الأخرى)
* [TSKV](/docs/ar/reference/formats/TabSeparated/TSKV)
* جميع التنسيقات ذات اللواحق WithNames/WithNamesAndTypes
* [MySQLDump](/docs/ar/reference/formats/MySQLDump)
* [Native](/docs/ar/reference/formats/Native)
القيم الممكنة:
* 0 — معطّل.
* 1 — مُمكّن.
## input\_format\_try\_infer\_dates
إذا كان هذا الخيار مفعّلًا، فسيحاول ClickHouse استنتاج النوع `Date` من الحقول النصية عند استنتاج المخطط للتنسيقات النصية. وإذا جرى تحليل جميع الحقول في أحد أعمدة بيانات الإدخال بنجاح على أنها تواريخ، فسيكون نوع النتيجة `Date`؛ أما إذا تعذّر تحليل حقل واحد على الأقل كتاريخ، فسيكون نوع النتيجة `String`.
مفعّل افتراضيًا.
## input\_format\_try\_infer\_datetimes
إذا كان هذا الإعداد مُمكّنًا، فسيحاول ClickHouse استنتاج النوع `DateTime64` من الحقول النصية أثناء استنتاج المخطط للتنسيقات النصية. وإذا جرى تحليل جميع الحقول في عمود من بيانات الإدخال بنجاح على أنها قيم تاريخ ووقت، فسيكون نوع النتيجة `DateTime64`. أما إذا تعذّر تحليل حقل واحد على الأقل على أنه قيمة تاريخ ووقت، فسيكون نوع النتيجة `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`](/docs/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.
اكتشاف الترويسة التي تتضمن الأسماء والأنواع تلقائيًا في تنسيق 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 format: عند تحليل التعبيرات وتفسيرها باستخدام Template، افحص النوع الفعلي للقيمة الحرفية لتجنّب مشكلات تجاوز السعة والدقة المحتملة.
## input\_format\_values\_deduce\_templates\_of\_expressions
بالنسبة إلى تنسيق Values: إذا تعذّر على محلّل التدفق تحليل الحقل، فشِّل محلّل SQL، واستنتج قالبًا لتعبير SQL، وحاول تحليل جميع الصفوف باستخدام هذا القالب، ثم فسِّر التعبير في جميع الصفوف.
## input\_format\_values\_interpret\_expressions
في Values format: إذا تعذّر على streaming parser تحليل الحقل، فشغّل SQL parser وحاول تفسيره على أنه تعبير SQL.
يُمكّن هذا الإعداد أو يعطّل التحقق من ترتيب الأعمدة عند إدراج البيانات.
لتحسين أداء الإدراج، نوصي بتعطيل هذا التحقق إذا كنت متأكدًا من أن ترتيب أعمدة بيانات الإدخال مطابق لترتيبها في الجدول المستهدف.
التنسيقات المدعومة:
* [CSVWithNames](/docs/ar/reference/formats/CSV/CSVWithNames)
* [CSVWithNamesAndTypes](/docs/ar/reference/formats/CSV/CSVWithNamesAndTypes)
* [TabSeparatedWithNames](/docs/ar/reference/formats/TabSeparated/TabSeparatedWithNames)
* [TabSeparatedWithNamesAndTypes](/docs/ar/reference/formats/TabSeparated/TabSeparatedWithNamesAndTypes)
* [JSONCompactEachRowWithNames](/docs/ar/reference/formats/JSON/JSONCompactEachRowWithNames)
* [JSONCompactEachRowWithNamesAndTypes](/docs/ar/reference/formats/JSON/JSONCompactEachRowWithNamesAndTypes)
* [JSONCompactStringsEachRowWithNames](/docs/ar/reference/formats/JSON/JSONCompactStringsEachRowWithNames)
* [JSONCompactStringsEachRowWithNamesAndTypes](/docs/ar/reference/formats/JSON/JSONCompactStringsEachRowWithNamesAndTypes)
* [RowBinaryWithNames](/docs/ar/reference/formats/RowBinary/RowBinaryWithNames)
* [RowBinaryWithNamesAndTypes](/docs/ar/reference/formats/RowBinary/RowBinaryWithNamesAndTypes)
* [CustomSeparatedWithNames](/docs/ar/reference/formats/CustomSeparated/CustomSeparatedWithNames)
* [CustomSeparatedWithNamesAndTypes](/docs/ar/reference/formats/CustomSeparated/CustomSeparatedWithNamesAndTypes)
القيم الممكنة:
* 0 — معطّل.
* 1 — مفعّل.
يتحكم هذا الإعداد في ما إذا كان محلل التنسيق سيتحقق من تطابق أنواع البيانات في بيانات الإدخال مع أنواع البيانات في الجدول الهدف.
التنسيقات المدعومة:
* [CSVWithNamesAndTypes](/docs/ar/reference/formats/CSV/CSVWithNamesAndTypes)
* [TabSeparatedWithNamesAndTypes](/docs/ar/reference/formats/TabSeparated/TabSeparatedWithNamesAndTypes)
* [JSONCompactEachRowWithNamesAndTypes](/docs/ar/reference/formats/JSON/JSONCompactEachRowWithNamesAndTypes)
* [JSONCompactStringsEachRowWithNamesAndTypes](/docs/ar/reference/formats/JSON/JSONCompactStringsEachRowWithNamesAndTypes)
* [RowBinaryWithNamesAndTypes](/docs/ar/reference/formats/RowBinary/RowBinaryWithNamesAndTypes)
* [CustomSeparatedWithNamesAndTypes](/docs/ar/reference/formats/CustomSeparated/CustomSeparatedWithNamesAndTypes)
القيم الممكنة:
* 0 — معطّل.
* 1 — مُمكّن.