> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# إعدادات تنسيق output_format_*
> إعدادات التنسيق في ClickHouse ضمن المجموعة المُنشأة output_format_*.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
النوع
{type}
القيمة الافتراضية
{default_value}
{changeable_without_restart &&
يمكن تغييره دون إعادة التشغيل
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
تُنشأ هذه الإعدادات تلقائيًا من [المصدر](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/FormatFactorySettings.h).
## 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\_native\_writer
استخدم كاتب ClickHouse الأصلي لتنسيقَي Arrow وArrowStream بدلًا من الكاتب المستند إلى مكتبة Apache 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](/docs/ar/reference/data-types/newjson) كقيم [String](/docs/ar/reference/data-types/string) بتنسيق JSON في تنسيق الإخراج RowBinary.
## output\_format\_bson\_string\_as\_string
استخدم النوع BSON String بدلًا من Binary مع الأعمدة من النوع String.
## output\_format\_compression\_level
مستوى الضغط الافتراضي إذا كانت مخرجات الاستعلام مضغوطة. يُطبَّق هذا الإعداد عندما يتضمن استعلام `SELECT` `INTO OUTFILE` أو عند الكتابة إلى دوال الجدول `file` و`url` و`hdfs` و`s3` و`azureBlobStorage`.
القيم الممكنة: من `1` إلى `22`
## output\_format\_compression\_zstd\_window\_log
يمكن استخدامه عندما تكون طريقة ضغط الإخراج هي `zstd`. إذا كانت القيمة أكبر من `0`، فإن هذا الإعداد يحدد صراحةً حجم نافذة الضغط (قوة `2`) ويفعّل وضع المدى الطويل لضغط zstd. وقد يساعد ذلك على تحقيق نسبة ضغط أفضل.
القيم الممكنة: أعداد غير سالبة. لاحظ أنه إذا كانت القيمة صغيرة جدًا أو كبيرة جدًا، فسيؤدي `zstdlib` إلى طرح استثناء. وتتراوح القيم المعتادة من `20` (حجم النافذة = `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](/docs/ar/reference/settings/formats/output-format#output_format_csv_serialize_tuple_into_separate_columns)، تُسطِّح صفوف الترويسة في `CSVWithNames` و`CSVWithNamesAndTypes` كل عمود Tuple إلى حقوله الطرفية (أسماء منقوطة مثل `t.a` و`t.b`، وأسماء الأنواع الطرفية)، بحيث يكون للترويسة العدد نفسه من الأعمدة الموجودة في البيانات. بالنسبة إلى `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، فستُسلسَل Tuples في تنسيق CSV كأعمدة منفصلة (أي يُفقد تداخلها داخل Tuple)
## 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\_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](/docs/ar/reference/formats/JSON/JSONEachRow).
القيم الممكنة:
* 1 — يُخرج ClickHouse جميع الصفوف كمصفوفة، ويكون كل صف فيها بتنسيق `JSONEachRow`.
* 0 — يُخرج ClickHouse كل صف على حدة بتنسيق `JSONEachRow`.
**مثال على استعلام مع تمكين هذا الإعداد**
الاستعلام:
```sql theme={null}
SET output_format_json_array_of_rows = 1;
SELECT number FROM numbers(3) FORMAT JSONEachRow;
```
النتيجة:
```text theme={null}
[
{"number":"0"},
{"number":"1"},
{"number":"2"}
]
```
**مثال على استعلام مع تعطيل هذا الإعداد**
الاستعلام:
```sql theme={null}
SET output_format_json_array_of_rows = 0;
SELECT number FROM numbers(3) FORMAT JSONEachRow;
```
النتيجة:
```text theme={null}
{"number":"0"}
{"number":"1"}
{"number":"2"}
```
## output\_format\_json\_escape\_forward\_slashes
يتحكّم في إفلات الشرطات المائلة الأمامية في مخرجات السلاسل النصية ضمن تنسيق إخراج JSON. والغرض من ذلك هو التوافق مع JavaScript. لا تخلطها مع الخطوط المائلة العكسية التي يُجرى لها الإفلات دائمًا.
مفعّل افتراضيًا.
## 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.
على سبيل المثال، بدلًا من هذا الإخراج:
```json theme={null}
"data":
[
{
"tuple": {"a":1,"b":2,"c":3},
"array": [1,2,3],
"map": {"a":1,"b":2,"c":3}
}
],
```
سيُنسَّق الإخراج على النحو التالي:
```json theme={null}
"data":
[
{
"tuple": {
"a": 1,
"b": 2,
"c": 3
},
"array": [
1,
2,
3
],
"map": {
"a": 1,
"b": 2,
"c": 3
}
}
],
```
مفعّل افتراضيًا.
## output\_format\_json\_quote\_64bit\_floats
يتحكم في وضع علامات اقتباس حول [الأعداد ذات الفاصلة العائمة](/docs/ar/reference/data-types/float) ذات 64 بت عند إخراجها بتنسيقات JSON\*.
يكون معطّلًا افتراضيًا.
## output\_format\_json\_quote\_64bit\_integers
يتحكم هذا الإعداد في إحاطة [الأعداد الصحيحة](/docs/ar/reference/data-types/int-uint) ذات 64 بت أو الأكبر (مثل `UInt64` أو `Int128`) بعلامات اقتباس عند إخراجها بتنسيق [JSON](/docs/ar/reference/formats/JSON/JSON).
تُحاط هذه الأعداد الصحيحة بعلامات اقتباس افتراضيًا. هذا السلوك متوافق مع معظم تطبيقات JavaScript.
القيم الممكنة:
* 0 — تُخرَج الأعداد الصحيحة من دون علامات اقتباس.
* 1 — تُحاط الأعداد الصحيحة بعلامات اقتباس.
## output\_format\_json\_quote\_decimals
يتحكم في إحاطة القيم العشرية بعلامات اقتباس في تنسيقات إخراج JSON.
يكون معطّلًا افتراضيًا.
## output\_format\_json\_quote\_denormals
يُمكّن إخراج القيم `+nan` و`-nan` و`+inf` و`-inf` في [تنسيق الإخراج JSON](/docs/ar/reference/formats/JSON/JSON).
القيم الممكنة:
* 0 — معطّل.
* 1 — مفعّل.
**مثال**
لننظر إلى الجدول التالي `account_orders`:
```text theme={null}
┌─id─┬─name───┬─duration─┬─period─┬─area─┐
│ 1 │ Andrew │ 20 │ 0 │ 400 │
│ 2 │ John │ 40 │ 0 │ 0 │
│ 3 │ Bob │ 15 │ 0 │ -100 │
└────┴────────┴──────────┴────────┴──────┘
```
عندما تكون القيمة `output_format_json_quote_denormals = 0`، يُرجِع الاستعلام قيم `null` في الإخراج:
```sql theme={null}
SELECT area/period FROM account_orders FORMAT JSON;
```
```json theme={null}
{
"meta":
[
{
"name": "divide(area, period)",
"type": "Float64"
}
],
"data":
[
{
"divide(area, period)": null
},
{
"divide(area, period)": null
},
{
"divide(area, period)": null
}
],
"rows": 3,
"statistics":
{
"elapsed": 0.003648093,
"rows_read": 3,
"bytes_read": 24
}
}
```
عند ضبط `output_format_json_quote_denormals = 1` على 1، يُرجع الاستعلام:
```json theme={null}
{
"meta":
[
{
"name": "divide(area, period)",
"type": "Float64"
}
],
"data":
[
{
"divide(area, period)": "inf"
},
{
"divide(area, period)": "-nan"
},
{
"divide(area, period)": "-inf"
}
],
"rows": 3,
"statistics":
{
"elapsed": 0.000070241,
"rows_read": 3,
"bytes_read": 24
}
}
```
## output\_format\_json\_skip\_null\_value\_in\_named\_tuples
تخطّي أزواج المفتاح والقيمة ذات القيمة NULL عند تسلسل أعمدة named tuple ككائنات JSON. لا يكون هذا صالحًا إلا عندما تكون output\_format\_json\_named\_tuples\_as\_objects مضبوطة على true.
## output\_format\_json\_validate\_utf8
يتحكّم في التحقّق من صحة تسلسلات UTF-8 في تنسيقات إخراج JSON، ولا يؤثر في التنسيقات JSON/JSONCompact/JSONColumnsWithMetadata، فهي تتحقق دائمًا من UTF-8.
يكون معطلًا بشكل افتراضي.
## output\_format\_markdown\_escape\_special\_characters
عند تفعيل هذا الإعداد، تُفلت الأحرف الخاصة في Markdown.
يحدّد [Common Mark](https://spec.commonmark.org/0.30/#example-12) الأحرف الخاصة التالية التي يمكن إفلاتها:
```
! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~
```
القيم الممكنة:
* 0 — تعطيل.
* 1 — تفعيل.
## output\_format\_msgpack\_uuid\_representation
كيفية إخراج معرّف UUID بتنسيق MsgPack.
## output\_format\_native\_encode\_types\_in\_binary\_format
كتابة أنواع البيانات بالتنسيق الثنائي بدلًا من أسماء الأنواع في تنسيق الإخراج Native
## output\_format\_native\_use\_flattened\_dynamic\_and\_json\_serialization
كتابة بيانات أعمدة [JSON](/docs/ar/reference/data-types/newjson) و[Dynamic](/docs/ar/reference/data-types/dynamic) بتنسيق مسطّح (جميع الأنواع/المسارات كأعمدة فرعية منفصلة).
## output\_format\_native\_write\_json\_as\_string
كتابة بيانات عمود [JSON](/docs/ar/reference/data-types/newjson) كعمود [String](/docs/ar/reference/data-types/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](/docs/ar/reference/formats/TabSeparated/TabSeparated) و[TSKV](/docs/ar/reference/formats/TabSeparated/TSKV) و[CSV](/docs/ar/reference/formats/CSV/CSV) و[JSONEachRow](/docs/ar/reference/formats/JSON/JSONEachRow).
القيم الممكنة:
* 1 — مفعّل.
* 0 — معطّل.
## 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\_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](/docs/ar/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names_min_rows) (50 افتراضيًا).
**مثال**
الاستعلام:
```sql theme={null}
SELECT *, toTypeName(*) FROM (SELECT * FROM system.numbers LIMIT 1000);
```
النتيجة:
```response theme={null}
┌─number─┬─toTypeName(number)─┐
1. │ 0 │ UInt64 │
2. │ 1 │ UInt64 │
3. │ 2 │ UInt64 │
...
999. │ 998 │ UInt64 │
1000. │ 999 │ UInt64 │
└─number─┴─toTypeName(number)─┘
```
## output\_format\_pretty\_display\_footer\_column\_names\_min\_rows
يحدِّد الحد الأدنى لعدد الصفوف الذي عنده يُعرَض تذييل يتضمن أسماء الأعمدة إذا كان الإعداد [output\_format\_pretty\_display\_footer\_column\_names](/docs/ar/reference/settings/formats/output-format#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](/docs/ar/reference/formats/CapnProto) أو [Protobuf](/docs/ar/reference/formats/Protobuf/Protobuf).
## output\_format\_sql\_insert\_include\_column\_names
تضمين أسماء الأعمدة في استعلام INSERT
## output\_format\_sql\_insert\_max\_batch\_size
الحد الأقصى لعدد الصفوف في تعليمة INSERT واحدة.
## output\_format\_sql\_insert\_quote\_names
ضع أسماء الأعمدة بين محرفي '\`'
## output\_format\_sql\_insert\_table\_name
اسم الجدول في استعلام INSERT الناتج
## output\_format\_sql\_insert\_use\_replace
استخدم عبارة REPLACE بدلًا من عبارة INSERT
## output\_format\_trim\_fixed\_string
يحذف بايتات الصفر اللاحقة من قيم 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
كتابة إحصاءات عن الصفوف المقروءة، والبايتات، والوقت المنقضي في تنسيقات الإخراج المناسبة.
مفعّل افتراضيًا