Pretty

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

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

​

Описание

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

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

​

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

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

Query

SELECT * FROM t_null

Response

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

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

Query

SELECT 'String with \'quotes\' and \t character' AS Escaping_test

Response

┌─Escaping_test────────────────────────┐
│ String with 'quotes' and      character │
└──────────────────────────────────────┘

Чтобы не выводить в терминал слишком много данных, печатаются только первые 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