> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.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#output_format_pretty_max_rows) | Ограничение на количество строк для форматов Pretty. | `10000` |
| [`output_format_pretty_max_column_pad_width`](/ru/reference/settings/formats/output-format#output_format_pretty_max_column_pad_width) | Максимальная ширина выравнивания всех значений в столбце в форматах Pretty. | `250` |
| [`output_format_pretty_max_value_width`](/ru/reference/settings/formats/output-format#output_format_pretty_max_value_width) | Максимальная ширина значения, отображаемого в форматах Pretty. Если она превышена, значение будет обрезано. | `10000` |
| [`output_format_pretty_color`](/ru/reference/settings/formats/output-format#output_format_pretty_color) | Использовать управляющие последовательности ANSI для цветного вывода в форматах Pretty. | `true` |
| [`output_format_pretty_grid_charset`](/ru/reference/settings/formats/output-format#output_format_pretty_grid_charset) | Набор символов для вывода границ сетки. Доступные наборы: ASCII, UTF-8. | `UTF-8` |
| [`output_format_pretty_row_numbers`](/ru/reference/settings/formats/output-format#output_format_pretty_row_numbers) | Добавлять номера строк перед каждой строкой в формате вывода Pretty. | `true` |
| [`output_format_pretty_display_footer_column_names`](/ru/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names) | Отображать имена столбцов в нижнем колонтитуле, если таблица содержит много строк. | `true` |
| [`output_format_pretty_display_footer_column_names_min_rows`](/ru/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names_min_rows) | Задает минимальное количество строк, начиная с которого отображается нижний колонтитул, если [`output_format_pretty_display_footer_column_names`](/ru/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names) включен. | `50` |