Pretty

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

Описание

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

NULL выводится как ᴺᵁᴸᴸ.

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

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

SELECT * FROM t_null

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

Строки не экранируются ни в одном из форматов семейства Pretty. Следующий пример показан для формата PrettyCompact:

SELECT 'Строка с \'кавычками\' и символом табуляции \t' AS Escaping_test

┌─Escaping_test────────────────────────┐
│ Строка с 'кавычками' и      символом │
└──────────────────────────────────────┘

Чтобы не выводить в терминал слишком большой объём данных, печатаются только первые 10,000 строк. Если количество строк больше либо равно 10,000, выводится сообщение «Showed first 10 000».

Примечание

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

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

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

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

Итого:
┌──EventDate─┬───────c─┐
│ 1970-01-01 │ 8873898 │
└────────────┴─────────┘

Минимальные и максимальные значения:
┌──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