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

Pretty

InputOutputAlias

説明

Pretty フォーマットは、データを Unicode アートテーブルとして出力し、ターミナルで色を表示するために 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 │
└──────────────────────────────────────┘

ターミナルにあまりにも多くのデータを出力しないように、最初の 10,000 行のみが出力されます。 行数が 10,000 以上の場合、メッセージ "Showed first 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 │
└────────────┴─────────┘

合計:
┌──EventDate─┬───────c─┐
│ 1970-01-01 │ 8873898 │
└────────────┴─────────┘

極値:
┌──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