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

Pretty

输入输出别名

描述

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,则打印消息“显示前 10000 行”。

注意

此格式仅适用于输出查询结果,但不适用于解析数据。

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使用 ANSI 转义序列在 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