Перейти к основному содержимому
Перейти к основному содержимому

Pretty

InputOutputAlias

Описание

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

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

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

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

SELECT * FROM t_null
┌─x─┬────y─┐
│ 1 │ ᴺᵁᴸᴸ │
└───┴──────┘

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

SELECT 'String with \'quotes\' and \t character' AS Escaping_test
┌─Escaping_test────────────────────────┐
│ String with 'quotes' and      character │
└──────────────────────────────────────┘

Чтобы избежать слишком объемного вывода данных в терминал, печатаются только первые 10,000 строк. Если количество строк больше либо равно 10,000, появляется сообщение "Показано первых 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 │
└────────────┴─────────┘

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 escape последовательности для раскраски в Pretty форматах.true
output_format_pretty_grid_charsetКодировка для печати границ сетки. Доступные кодировки: ASCII, UTF-8.UTF-8
output_format_pretty_row_numbersДобавить номера строк перед каждой строкой для красивого выходного формата.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