Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Pretty

View as MarkdownEdit this pageReport an issueSet up docs MCP
入力 出力 エイリアス
✗ ✔

説明

Pretty フォーマットは、データを Unicode アートのテーブルとして出力し、 端末で色を表示するために ANSI エスケープシーケンスを使用します。 テーブル全体の罫線が描画され、各行は端末上で 2 行分を使用します。 各結果ブロックは個別のテーブルとして出力されます。 これは、結果をバッファリングせずにブロックを出力できるようにするために必要です (すべての値の表示幅を事前に計算するにはバッファリングが必要になるためです) 。

NULL は ᴺᵁᴸᴸ として出力されます。

使用例

例 (PrettyCompact フォーマットで表示した場合) :

Querysql
SELECT * FROM t_null
Responseresponse
┌─x─┬────y─┐
│ 1 │ ᴺᵁᴸᴸ │
└───┴──────┘

どの Pretty フォーマットでも、行はエスケープされません。以下は PrettyCompact フォーマットの例です。

Querysql
SELECT 'String with \'quotes\' and \t character' AS Escaping_test
Responseresponse
┌─Escaping_test────────────────────────┐
│ String with 'quotes' and      character │
└──────────────────────────────────────┘

端末に大量のデータをダンプしすぎないよう、最初の 10,000 行のみが出力されます。 行数が 10,000 以上の場合は、"Showed first 10 000" というメッセージが出力されます。

Pretty フォーマットは、合計値 (WITH TOTALS を使用した場合) と極値 ('extremes' が 1 に設定されている場合) の出力をサポートしています。 この場合、合計値と極値はメインデータの後に、それぞれ別のテーブルとして出力されます。 この動作は、PrettyCompact フォーマットを使用する次の例で示されています。

Querysql
SELECT EventDate, count() AS c 
FROM test.hits 
GROUP BY EventDate 
WITH TOTALS 
ORDER BY EventDate 
FORMAT PrettyCompact
Responseresponse
┌──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 フォーマットに共通です。

Setting Description Default
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
Navigation