メインコンテンツまでスキップ
メインコンテンツまでスキップ

Pretty

InputOutputAlias

説明

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

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 │
└──────────────────────────────────────┘

端末にデータをdumpしすぎないように、最初の 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_colorPretty フォーマットで色を表示するために ANSI エスケープシーケンスを使用します。true
output_format_pretty_grid_charsetグリッドボーダーを印刷するための文字セット。利用可能な文字セット: ASCII, UTF-8。UTF-8
output_format_pretty_row_numbersPretty 出力フォーマットの各行の前に行番号を追加します。true
output_format_pretty_display_footer_column_namesテーブルに多くの行が含まれている場合、フッターにカラム名を表示します。true
output_format_pretty_display_footer_column_names_min_rowsoutput_format_pretty_display_footer_column_names が有効な場合、フッターを表示するための最小行数を設定します。50