Pretty

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

Описание

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

Пример использования

Пример (для формата PrettyCompact):

Query

SELECT * FROM t_null

Response

┌─x─┬────y─┐
│ 1 │ ᴺᵁᴸᴸ │
└───┴──────┘

Строки не экранируются ни в одном из форматов Pretty. Вместо этого непечатаемые управляющие символы (управляющие символы C0 0x00-0x1F и DEL 0x7F) в значениях и именах столбцов по умолчанию отображаются соответствующими символами Unicode “Control Pictures” (U+2400-U+2421): так они остаются видимыми и не искажают таблицу. Например, символ NUL отображается как ␀:

Query

SELECT 'String with a NUL \0 character' AS Escaping_test FORMAT PrettyCompact

Response

┌─Escaping_test─────────────────┐
│ String with a NUL ␀ character │
└───────────────────────────────┘

TAB, перевод строки и ESC являются исключениями: они всегда выводятся как есть, поскольку терминал не поглощает их, а интерпретирует: символ табуляции перемещает курсор к следующей позиции табуляции, а ANSI-последовательность экранирования позволяет встраивать в данные визуализацию. Перевод строки по-прежнему разрывает строку: внутри ячейки таблицы, если включена настройка output_format_pretty_multiline_fields, и как есть в остальных случаях. Исключением из этого исключения является имя столбца: заголовок и нижний колонтитул выводятся в одну строку, поэтому перевод строки в имени заменяется так же, как любой другой управляющий символ. Чтобы выводить управляющие символы без изменений, отключите настройку output_format_pretty_display_control_characters:

Query

SELECT 'String with a NUL \0 character' AS Escaping_test FORMAT PrettyCompact
SETTINGS output_format_pretty_display_control_characters = 0

В этом случае ответ содержит необработанный байт NUL. Терминал его поглощает, поэтому символ не отображается, а строка оказывается на одну позицию шире рамки, рассчитанной для неё, — именно такого искажения таблицы позволяет избежать отображение символа из блока Control Pictures. Чтобы не выводить в терминал слишком много данных, печатаются только первые 10,000 строк. Если количество строк больше или равно 10,000, выводится сообщение “Showed first 10 000”.

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

Формат Pretty поддерживает вывод итоговых значений (при использовании WITH TOTALS) и экстремальных значений (когда extremes установлено в 1). В этих случаях итоговые и экстремальные значения выводятся после основных данных в отдельных таблицах. Это показано в следующем примере, где используется формат PrettyCompact:

Query

SELECT EventDate, count() AS c 
FROM test.hits 
GROUP BY EventDate 
WITH TOTALS 
ORDER BY EventDate 
FORMAT PrettyCompact

Response

┌──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 │
└────────────┴─────────┘

Настройки формата

Следующие настройки являются общими для всех форматов Pretty:

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

Справочник по SQL

Типы данных

Движки

Функции

Форматы

Настройки

Системные таблицы

Озера данных

Описание

Пример использования

Настройки формата

​Описание

​Пример использования

​Настройки формата

Описание

Пример использования

Настройки формата