> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Документация по формату Pretty

# Pretty

| Вход | Выход | Псевдоним |
| ---- | ----- | --------- |
| ✗    | ✔     |           |

<div id="description">
  ## Описание
</div>

Формат `Pretty` выводит данные в виде таблиц, нарисованных символами Unicode,
используя ANSI-последовательности экранирования для отображения цветов в терминале.
Отрисовывается полная сетка таблицы, и каждая строка занимает в терминале две строки.
Каждый блок результата выводится как отдельная таблица.
Это необходимо, чтобы блоки можно было выводить без буферизации результатов (буферизация потребовалась бы для предварительного вычисления видимой ширины всех значений).

[NULL](/ru/reference/syntax) выводится как `ᴺᵁᴸᴸ`.

<div id="example-usage">
  ## Пример использования
</div>

Пример (для формата [`PrettyCompact`](/ru/reference/formats/Pretty/PrettyCompact)):

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

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

Строки не экранируются ни в одном из форматов `Pretty`. Ниже приведён пример для формата [`PrettyCompact`](/ru/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`, выводится сообщение "Showed first 10 000".

<Note>
  Этот формат подходит только для вывода результатов запроса, но не для парсинга данных.
</Note>

Формат Pretty поддерживает вывод итоговых значений (при использовании `WITH TOTALS`) и экстремальных значений (когда `extremes` установлено в 1).
В этих случаях итоговые и экстремальные значения выводятся после основных данных в отдельных таблицах.
Это показано в следующем примере, где используется формат [`PrettyCompact`](/ru/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`:

| Настройка                                                                                                                                               | Описание                                                                                                                                                                                                                                    | По умолчанию |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| [`output_format_pretty_max_rows`](/ru/reference/settings/formats#output_format_pretty_max_rows)                                                         | Ограничение на количество строк для форматов Pretty.                                                                                                                                                                                        | `10000`      |
| [`output_format_pretty_max_column_pad_width`](/ru/reference/settings/formats#output_format_pretty_max_column_pad_width)                                 | Максимальная ширина выравнивания всех значений в столбце в форматах Pretty.                                                                                                                                                                 | `250`        |
| [`output_format_pretty_max_value_width`](/ru/reference/settings/formats#output_format_pretty_max_value_width)                                           | Максимальная ширина значения, отображаемого в форматах Pretty. Если она превышена, значение будет обрезано.                                                                                                                                 | `10000`      |
| [`output_format_pretty_color`](/ru/reference/settings/formats#output_format_pretty_color)                                                               | Использовать управляющие последовательности ANSI для цветного вывода в форматах Pretty.                                                                                                                                                     | `true`       |
| [`output_format_pretty_grid_charset`](/ru/reference/settings/formats#output_format_pretty_grid_charset)                                                 | Набор символов для вывода границ сетки. Доступные наборы: ASCII, UTF-8.                                                                                                                                                                     | `UTF-8`      |
| [`output_format_pretty_row_numbers`](/ru/reference/settings/formats#output_format_pretty_row_numbers)                                                   | Добавлять номера строк перед каждой строкой в формате вывода Pretty.                                                                                                                                                                        | `true`       |
| [`output_format_pretty_display_footer_column_names`](/ru/reference/settings/formats#output_format_pretty_display_footer_column_names)                   | Отображать имена столбцов в нижнем колонтитуле, если таблица содержит много строк.                                                                                                                                                          | `true`       |
| [`output_format_pretty_display_footer_column_names_min_rows`](/ru/reference/settings/formats#output_format_pretty_display_footer_column_names_min_rows) | Задает минимальное количество строк, начиная с которого отображается нижний колонтитул, если [`output_format_pretty_display_footer_column_names`](/ru/reference/settings/formats#output_format_pretty_display_footer_column_names) включен. | `50`         |