Pretty

输入	输出	别名
✗	✔

描述

Pretty 格式会将数据输出为 Unicode 艺术表格，并使用 ANSI 转义序列在终端中显示颜色。表格会绘制完整的网格，并且每一行在终端中占用两行。每个结果块都会作为单独的表输出。这样做是必要的，因为只有这样才能在不缓冲结果的情况下输出块 (否则需要先进行缓冲，以预先计算所有值的可见宽度) 。 NULL 会输出为 ᴺᵁᴸᴸ。

示例用法

示例 (以 PrettyCompact 格式展示) ：

Query

SELECT * FROM t_null

Response

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

在任何 Pretty 格式中，行都不会进行转义。默认情况下，值和列名中的不可打印控制字符 (C0 控制字符 0x00-0x1F 以及 DEL 0x7F) 会显示为对应的 Unicode “Control Pictures” 字符 (U+2400-U+2421) ，从而保持可见，且不会破坏表格布局。例如，NUL 会显示为 ␀：

Query

SELECT 'String with a NUL \0 character' AS Escaping_test FORMAT PrettyCompact

Response

┌─Escaping_test─────────────────┐
│ String with a NUL ␀ character │
└───────────────────────────────┘

TAB、换行符和 ESC 是例外：它们总是按原样输出，因为终端会解释这些字符，而不是将其吞掉——制表符会跳到下一个制表位，而数据正是借助 ANSI 转义序列才能呈现可视化效果。换行符也照常换行：启用 output_format_pretty_multiline_fields 时，在表格单元格内换行；否则按原样输出。列名则是这一例外中的例外：表头和表尾都只占一行，因此名称中的换行符会像其他控制字符一样被替换。如需按原样输出控制字符，请禁用 output_format_pretty_display_control_characters：

Query

SELECT 'String with a NUL \0 character' AS Escaping_test FORMAT PrettyCompact
SETTINGS output_format_pretty_display_control_characters = 0

此时，响应中包含的是原始的 NUL 字节。终端会吞掉该字节，导致该字符不可见，而该行也会比为其测量的边框多出一个字符宽度——显示 Control Picture 正是为了避免这种表格变形。为避免向终端输出过多数据，只会打印前 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`	在 Pretty 格式中使用 ANSI 转义序列显示颜色。	`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`

SQL 参考文档

数据类型

引擎

函数

格式

设置

系统表

数据湖

描述

示例用法

格式设置

​描述

​示例用法

​格式设置

描述

示例用法

格式设置