Pretty

Input	Output	Alias
✗	✔

描述

Pretty 格式将数据输出为 Unicode 艺术表格，使用 ANSI 转义序列在终端中显示颜色。整个表格的网格被绘制，每行在终端中占据两行。每个结果块作为一个单独的表格输出。这样可以不对结果进行缓冲（如果缓冲，必须预先计算所有值的可见宽度）。

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`	在 Pretty 格式中使用 ANSI 转义序列来着色。	`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`

描述​

示例用法​

格式设置​

描述

示例用法

格式设置