إعدادات تنسيق output_format_*

إعدادات التنسيق في ClickHouse ضمن المجموعة المُنشأة output_format_*.

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

​

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_record_batch_size

العدد المستهدف من الصفوف لكل دفعة سجلات في تنسيقَي الإخراج Arrow وArrowStream. يقلل دمج الكتل الصغيرة من العبء الناتج عن البيانات الوصفية وحشو الـ buffer، وخاصة في الاستعلامات ذات عوامل التصفية الانتقائية.

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

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

القيمة 0 (الافتراضية) تعطّل هدف الصفوف. جرّب 65409 كقيمة بدئية.

​

output_format_arrow_record_batch_size_bytes

حجم دفعة السجلات المستهدف لتنسيقات الإخراج Arrow وArrowStream، ويُقاس بالبايت من بيانات الكتل المتراكمة. يستخدم المقياس نفسه المستخدم في min_insert_block_size_bytes. تُكتب الدفعة عند بلوغ هذا الهدف أو بلوغ output_format_arrow_record_batch_size.

لاحظ أن أعمدة LowCardinality قد تنتج دفعات Arrow أكبر أو أصغر بكثير من هذا الهدف بالبايت. تتوسع القيم المتكررة في الإخراج ما لم يكن output_format_arrow_low_cardinality_as_dictionary مفعّلًا. وقد تحتفظ الكتل المُرشَّحة أيضًا بقواميس كبيرة، لذا قد تبلغ حتى كتلة تحتوي على عدد قليل جدًا من الصفوف الهدف وتُكتب بصورة منفصلة. بالنسبة إلى هذه الأعمدة، استخدم output_format_arrow_record_batch_size للتحكم في عدد الصفوف، واضبط هدف البايت على 0.

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

تعطّل القيمة 0 (الافتراضية) هدف البايت. جرّب 1048576 (1 MiB) كقيمة ابتدائية.

​

output_format_arrow_string_as_string

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

​

output_format_arrow_unsupported_types

ما يُكتب لعمود لا يملك نوعه تعيينًا أصليًا في Arrow (مثل JSON أو Dynamic أو QBit أو AggregateFunction):

• throw — رفض الاستعلام؛
• text — قيمة واحدة بصيغة نصية لكل صف (ما ينتجه CAST(col AS String))، كعمود Arrow من نوع Utf8؛
• binary — التمثيل الثنائي لكل قيمة، كعمود Arrow من نوع Binary (بالترميز نفسه لكل قيمة كما في RowBinary).

يكون عمود AggregateFunction من نوع Binary في وضع text أيضًا، لأن صيغته النصية هي حالة التجميع الخام وليست نصًا، ولأن عمود Arrow من نوع Utf8 يجب أن يحتوي على UTF-8 صالح. استخدم finalizeAggregation للحصول على قيمة قابلة للقراءة.

تُضمن صلاحية UTF-8 للقيمة المكتوبة في عمود Utf8، باستبدال كل تسلسل غير صالح بـ U+FFFD. لا يؤثر ذلك إلا في بيانات لم يكن بإمكان القارئ تفسيرها كنص على أي حال، مثل Dynamic يحتوي على String من بايتات عشوائية. استخدم وضع binary عندما يجب الاحتفاظ بالبايتات كما هي تمامًا.

لا ينطبق output_format_arrow_string_as_string على هذه الأعمدة، بل على أعمدة String وFixedString الحقيقية فقط. وهكذا يعبّر نوع Arrow لعمود معتم عن الترميز الذي يحمله: Utf8 للصيغة النصية وBinary للصيغة الثنائية، بغض النظر عما يقوله ذلك الإعداد.

ينطبق الأمر نفسه على حالة تجميع محفوظة في Dynamic: فنوع العمود مشتق من Dynamic، الذي لا يوضح ما تحتويه صفوفه، كما أن مخطط Arrow يُثبّت قبل رؤية أي قيمة؛ لذلك لا يمكن منح الحالة عمود Binary خاصًا بها كما هو الحال مع عمود AggregateFunction. ومن ثم تكون البيانات فاقدة للمعلومات في وضع text، بينما يحافظ عليها وضع binary. لا يتأثر Variant، إذ يسرد بدائله، ولذلك يحصل AggregateFunction بينها على حقل فرعي Binary خاص به.

في وضعي text وbinary كليهما، يُوسم الحقل في مخطط Arrow باسم الامتداد clickhouse.opaque واسم نوع ClickHouse الأصلي، ليتمكن القارئ من تمييزه عن عمود نصي أو ثنائي حقيقي.

يعيد ClickHouse قراءة مثل هذا العمود بالنوع الذي يحدده الوسم فقط عندما يكون جانب القراءة يعرف هذا النوع مسبقًا، كأن يصرّح به جدول أو تسميه وسيطة بنية مثل تلك التي تقبلها file وs3؛ ويطبّق ذلك أيضًا داخل Array وTuple وMap وNullable. لا يستشير استنتاج المخطط الوسم، لذا يصل العمود المقروء دون تحديد نوع له كـ String يحتوي على الحمولة الخام. لا يُعاد قراءة أي بديل من Variant مطلقًا، حتى عند تحديد النوع، لأن اتحاد Arrow الذي تشكله بدائله يُفك ترميزه دون الرجوع إلى الوسوم. تكون البيانات المكتوبة سليمة لقراء Arrow الآخرين في جميع الحالات.

له أولوية على output_format_arrow_unsupported_types_as_binary الأقدم، الذي لا يُستشار إلا عند ترك هذا الإعداد على قيمته الافتراضية.

​

output_format_arrow_unsupported_types_as_binary

يُخرج الأنواع التي لا يتوفر لها تحويل على شكل بيانات ثنائية خام. إذا كانت القيمة false، فستُطلق هذه الأنواع استثناءً.

تم الاستعاضة عنه بـ output_format_arrow_unsupported_types: تعني 0 القيمة throw وتعني 1 القيمة binary. ولا تتم مراجعته إلا عندما لا يكون output_format_arrow_unsupported_types معيّنًا صراحةً.

​

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: اسم الـsubject الذي يُسجَّل المخطط تحته في 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 (حجم النافذة = 1MB) إلى 30 (حجم النافذة = 1GB).

​

output_format_csv_crlf_end_of_line

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

​

output_format_csv_header_serialize_tuple_into_separate_columns

عند تمكين output_format_csv_serialize_tuple_into_separate_columns، تُسطِّح صفوف الترويسة في CSVWithNames وCSVWithNamesAndTypes كل عمود Tuple غير مغلّف إلى حقوله الطرفية (أسماء منقوطة مثل t.a وt.b، وأسماء الأنواع الطرفية)، بحيث يكون للترويسة العدد نفسه من الأعمدة الموجودة في البيانات. لا يُسطَّح عمود Nullable(Tuple) مطلقًا (وتبقى بياناته حقل CSV واحدًا)، لذلك تحتفظ ترويسته باسم العمود ونوعه المفردين على المستوى الأعلى. بالنسبة إلى CustomSeparated*، لا ينطبق هذا التسطيح إلا عندما تكون format_custom_escaping_rule = 'CSV' وformat_custom_field_delimiter محرفًا واحدًا يساوي format_csv_delimiter؛ وإلا (على سبيل المثال، محدِّد علامة الجدولة الافتراضي أو format_custom_field_delimiter = '|') تبقى الترويسة غير مسطحة حتى تظل مطابقةً للبيانات. اضبطه على 0 للإبقاء على السلوك السابق، حيث تحتفظ الترويسة باسم ونوع Tuple المفردين على المستوى الأعلى.

ملاحظة: لا تُعاد قراءة الترويسة المسطحة إلى Tuple بالاسم عندما تكون input_format_with_names_use_header = 1. لقراءة هذه البيانات مرة أخرى إلى Tuple، اضبط هذا الإعداد على 0 عند الإخراج، أو اقرأ باستخدام input_format_with_names_use_header = 0 (وبالنسبة إلى التنسيقات *WithNamesAndTypes، أي CSVWithNamesAndTypes وCustomSeparatedWithNamesAndTypes، اضبط أيضًا input_format_with_types_use_header = 0، لأن صف الأنواع المسطح سيُتحقق منه بخلاف ذلك مقابل حقل الإدخال المفرد لـ Tuple على المستوى الأعلى، وسيُرفض).

​

output_format_csv_serialize_tuple_into_separate_columns

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

ينطبق هذا التسطيح فقط على Tuple غير المغلّفة. ويُسلسَل Nullable(Tuple) دائمًا كحقل CSV واحد (بحيث تشغل الصفوف NULL وغير NULL العدد نفسه من الحقول)، بغض النظر عن هذا الإعداد.

​

output_format_decimal_trailing_zeros

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

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

​

output_format_float_precision

عندما تكون القيمة غير صفرية، تُنسَّق مخرجات الأعداد ذات الفاصلة العائمة (Float32 وFloat64 وBFloat16) بحيث لا يزيد عدد الخانات بعد الفاصلة العشرية على هذا العدد (مع إزالة الأصفار اللاحقة). وعندما تكون القيمة 0 (الافتراضية)، يُستخدم أقصر تمثيل يضمن round-trip.

تُخرَج القيم الكبيرة جدًا بالنسبة إلى التدوين الثابت، وكذلك القيم الصغيرة جدًا التي يؤدّي تقريبها إلى الدقة المطلوبة إلى فقدان جميع الخانات الدالة (بحيث تصبح المانتيسا ±0)، بالتدوين العلمي بدلًا من ذلك. وفي حالات fallback هذه، قد تحتوي المانتيسا على عدد من الخانات الكسرية أكبر من العدد المطلوب.

النطاق الصالح: من 0 إلى 100.

​

output_format_image_height

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

القيمة الافتراضية: 1024.

​

output_format_image_streaming_animation

بالنسبة إلى تنسيقات إخراج الصور، مثل PNG، اكتب كل إطار من الرسوم المتحركة فور ظهور القيمة التالية في العمود t، بدلًا من تخزين جميع الإطارات مؤقتًا في الذاكرة حتى نهاية الاستعلام.

يُحتفَظ بإطار واحد فقط في الذاكرة، وتُرسَل الإطارات إلى الإخراج بينما لا يزال الاستعلام قيد التنفيذ. وفي المقابل، يجب أن تكون قيم t غير متناقصة، وإلا يطرح الاستعلام استثناءً. كذلك، لا يكون عدد الإطارات معروفًا عند كتابة ترويسة الرسوم المتحركة، لذا يكون عدد الإطارات المُعلَن حدًا أعلى وليس القيمة الدقيقة. تشغّل المتصفحات هذا النوع من الملفات، لكن برامج فك الترميز التي تعتمد على العدد المُعلَن تُبلّغ عن خطأ بعد آخر إطار فعلي.

القيمة الافتراضية: false.

​

output_format_image_terminal_mode

بالنسبة إلى تنسيقات إخراج الصور مثل PNG، أخرج الصورة مباشرةً إلى الطرفية باستخدام بروتوكول صور مضمن بدلًا من كتابة بايتات الصورة الخام.

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

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

القيمة الافتراضية: “ (فارغ).

​

output_format_image_time_divisor_seconds

مقام الوحدة الزمنية للعمود t، بالثواني، لتنسيقات إخراج الصور مثل PNG.

راجع output_format_image_time_multiplier_seconds.

القيمة الافتراضية: 60.

​

output_format_image_time_multiplier_seconds

بسط وحدة الزمن للعمود t، بالثواني، في تنسيقات إخراج الصور مثل PNG.

يؤدي وجود عمود t إلى إنتاج التنسيق لرسوم متحركة، حيث يمثل t إزاحة الزمن النسبية للإطار. تقابل وحدة واحدة من t عددًا من الثواني يساوي output_format_image_time_multiplier_seconds / output_format_image_time_divisor_seconds. باستخدام القيم الافتراضية (1 و60)، تساوي وحدة واحدة من t ‏1/60 من الثانية.

القيمة الافتراضية: 1.

​

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. لا تخلطها مع الخطوط المائلة العكسية التي يُجرى لها الإفلات دائمًا.

مفعّل افتراضيًا.

​

output_format_json_map_as_array_of_tuples

تُسلسَل أعمدة Map على شكل مصفوفات JSON من Tuples.

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

​

output_format_json_named_tuples_as_objects

تُسلسِل أعمدة named tuple ككائنات 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

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

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

​

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 على 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 الأصلي الافتراضي.

​

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

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

​

output_format_orc_row_index_stride

قيمة 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

العدد التقريبي للبتات التي تُستخدم لكل قيمة مميزة في مرشحات Bloom في 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

الموضع داخل ملف Parquet الذي تُوضَع فيه مرشحات bloom. ستُكتب مرشحات bloom في مجموعات بهذا الحجم التقريبي. وعلى وجه التحديد:

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

​

output_format_parquet_compression_method

طريقة الضغط لتنسيق إخراج Parquet. خوارزميات الضغط المدعومة: 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

يسمح بكتابة معلومات عن الأعمدة الجغرافية في البيانات الوصفية لـ 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

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

​

output_format_parquet_wide_integer_as_decimal

اكتب قيم Int128 وUInt128 وInt256 وUInt256 كقيم DECIMAL في Parquet متوافقة مع المعايير، بترتيب البايتات big-endian. يحتفظ الإعداد الافتراضي بتمثيل FIXED_LEN_BYTE_ARRAY القديم غير المرفق بتعليق توضيحي، بترتيب little-endian، للتوافق مع إصدارات ClickHouse الأقدم. يتيح التمثيل العشري إحصاءات رقمية قابلة للتشغيل البيني، لكن بعض قارئات Parquet لا تدعم دقات تتجاوز 38 أو 76.

​

output_format_parquet_write_bloom_filter

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

​

output_format_parquet_write_checksums

أضف قيم التحقق crc32 إلى ترويسات صفحات Parquet.

​

output_format_parquet_write_page_index

يكتب فهرس الأعمدة وفهرس الإزاحة (أي الإحصاءات الخاصة بكل صفحة بيانات، والتي يمكن استخدامها لدفع عوامل التصفية عند القراءة) في ملفات 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) إلا إذا كان عدد الصفوف في الجزء لا يتجاوز القيمة المحددة.

​

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 format تُنتَج ككائنات 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، تُسلسَل القيم الافتراضية على شكل مغلفات فارغة. وإذا كان هذا الخيار معطّلًا، فلن تُسلسَل القيم الافتراضية ولا قيم 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

يحذف بايتات الصفر اللاحقة من قيم 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

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

مفعّل افتراضيًا