> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Pretty フォーマットに関するドキュメント

# Pretty

| 入力 | 出力 | エイリアス |
| -- | -- | ----- |
| ✗  | ✔  |       |

<div id="description">
  ## 説明
</div>

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

[NULL](/docs/ja/reference/syntax) は `ᴺᵁᴸᴸ` として出力されます。

<div id="example-usage">
  ## 使用例
</div>

例 ([`PrettyCompact`](/docs/ja/reference/formats/Pretty/PrettyCompact) フォーマットで表示した場合) :

```sql title="Query" theme={null}
SELECT * FROM t_null
```

```response title="Response" theme={null}
┌─x─┬────y─┐
│ 1 │ ᴺᵁᴸᴸ │
└───┴──────┘
```

どの `Pretty` フォーマットでも、行はエスケープされません。以下は [`PrettyCompact`](/docs/ja/reference/formats/Pretty/PrettyCompact) フォーマットの例です。

```sql title="Query" theme={null}
SELECT 'String with \'quotes\' and \t character' AS Escaping_test
```

```response title="Response" theme={null}
┌─Escaping_test────────────────────────┐
│ String with 'quotes' and      character │
└──────────────────────────────────────┘
```

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

<Note>
  このフォーマットはクエリ結果の出力にのみ適しており、データのパースには適していません。
</Note>

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

```sql title="Query" theme={null}
SELECT EventDate, count() AS c 
FROM test.hits 
GROUP BY EventDate 
WITH TOTALS 
ORDER BY EventDate 
FORMAT PrettyCompact
```

```response title="Response" theme={null}
┌──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 │
└────────────┴─────────┘
```

<div id="format-settings">
  ## フォーマット設定
</div>

以下の設定は、すべての `Pretty` フォーマットに共通です。

| Setting                                                                                                                                                 | Description                                                                                                                                                        | Default |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- |
| [`output_format_pretty_max_rows`](/docs/ja/reference/settings/formats#output_format_pretty_max_rows)                                                         | Pretty フォーマットの行数上限。                                                                                                                                                | `10000` |
| [`output_format_pretty_max_column_pad_width`](/docs/ja/reference/settings/formats#output_format_pretty_max_column_pad_width)                                 | Pretty フォーマットにおいて、カラム内のすべての値に適用されるパディングの最大幅。                                                                                                                       | `250`   |
| [`output_format_pretty_max_value_width`](/docs/ja/reference/settings/formats#output_format_pretty_max_value_width)                                           | Pretty フォーマットで表示される値の最大幅。これを超える場合は切り詰められます。                                                                                                                        | `10000` |
| [`output_format_pretty_color`](/docs/ja/reference/settings/formats#output_format_pretty_color)                                                               | ANSI エスケープシーケンスを使用して、Pretty フォーマットに色を付けます。                                                                                                                         | `true`  |
| [`output_format_pretty_grid_charset`](/docs/ja/reference/settings/formats#output_format_pretty_grid_charset)                                                 | グリッドの罫線を出力するための文字セット。使用可能な文字セット: ASCII、UTF-8。                                                                                                                      | `UTF-8` |
| [`output_format_pretty_row_numbers`](/docs/ja/reference/settings/formats#output_format_pretty_row_numbers)                                                   | Pretty 出力フォーマットで、各行の前に行番号を追加します。                                                                                                                                   | `true`  |
| [`output_format_pretty_display_footer_column_names`](/docs/ja/reference/settings/formats#output_format_pretty_display_footer_column_names)                   | テーブルに多数の行が含まれている場合、フッターにカラム名を表示します。                                                                                                                                | `true`  |
| [`output_format_pretty_display_footer_column_names_min_rows`](/docs/ja/reference/settings/formats#output_format_pretty_display_footer_column_names_min_rows) | [`output_format_pretty_display_footer_column_names`](/docs/ja/reference/settings/formats#output_format_pretty_display_footer_column_names) が有効な場合に、フッターを表示する最小行数を設定します。 | `50`    |