> ## 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.

> توثيق تنسيق Pretty

# Pretty

| الإدخال | الإخراج | الاسم البديل |
| ------- | ------- | ------------ |
| ✗       | ✔       |              |

<div id="description">
  ## الوصف
</div>

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

يُخرَج [NULL](/docs/ar/reference/syntax) على هيئة `ᴺᵁᴸᴸ`.

<div id="example-usage">
  ## مثال على الاستخدام
</div>

مثال (بصيغة [`PrettyCompact`](/docs/ar/reference/formats/Pretty/PrettyCompact)):

```sql title="Query" theme={null}
SELECT * FROM t_null
```

```response title="Response" theme={null}
┌─x─┬────y─┐
│ 1 │ ᴺᵁᴸᴸ │
└───┴──────┘
```

لا يُطبَّق الإفلات على الصفوف في أيٍّ من تنسيقات `Pretty`. ويُعرض المثال التالي لتنسيق [`PrettyCompact`](/docs/ar/reference/formats/Pretty/PrettyCompact):

```sql title="Query" theme={null}
SELECT 'String with \'quotes\' and \t character' AS Escaping_test
```

```response title="Response" theme={null}
┌─Escaping_test────────────────────────┐
│ String with 'quotes' and      character │
└──────────────────────────────────────┘
```

لتجنّب إخراج كمية كبيرة جدًا من البيانات إلى الطرفية، لا يُطبع سوى أول `10,000` صف.
إذا كان عدد الصفوف أكبر من أو يساوي `10,000`، فستُطبع الرسالة "تم عرض أول 10 000".

<Note>
  هذا التنسيق مناسب فقط لإخراج نتيجة استعلام، وليس لتحليل البيانات.
</Note>

يدعم تنسيق Pretty إخراج القيم الإجمالية (عند استخدام `WITH TOTALS`) والقيم القصوى (عند ضبط 'extremes' على 1).
في هذه الحالات، تُخرَج القيم الإجمالية والقيم القصوى بعد البيانات الرئيسية، في جداول منفصلة.
يوضح المثال التالي ذلك باستخدام تنسيق [`PrettyCompact`](/docs/ar/reference/formats/Pretty/PrettyCompact):

```sql title="Query" theme={null}
SELECT EventDate, count() AS c 
FROM test.hits 
GROUP BY EventDate 
WITH TOTALS 
ORDER BY EventDate 
FORMAT PrettyCompact
```

```response title="Response" theme={null}
┌──EventDate─┬───────c─┐
│ 2014-03-17 │ 1406958 │
│ 2014-03-18 │ 1383658 │
│ 2014-03-19 │ 1405797 │
│ 2014-03-20 │ 1353623 │
│ 2014-03-21 │ 1245779 │
│ 2014-03-22 │ 1031592 │
│ 2014-03-23 │ 1046491 │
└────────────┴─────────┘

Totals:
┌──EventDate─┬───────c─┐
│ 1970-01-01 │ 8873898 │
└────────────┴─────────┘

Extremes:
┌──EventDate─┬───────c─┐
│ 2014-03-17 │ 1031592 │
│ 2014-03-23 │ 1406958 │
└────────────┴─────────┘
```

<div id="format-settings">
  ## إعدادات الصيغة
</div>

الإعدادات التالية مشتركة بين جميع تنسيقات `Pretty`:

| Setting                                                                                                                                                 | Description                                                                                                                                                                                                  | Default |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- |
| [`output_format_pretty_max_rows`](/docs/ar/reference/settings/formats#output_format_pretty_max_rows)                                                         | الحد الأقصى لعدد الصفوف في تنسيقات Pretty.                                                                                                                                                                   | `10000` |
| [`output_format_pretty_max_column_pad_width`](/docs/ar/reference/settings/formats#output_format_pretty_max_column_pad_width)                                 | أقصى عرض لحشو جميع القيم في عمود ضمن تنسيقات Pretty.                                                                                                                                                         | `250`   |
| [`output_format_pretty_max_value_width`](/docs/ar/reference/settings/formats#output_format_pretty_max_value_width)                                           | أقصى عرض للقيمة المعروضة في تنسيقات Pretty. وإذا تجاوزته، فستُقتطع القيمة.                                                                                                                                   | `10000` |
| [`output_format_pretty_color`](/docs/ar/reference/settings/formats#output_format_pretty_color)                                                               | استخدم ANSI escape sequences لإظهار الألوان في تنسيقات Pretty.                                                                                                                                               | `true`  |
| [`output_format_pretty_grid_charset`](/docs/ar/reference/settings/formats#output_format_pretty_grid_charset)                                                 | مجموعة المحارف المستخدمة لطباعة حدود الشبكة. مجموعات المحارف المتاحة: ASCII وUTF-8.                                                                                                                          | `UTF-8` |
| [`output_format_pretty_row_numbers`](/docs/ar/reference/settings/formats#output_format_pretty_row_numbers)                                                   | أضِف أرقام الصفوف قبل كل صف في output format من نوع Pretty.                                                                                                                                                  | `true`  |
| [`output_format_pretty_display_footer_column_names`](/docs/ar/reference/settings/formats#output_format_pretty_display_footer_column_names)                   | اعرض أسماء الأعمدة في التذييل إذا كان الجدول يحتوي على عدد كبير من الصفوف.                                                                                                                                   | `true`  |
| [`output_format_pretty_display_footer_column_names_min_rows`](/docs/ar/reference/settings/formats#output_format_pretty_display_footer_column_names_min_rows) | يحدّد الحد الأدنى لعدد الصفوف الذي عنده يُعرض التذييل إذا كان [`output_format_pretty_display_footer_column_names`](/docs/ar/reference/settings/formats#output_format_pretty_display_footer_column_names) مفعّلًا. | `50`    |