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

إعدادات تتحكم في تنسيقات الإدخال والإخراج.

تُنشأ هذه الإعدادات تلقائيًا من الشفرة المصدرية.

​

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 — مفعّل.

مثال

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

يتيح اختيار محلّل للتمثيل النصي للتاريخ والوقت.

لا ينطبق هذا الإعداد على دوال التاريخ والوقت.

القيم الممكنة:

• 'best_effort' — يفعّل التحليل الموسّع.

  يمكن لـ ClickHouse تحليل التنسيق الأساسي YYYY-MM-DD HH:MM:SS وجميع تنسيقات التاريخ والوقت وفق ISO 8601. على سبيل المثال، '2018-06-08T01:02:03.000Z'.

• 'best_effort_us' — مشابه لـ best_effort (راجع الفرق في parseDateTimeBestEffortUS

• 'basic' — يستخدم المحلّل الأساسي.

  يمكن لـ ClickHouse تحليل التنسيق الأساسي YYYY-MM-DD HH:MM:SS أو YYYY-MM-DD فقط. على سبيل المثال، 2019-08-20 10:18:56 أو 2019-08-20.

راجع أيضًا:

• نوع البيانات DateTime.
• دوال التعامل مع التواريخ والأوقات.

​

date_time_output_format

يسمح باختيار تنسيقات إخراج مختلفة للتمثيل النصي للتاريخ والوقت.

القيم الممكنة:

• simple - تنسيق إخراج بسيط.

  يُخرج ClickHouse التاريخ والوقت بتنسيق YYYY-MM-DD hh:mm:ss. على سبيل المثال، 2019-08-20 10:18:56. يُجرى الحساب وفقًا للمنطقة الزمنية الخاصة بنوع البيانات (إن وُجدت) أو المنطقة الزمنية الخاصة بالخادم.

• iso - تنسيق إخراج ISO.

  يُخرج ClickHouse التاريخ والوقت بتنسيق ISO 8601 YYYY-MM-DDThh:mm:ssZ. على سبيل المثال، 2019-08-20T10:18:56Z. لاحظ أن الإخراج يكون بتوقيت UTC (Z تعني UTC).

• unix_timestamp - تنسيق إخراج Unix timestamp.

  يُخرج ClickHouse التاريخ والوقت بتنسيق Unix timestamp. على سبيل المثال، 1566285536.

راجع أيضًا:

• نوع البيانات DateTime.
• دوال العمل مع التواريخ والأوقات.

​

date_time_overflow_behavior

يحدّد هذا الإعداد السلوك عند تحويل Date وDate32 وDateTime و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 إعداد الخادم مفعّلًا، وأن يمتلك امتياز displaySecretsInShowAndSelect.

القيم الممكنة:

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

​

format_json_object_each_row_column_for_object_name

اسم العمود الذي سيُستخدم لتخزين/كتابة أسماء العناصر بتنسيق 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 أو Protobuf. وتعتمد القيمة على التنسيق.

​

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 كقيم 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 (وتنسيقات JSON الأخرى)، وCSV، وTabSeparated، وTSKV، وParquet، وArrow، وAvro، وORC، و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

القيم الممكنة:

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

انظر أيضًا:

• استخدام البُنى المتداخلة مع تنسيق 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 التي تتضمن قيمًا من أنواع بيانات مختلفة.

مثال:

SET input_format_json_infer_array_of_dynamic_from_array_of_different_types=1;
DESC format(JSONEachRow, '{"a" : [42, "hello", [1, 2, 3]]}');

┌─name─┬─type───────────┐
│ a    │ Array(Dynamic) │
└──────┴────────────────┘

SET input_format_json_infer_array_of_dynamic_from_array_of_different_types=0;
DESC format(JSONEachRow, '{"a" : [42, "hello", [1, 2, 3]]}');

┌─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 للمفاتيح ذات الأنواع غير المعروفة.

مثال:

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.

مثال:

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.

مثال:

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 المقابلة في بيانات العيّنة.

مثال:

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

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 باستخدام القيم الافتراضية، إذا كان نوع بيانات هذه الحقول غير 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) وTSKV وCSV و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 (وتنسيقات JSON الأخرى)
• BSONEachRow (وتنسيقات JSON الأخرى)
• TSKV
• جميع التنسيقات التي تحمل اللواحق WithNames/WithNamesAndTypes
• MySQLDump
• 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 ضمن استنتاج المخطط لتنسيقات النص عندما يكون هناك أكثر من نوع محتمل لعناصر العمود/المصفوفة.

القيم الممكنة:

• 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
• CSVWithNamesAndTypes
• TabSeparatedWithNames
• TabSeparatedWithNamesAndTypes
• JSONCompactEachRowWithNames
• JSONCompactEachRowWithNamesAndTypes
• JSONCompactStringsEachRowWithNames
• JSONCompactStringsEachRowWithNamesAndTypes
• RowBinaryWithNames
• RowBinaryWithNamesAndTypes
• CustomSeparatedWithNames
• CustomSeparatedWithNamesAndTypes

القيم الممكنة:

• 0 — معطّل.
• 1 — مُمكّن.

​

input_format_with_types_use_header

يحدد ما إذا كان محلل التنسيق سيتحقق من تطابق أنواع البيانات في بيانات الإدخال مع أنواع البيانات في الجدول الهدف.

التنسيقات المدعومة:

• CSVWithNamesAndTypes
• TabSeparatedWithNamesAndTypes
• JSONCompactEachRowWithNamesAndTypes
• JSONCompactStringsEachRowWithNamesAndTypes
• RowBinaryWithNamesAndTypes
• CustomSeparatedWithNamesAndTypes

القيم الممكنة:

• 0 — معطّل.
• 1 — مُمكّن.

​

insert_distributed_one_random_shard

يُفعِّل أو يعطِّل الإدراج العشوائي في إحدى الشظايا عند الإدراج في جدول Distributed في حال عدم وجود مفتاح توزيع.

افتراضيًا، عند إدراج البيانات في جدول Distributed يحتوي على أكثر من شظية واحدة، يرفض خادم ClickHouse أي طلب إدراج إذا لم يكن هناك مفتاح توزيع. وعند ضبط insert_distributed_one_random_shard = 1، يُسمح بعمليات الإدراج وتُوجَّه البيانات عشوائيًا إلى جميع الشظايا.

القيم الممكنة:

• 0 — يُرفض الإدراج إذا كانت هناك عدة شظايا ولم يتم تحديد مفتاح توزيع.
• 1 — يتم الإدراج عشوائيًا بين جميع الشظايا المتاحة عند عدم تحديد مفتاح توزيع.

​

interval_output_format

يتيح اختيار تنسيقات إخراج مختلفة للتمثيل النصي لأنواع interval.

القيم الممكنة:

• kusto - تنسيق إخراج بأسلوب KQL.

  يعرض ClickHouse قيم interval بتنسيق KQL. على سبيل المثال، ستُنسَّق toIntervalDay(2) على الشكل 2.00:00:00. يُرجى ملاحظة أنه بالنسبة إلى أنواع interval ذات الطول المتغير (مثل IntervalMonth وIntervalYear)، يُؤخَذ في الاعتبار متوسط عدد الثواني لكل interval.

• numeric - تنسيق إخراج رقمي.

  يعرض ClickHouse قيم interval وفق تمثيلها الرقمي الداخلي. على سبيل المثال، ستُنسَّق toIntervalDay(2) على الشكل 2.

انظر أيضًا:

• 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 كقيم 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.

القيم الممكنة:

• 1 — يُخرج ClickHouse جميع الصفوف كمصفوفة، بحيث يكون كل صف بتنسيق JSONEachRow.
• 0 — يُخرج ClickHouse كل صف على حدة بتنسيق JSONEachRow.

مثال على استعلام مع تمكين هذا الإعداد

الاستعلام:

SET output_format_json_array_of_rows = 1;
SELECT number FROM numbers(3) FORMAT JSONEachRow;

النتيجة:

[
{"number":"0"},
{"number":"1"},
{"number":"2"}
]

مثال على استعلام عند تعطيل الإعداد

الاستعلام:

SET output_format_json_array_of_rows = 0;
SELECT number FROM numbers(3) FORMAT JSONEachRow;

النتيجة:

{"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.

على سبيل المثال، بدلًا من الإخراج:

"data":
[
  {
    "tuple": {"a":1,"b":2,"c":3},
    "array": [1,2,3],
    "map": {"a":1,"b":2,"c":3}
  }
],

سيكون تنسيق المخرجات كما يلي:

"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

يتحكم في إحاطة الأعداد ذات الفاصلة العائمة بعلامات اقتباس عند إخراجها بتنسيقات JSON* ذات 64 بت.

يكون هذا الخيار معطّلًا افتراضيًا.

​

output_format_json_quote_64bit_integers

يتحكم هذا الإعداد في وضع الأعداد الصحيحة ذات 64 بت أو الأكبر (مثل UInt64 أو Int128) بين علامتَي اقتباس عند إخراجها بتنسيق JSON. تُوضَع هذه الأعداد الصحيحة بين علامتَي اقتباس افتراضيًا. وهذا السلوك متوافق مع معظم تطبيقات JavaScript.

القيم الممكنة:

• 0 — تُخرَج الأعداد الصحيحة من دون علامات اقتباس.
• 1 — تُوضَع الأعداد الصحيحة بين علامتَي اقتباس.

​

output_format_json_quote_decimals

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

يكون معطّلًا افتراضيًا.

​

output_format_json_quote_denormals

يتيح إخراج +nan و-nan و+inf و-inf في تنسيق الإخراج JSON.

القيم الممكنة:

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

مثال

ضع في الاعتبار الجدول التالي account_orders:

┌─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 في الإخراج:

SELECT area/period FROM account_orders FORMAT JSON;

{
        "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، يُرجِع الاستعلام:

{
        "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 الأحرف الخاصة التالية التي يمكن إفلاتها بواسطة :

! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~

القيم الممكنة:

• 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 وDynamic بتنسيق مسطّح (جميع الأنواع/المسارات كأعمدة فرعية منفصلة).

​

output_format_native_write_json_as_string

كتابة بيانات عمود JSON على هيئة عمود 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 وTSKV وCSV و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 (50 افتراضيًا).

مثال

الاستعلام:

SELECT *, toTypeName(*) FROM (SELECT * FROM system.numbers LIMIT 1000);

النتيجة:

      ┌─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_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 أو 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

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

مُمكَّن افتراضيًا

​

precise_float_parsing

تفضيل خوارزمية أكثر دقة (لكنها أبطأ) لتحليل الأعداد ذات الفاصلة العائمة

​

schema_inference_hints

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

مثال:

الاستعلام:

desc format(JSONEachRow, '{"x" : 1, "y" : "String", "z" : "0.0.0.0" }') settings schema_inference_hints='x UInt8, z IPv4';

النتيجة:

x   UInt8
y   Nullable(String)
z   IPv4

إذا لم يكن schema_inference_hints مُنسَّقًا بشكل صحيح، أو إذا احتوى على خطأ مطبعي أو نوع بيانات غير صحيح، وما إلى ذلك… فسيتم تجاهل schema_inference_hints بالكامل.

​

schema_inference_make_columns_nullable

يتحكم في جعل الأنواع المستنتجة Nullable أثناء استدلال المخطط. القيم الممكنة:

• 0 - لن يكون النوع المستنتج Nullable مطلقًا (استخدم input_format_null_as_default للتحكم في ما يجب فعله مع قيم NULL في هذه الحالة)،
• 1 - ستكون جميع الأنواع المستنتجة Nullable،
• 2 أو auto - سيكون النوع المستنتج Nullable فقط إذا كان العمود يحتوي على NULL في عينة تُحلَّل أثناء استدلال المخطط، أو إذا كانت البيانات الوصفية للملف تتضمن معلومات عن قابلية العمود لأن يكون NULL،
• 3 - ستتوافق قابلية النوع المستنتج لأن يكون Nullable مع البيانات الوصفية للملف إذا كانت الصيغة تدعم ذلك (مثل Parquet)، وإلا فسيكون Nullable دائمًا (مثل CSV).

​

schema_inference_make_json_columns_nullable

يتحكم في ما إذا كانت أنواع JSON المستنتجة ستُجعل Nullable عند استدلال المخطط. إذا كان هذا الإعداد ممكّنًا مع schema_inference_make_columns_nullable، فسيكون نوع JSON المستنتج Nullable.

​

schema_inference_mode

وضع استدلال المخطط. ‏‘default’ - يفترض أن جميع الملفات لها المخطّط نفسه، ويمكن استدلال المخطّط من أي ملف، ‏‘union’ - يمكن أن تكون للملفات مخططات مختلفة، ويجب أن يكون المخطّط الناتج اتحاد مخططات جميع الملفات

​

show_create_query_identifier_quoting_rule

عيّن قاعدة تنصيص المعرّفات في استعلام SHOW CREATE

​

show_create_query_identifier_quoting_style

عيّن نمط اقتباس المعرّفات في استعلام SHOW CREATE

​

type_json_allow_duplicated_key_with_literal_and_nested_object

عند التمكين، يُسمح بتحليل JSON مثل {"a" : 42, "a" : {"b" : 42}} عندما يكون هناك مفتاح مكرر، لكن تكون إحدى القيمتين كائنًا متداخلًا.

​

type_json_skip_duplicated_paths

عند تفعيله، أثناء تحليل كائن JSON إلى نوع JSON، سيتم تجاهل المسارات المكررة ولن يُدرج إلا المسار الأول بدلًا من حدوث استثنا

​

type_json_skip_invalid_typed_paths

عند تمكين هذا الإعداد، تُتخطى الحقول التي تحتوي على قيم لا يمكن تحويلها إلى النوع المعلن لها في أعمدة JSON type ذات المسارات محددة النوع، بدلًا من إصدار خطأ. وتُعامل الحقول المتخطاة على أنها مفقودة، وتستخدم القيم الافتراضية/NULL وفقًا لتعريف المسار محدد النوع.

ينطبق هذا الإعداد فقط على أعمدة JSON type (مثل JSON(a Int64, b String)) التي تكون فيها بعض المسارات ذات أنواع معلنة. ولا ينطبق على JSON input formats العادية مثل JSONEachRow عند الإدراج في typed columns العادية.

القيم الممكنة:

• 0 — تعطيل (إصدار خطأ عند عدم تطابق النوع).
• 1 — تمكين (تخطي الحقل عند عدم تطابق النوع).

​

type_json_use_partial_match_to_skip_paths_by_regexp

عند تفعيل هذا الإعداد، وأثناء تحليل كائن JSON إلى النوع JSON، ستتطلب التعبيرات النمطية المحددة باستخدام SKIP REGEXP مطابقة جزئية لتخطي مسار. وعند تعطيله، ستكون المطابقة الكاملة مطلوبة.

​

validate_experimental_and_suspicious_types_inside_nested_types

التحقق من استخدام الأنواع التجريبية والمريبة داخل الأنواع المتداخلة مثل Array/Map/Tuple