Pretty

入力	出力	エイリアス
✗	✔

説明

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 形式に共通です:

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`	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`

説明​

使用例​

書式設定​

説明

使用例

書式設定