跳到主要内容
跳到主要内容

Pretty

InputOutputAlias

描述

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_rowsPretty 格式的行限制。10000
output_format_pretty_max_column_pad_widthPretty 格式中列中所有值的最大填充宽度。250
output_format_pretty_max_value_widthPretty 格式中要显示的值的最大宽度。如果超过此值,将被截断。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