> ## 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.

# output_format_* フォーマット設定

> output_format_* として生成されるグループ内の ClickHouse フォーマット設定。

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>型</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>デフォルト値</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          再起動せずに変更可能
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

これらの設定は、[source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/FormatFactorySettings.h) から自動生成されています。

<div id="output_format_always_write_decimal_point_in_float_and_decimal">
  ## output\_format\_always\_write\_decimal\_point\_in\_float\_and\_decimal
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "浮動小数点数および Decimal 型の数値について、値が整数であってもテキストフォーマットでは常に小数点を出力する新しい設定。"}]}]} />

値が整数であっても、浮動小数点数および Decimal 型の数値では、テキストフォーマットで常に小数点を出力します。たとえば、`1` ではなく `1.` を出力します。

デフォルトでは無効です。

<div id="output_format_arrow_compression_method">
  ## output\_format\_arrow\_compression\_method
</div>

<SettingsInfoBlock type="ArrowCompression" default_value="lz4_frame" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "23.3"},{"label": "lz4_frame"},{"label": "デフォルトで Arrow 出力フォーマットに lz4 圧縮を使用"}]}]} />

Arrow 出力フォーマットの圧縮方式。サポートされているコーデック: lz4\_frame、zstd、none (非圧縮)

<div id="output_format_arrow_date_as_uint16">
  ## output\_format\_arrow\_date\_as\_uint16
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.2"},{"label": "0"},{"label": "既定では、Date の値は通常の UInt16 ではなく、Arrow DATE32 として書き込まれます。"}]}]} />

Date の値を、32 ビットの Arrow DATE32 型 (読み戻し時は Date32) に変換する代わりに、通常の 16 ビット数値 (読み戻し時は UInt16) として書き込みます。

<div id="output_format_arrow_fixed_string_as_fixed_byte_array">
  ## output\_format\_arrow\_fixed\_string\_as\_fixed\_byte\_array
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "23.2"},{"label": "1"},{"label": "デフォルトで、FixedString に Arrow FIXED_SIZE_BINARY 型を使用"}]}]} />

FixedString 型のカラムでは、Binary ではなく Arrow FIXED\_SIZE\_BINARY 型を使用します。

<div id="output_format_arrow_low_cardinality_as_dictionary">
  ## output\_format\_arrow\_low\_cardinality\_as\_dictionary
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

出力時に LowCardinality 型を Dictionary Arrow 型として有効にします

<div id="output_format_arrow_string_as_string">
  ## output\_format\_arrow\_string\_as\_string
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "1"},{"label": "ClickHouse では、通常は UTF-8 として扱われる String データ型に任意のバイナリデータを格納できます。Parquet\/ORC\/Arrow の String は UTF-8 のみをサポートしています。そのため、ClickHouse の String データ型に対して使用する Arrow のデータ型として、String と Binary のどちらを使うかを選択できます。より正確で互換性が高いのは Binary ですが、多くの場合、デフォルトで String を使用するほうがユーザーの期待に沿います。"}]}]} />

String 型のカラムには、Binary ではなく Arrow String 型を使用します

<div id="output_format_arrow_unsupported_types_as_binary">
  ## output\_format\_arrow\_unsupported\_types\_as\_binary
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "1"},{"label": "サポートされていない CH 型を、UNKNOWN_TYPE exception ではなく Arrow の binary に変換するための新しい設定。"}]}]} />

変換できない出力型を、生の binary data として出力します。false の場合、そのような型では UNKNOWN\_TYPE exception が発生します。

<div id="output_format_arrow_use_64_bit_indexes_for_dictionary">
  ## output\_format\_arrow\_use\_64\_bit\_indexes\_for\_dictionary
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.1"},{"label": "0"},{"label": "Arrow の辞書で 64 ビット索引型を使用できるようにします"}]}, {"id": "row-2","items": [{"label": "24.1"},{"label": "0"},{"label": "Arrow の辞書で 64 ビット索引型を使用できるようにします"}]}]} />

Arrow フォーマットの辞書索引には、常に 64 ビット整数を使用します

<div id="output_format_arrow_use_native_writer">
  ## output\_format\_arrow\_use\_native\_writer
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "1"},{"label": "Apache Arrow ライブラリの代わりに、Arrow および ArrowStream フォーマットでネイティブの ClickHouse ライターを使用するための新しい設定。"}]}]} />

Arrow および ArrowStream フォーマットでは、Apache Arrow ライブラリベースのライターではなく、ネイティブの ClickHouse ライターを使用します。

<div id="output_format_arrow_use_signed_indexes_for_dictionary">
  ## output\_format\_arrow\_use\_signed\_indexes\_for\_dictionary
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.1"},{"label": "1"},{"label": "推奨されているため、デフォルトで Arrow format の辞書に符号付きの索引型を使用する"}]}]} />

Arrow format の辞書の索引に符号付き整数を使用します

<div id="output_format_avro_codec">
  ## output\_format\_avro\_codec
</div>

出力時に使用する圧縮コーデック。設定可能な値: 'null', 'deflate', 'snappy', 'zstd'。

<div id="output_format_avro_confluent_subject">
  ## output\_format\_avro\_confluent\_subject
</div>

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": ""},{"label": "AvroConfluent 形式で出力する際に、Confluent スキーマレジストリでのスキーマ登録に使用する subject 名を指定するための新しい設定。"}]}]} />

AvroConfluent 出力フォーマット用: Confluent スキーマレジストリでスキーマを登録する際の subject 名です。AvroConfluent 形式で出力する場合に必須です。

<div id="output_format_avro_rows_in_file">
  ## output\_format\_avro\_rows\_in\_file
</div>

<SettingsInfoBlock type="UInt64" default_value="1" />

1ファイルあたりの最大行数 (ストレージが許可している場合)

<div id="output_format_avro_string_column_pattern">
  ## output\_format\_avro\_string\_column\_pattern
</div>

Avro フォーマットの場合: AVRO 文字列として選択する String 型のカラムを指定する正規表現。

<div id="output_format_avro_sync_interval">
  ## output\_format\_avro\_sync\_interval
</div>

<SettingsInfoBlock type="UInt64" default_value="16384" />

バイト単位で指定する同期間隔。

<div id="output_format_binary_encode_types_in_binary_format">
  ## output\_format\_binary\_encode\_types\_in\_binary\_format
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.7"},{"label": "0"},{"label": "RowBinaryWithNamesAndTypes 出力フォーマットで型名をバイナリ形式で書き込めるようにする新しい設定を追加"}]}]} />

RowBinaryWithNamesAndTypes 出力フォーマットで、型名の代わりにデータ型をバイナリ形式で書き込みます

<div id="output_format_binary_write_json_as_string">
  ## output\_format\_binary\_write\_json\_as\_string
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "0"},{"label": "RowBinary 出力フォーマットで [JSON](/docs/reference/data-types/newjson) 型の値を JSON [String](/docs/reference/data-types/string) 値として書き込むための新しい設定を追加"}]}]} />

[JSON](/docs/ja/reference/data-types/newjson) 型の値を、RowBinary 出力フォーマットでは JSON [String](/docs/ja/reference/data-types/string) 値として書き込みます。

<div id="output_format_bson_string_as_string">
  ## output\_format\_bson\_string\_as\_string
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

String 型のカラムでは、Binary ではなく BSON String 型を使用します。

<div id="output_format_compression_level">
  ## output\_format\_compression\_level
</div>

<SettingsInfoBlock type="UInt64" default_value="3" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.1"},{"label": "3"},{"label": "クエリ出力の圧縮レベルを変更できるようになりました"}]}]} />

クエリ出力が圧縮される場合のデフォルトの圧縮レベルです。この設定は、`SELECT` クエリで `INTO OUTFILE` を使用する場合、またはテーブル関数 `file`、`url`、`hdfs`、`s3`、`azureBlobStorage` に書き込む場合に適用されます。

設定可能な値: `1` ～ `22`

<div id="output_format_compression_zstd_window_log">
  ## output\_format\_compression\_zstd\_window\_log
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.1"},{"label": "0"},{"label": "zstd 圧縮の使用時に、クエリ出力で zstd の window log を変更できるようになりました"}]}]} />

出力の圧縮方式が `zstd` の場合に使用できます。`0` より大きい値を指定すると、この設定により圧縮ウィンドウサイズ (`2` の累乗) が明示的に設定され、zstd 圧縮の long-range モードが有効になります。これにより、圧縮率が向上する場合があります。

設定可能な値: 0 以上の数値。値が小さすぎたり大きすぎたりすると、`zstdlib` は例外をスローします。一般的な値は `20` (window size = `1MB`) から `30` (window size = `1GB`) です。

<div id="output_format_csv_crlf_end_of_line">
  ## output\_format\_csv\_crlf\_end\_of\_line
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

これを true に設定すると、CSV フォーマットの行末は \n ではなく \r\n になります。

<div id="output_format_csv_header_serialize_tuple_into_separate_columns">
  ## output\_format\_csv\_header\_serialize\_tuple\_into\_separate\_columns
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "1"},{"label": "新しい設定。output_format_csv_serialize_tuple_into_separate_columns が有効な場合、CSVWithNames\/CSVWithNamesAndTypes のヘッダーは Tuple カラムをその leaf フィールドにフラット化し、ヘッダーの幅がデータと一致するようになりました。以前の単一名ヘッダーに戻すには false に設定します。"}]}]} />

[output\_format\_csv\_serialize\_tuple\_into\_separate\_columns](/docs/ja/reference/settings/formats/output-format#output_format_csv_serialize_tuple_into_separate_columns) が有効な場合、`CSVWithNames` と `CSVWithNamesAndTypes` のヘッダー行では、各 Tuple カラムがその leaf フィールド (`t.a`、`t.b` のようなドット区切りの名前と、leaf の型名) にフラット化されるため、ヘッダーのカラム数はデータと同じになります。`CustomSeparated*` では、このフラット化は `format_custom_escaping_rule = 'CSV'` かつ `format_custom_field_delimiter` が `format_csv_delimiter` と同じ単一文字である場合にのみ適用されます。それ以外の場合 (たとえばデフォルトのタブ区切り文字や `format_custom_field_delimiter = '|'`) では、ヘッダーはフラット化されないままとなり、引き続きデータと一致します。ヘッダーが単一のトップレベル Tuple 名と型を保持する以前の動作のままにするには、`0` に設定します。

注意: `input_format_with_names_use_header = 1` の場合、フラット化されたヘッダーは名前に基づいて Tuple に読み戻されません。このようなデータを Tuple に読み戻すには、出力時にこの設定を `0` にするか、`input_format_with_names_use_header = 0` を指定して読み込んでください (さらに、`*WithNamesAndTypes` フォーマットである `CSVWithNamesAndTypes` と `CustomSeparatedWithNamesAndTypes` では、`input_format_with_types_use_header = 0` も必要です。これを設定しないと、フラット化された型の行が単一のトップレベル Tuple 入力フィールドに対して検証され、拒否されます) 。

<div id="output_format_csv_serialize_tuple_into_separate_columns">
  ## output\_format\_csv\_serialize\_tuple\_into\_separate\_columns
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.6"},{"label": "1"},{"label": "CSVフォーマットでの Tuple の新しい解釈方法が追加されました。"}]}, {"id": "row-2","items": [{"label": "24.3"},{"label": "1"},{"label": "CSVフォーマットでの Tuple の新しい解釈方法が追加されました。"}]}]} />

true に設定すると、CSVフォーマットの Tuple は個別のカラムとしてシリアライズされます (つまり、Tuple のネスト構造は失われます) 。

<div id="output_format_decimal_trailing_zeros">
  ## output\_format\_decimal\_trailing\_zeros
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "21.9"},{"label": "0"},{"label": "出力の見栄えをよくするため、既定では Decimal 型のテキスト表現で末尾のゼロを出力しません"}]}]} />

Decimal 値を出力する際に、末尾のゼロも出力します。例: 1.23 ではなく 1.230000。

既定では無効です。

<div id="output_format_float_precision">
  ## output\_format\_float\_precision
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "浮動小数点出力の小数点以下の桁数を制御する新しい設定"}]}]} />

0 以外の場合、浮動小数点出力 (`Float32`、`Float64`、`BFloat16`) は、小数点以下の桁数が最大でこの値になるようにフォーマットされます (末尾のゼロは削除されます) 。
0 の場合 (デフォルト) は、最短の往復変換表現が使用されます。

固定小数点表記では大きすぎる値や、要求された精度に丸めるとすべての有効桁が失われてしまうほど絶対値の小さい値 (仮数が `±0` になる場合) は、代わりに指数表記で出力されます。こうしたフォールバック時には、仮数の小数点以下の桁数が要求された桁数を超えることがあります。

有効範囲: 0 から 100。

<div id="output_format_image_height">
  ## output\_format\_image\_height
</div>

<SettingsInfoBlock type="UInt64" default_value="1024" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "1024"},{"label": "PNG などの画像出力フォーマットにおける出力画像の高さを制御する新しい設定。"}]}]} />

`PNG` などの画像出力フォーマットでの出力画像の高さを、ピクセル単位で指定します。

デフォルト値: 1024。

<div id="output_format_image_terminal_mode">
  ## output\_format\_image\_terminal\_mode
</div>

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": ""},{"label": "PNG などの画像出力フォーマットを、生の画像バイト列を書き出す代わりにインライン画像プロトコルを使って端末に直接描画するかどうかを制御する新しい設定。"}]}]} />

`PNG` などの画像出力フォーマットでは、生の画像バイト列を書き出す代わりに、インライン画像プロトコルを使って画像を端末に直接描画します。

設定可能な値:

* \`\` (空) — 生の画像バイト列を書き出します (デフォルト) 。
* `iterm` — iTerm2 のインライン画像プロトコルを使用します。
* `kitty` — Kitty の graphics プロトコルを使用します。
* `sixel` — Sixel プロトコルを使用します。
* `auto` — 出力先が端末の場合は、その対応機能を検出して `iterm`、`kitty`、`sixel` のいずれかを使用します (この順序) 。それ以外の場合は、生の画像バイト列を書き出します。

デフォルト値: \`\` (空)。

<div id="output_format_image_width">
  ## output\_format\_image\_width
</div>

<SettingsInfoBlock type="UInt64" default_value="1024" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "1024"},{"label": "PNG などの画像出力フォーマットでの出力画像の幅を制御する新しい設定。"}]}]} />

`PNG` などの画像出力フォーマットで出力される画像の幅 (ピクセル単位) です。

デフォルト値: 1024。

<div id="output_format_json_array_of_rows">
  ## output\_format\_json\_array\_of\_rows
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

[JSONEachRow](/docs/ja/reference/formats/JSON/JSONEachRow)フォーマットで、すべての行を JSON array として出力する機能を有効にします。

設定可能な値:

* 1 — ClickHouse はすべての行を配列として出力し、各行は `JSONEachRow` フォーマットになります。
* 0 — ClickHouse は各行を `JSONEachRow` フォーマットで個別に出力します。

**この設定を有効にしたクエリの例**

クエリ:

```sql theme={null}
SET output_format_json_array_of_rows = 1;
SELECT number FROM numbers(3) FORMAT JSONEachRow;
```

結果:

```text theme={null}
[
{"number":"0"},
{"number":"1"},
{"number":"2"}
]
```

**設定を無効にしたクエリの例**

クエリ:

```sql theme={null}
SET output_format_json_array_of_rows = 0;
SELECT number FROM numbers(3) FORMAT JSONEachRow;
```

結果:

```text theme={null}
{"number":"0"}
{"number":"1"}
{"number":"2"}
```

<div id="output_format_json_escape_forward_slashes">
  ## output\_format\_json\_escape\_forward\_slashes
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

JSON出力フォーマットで文字列を出力する際に、スラッシュをエスケープするかどうかを制御します。これは JavaScript との互換性のための設定です。常にエスケープされるバックスラッシュと混同しないでください。

デフォルトで有効です。

<div id="output_format_json_map_as_array_of_tuples">
  ## output\_format\_json\_map\_as\_array\_of\_tuples
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.7"},{"label": "0"},{"label": "新しい設定"}]}]} />

Map型のカラムを、TupleのJSON配列としてシリアライズします。

デフォルトでは無効です。

<div id="output_format_json_named_tuples_as_objects">
  ## output\_format\_json\_named\_tuples\_as\_objects
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "22.6"},{"label": "1"},{"label": "デフォルトで、JSON フォーマットで名前付きタプルを JSON オブジェクトとしてシリアライズできるようになりました"}]}]} />

名前付きタプル型のカラムを JSON オブジェクトとしてシリアライズします。

デフォルトで有効です。

<div id="output_format_json_pretty_print">
  ## output\_format\_json\_pretty\_print
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1"},{"label": "JSON 出力フォーマットで値をデフォルトで見やすい形式で出力する"}]}]} />

この設定は、JSON 出力フォーマットを使用する際に、`data` 配列内の Tuples、Maps、Arrays などのネストされた構造をどのように表示するかを決定します。

たとえば、次のように出力するのではなく:

```json theme={null}
"data":
[
  {
    "tuple": {"a":1,"b":2,"c":3},
    "array": [1,2,3],
    "map": {"a":1,"b":2,"c":3}
  }
],
```

出力は次のように表示されます:

```json theme={null}
"data":
[
    {
        "tuple": {
            "a": 1,
            "b": 2,
            "c": 3
        },
        "array": [
            1,
            2,
            3
        ],
        "map": {
            "a": 1,
            "b": 2,
            "c": 3
        }
    }
],
```

デフォルトで有効です。

<div id="output_format_json_quote_64bit_floats">
  ## output\_format\_json\_quote\_64bit\_floats
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

JSON\* フォーマットで出力する際に、64 ビットの[floats](/docs/ja/reference/data-types/float)を引用符で囲むかどうかを制御します。

デフォルトでは無効です。

<div id="output_format_json_quote_64bit_integers">
  ## output\_format\_json\_quote\_64bit\_integers
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "デフォルトで JSON 内の 64 ビット整数をクォートしない"}]}]} />

[JSON](/docs/ja/reference/formats/JSON/JSON)フォーマットで出力する際に、64 ビット以上の[整数](/docs/ja/reference/data-types/int-uint) (`UInt64` や `Int128` など) をクォートするかどうかを制御します。
これらの整数は、デフォルトでクォートで囲まれます。この動作は、ほとんどの JavaScript 実装と互換性があります。

設定可能な値:

* 0 — 整数はクォートなしで出力されます。
* 1 — 整数はクォートで囲まれて出力されます。

<div id="output_format_json_quote_decimals">
  ## output\_format\_json\_quote\_decimals
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

JSON出力フォーマットで decimal 値を引用符で囲むかどうかを制御します。

デフォルトでは無効です。

<div id="output_format_json_quote_denormals">
  ## output\_format\_json\_quote\_denormals
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

[JSON](/docs/ja/reference/formats/JSON/JSON) 出力フォーマットで `+nan`、`-nan`、`+inf`、`-inf` を出力するかどうかを指定します。

設定可能な値:

* 0 — 無効。
* 1 — 有効。

**例**

次のテーブル `account_orders` について考えます:

```text theme={null}
┌─id─┬─name───┬─duration─┬─period─┬─area─┐
│  1 │ Andrew │       20 │      0 │  400 │
│  2 │ John   │       40 │      0 │    0 │
│  3 │ Bob    │       15 │      0 │ -100 │
└────┴────────┴──────────┴────────┴──────┘
```

`output_format_json_quote_denormals = 0` の場合、クエリの出力では `null` 値が返されます:

```sql theme={null}
SELECT area/period FROM account_orders FORMAT JSON;
```

```json theme={null}
{
        "meta":
        [
                {
                        "name": "divide(area, period)",
                        "type": "Float64"
                }
        ],

        "data":
        [
                {
                        "divide(area, period)": null
                },
                {
                        "divide(area, period)": null
                },
                {
                        "divide(area, period)": null
                }
        ],

        "rows": 3,

        "statistics":
        {
                "elapsed": 0.003648093,
                "rows_read": 3,
                "bytes_read": 24
        }
}
```

`output_format_json_quote_denormals = 1` の場合、クエリは以下を返します:

```json theme={null}
{
        "meta":
        [
                {
                        "name": "divide(area, period)",
                        "type": "Float64"
                }
        ],

        "data":
        [
                {
                        "divide(area, period)": "inf"
                },
                {
                        "divide(area, period)": "-nan"
                },
                {
                        "divide(area, period)": "-inf"
                }
        ],

        "rows": 3,

        "statistics":
        {
                "elapsed": 0.000070241,
                "rows_read": 3,
                "bytes_read": 24
        }
}
```

<div id="output_format_json_skip_null_value_in_named_tuples">
  ## output\_format\_json\_skip\_null\_value\_in\_named\_tuples
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

名前付きタプルのカラムを JSON オブジェクトとしてシリアライズする際に、NULL 値を含むキーと値のペアをスキップします。これは output\_format\_json\_named\_tuples\_as\_objects が true の場合にのみ有効です。

<div id="output_format_json_validate_utf8">
  ## output\_format\_json\_validate\_utf8
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

JSON 出力フォーマットにおける UTF-8 シーケンスの検証を制御します。formats JSON/JSONCompact/JSONColumnsWithMetadata には影響せず、これらは常に UTF-8 を検証します。

デフォルトでは無効です。

<div id="output_format_markdown_escape_special_characters">
  ## output\_format\_markdown\_escape\_special\_characters
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

有効にすると、Markdown の特殊文字をエスケープします。

[Common Mark](https://spec.commonmark.org/0.30/#example-12) では、エスケープ可能な特殊文字として次のものが定義されています。

```
! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~
```

設定可能な値：

* 0 — 無効。
* 1 — 有効。

<div id="output_format_msgpack_uuid_representation">
  ## output\_format\_msgpack\_uuid\_representation
</div>

<SettingsInfoBlock type="MsgPackUUIDRepresentation" default_value="ext" />

MsgPackフォーマットでUUIDを出力する際の形式。

<div id="output_format_native_encode_types_in_binary_format">
  ## output\_format\_native\_encode\_types\_in\_binary\_format
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.7"},{"label": "0"},{"label": "Native 出力フォーマットで型名をバイナリ形式で書き込めるようにする設定を追加"}]}]} />

Native 出力フォーマットでは、型名の代わりにデータ型をバイナリ形式で書き込みます

<div id="output_format_native_use_flattened_dynamic_and_json_serialization">
  ## output\_format\_native\_use\_flattened\_dynamic\_and\_json\_serialization
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.6"},{"label": "0"},{"label": "Native format にフラット化された Dynamic/JSON シリアライゼーションを追加"}]}]} />

[JSON](/docs/ja/reference/data-types/newjson) および [Dynamic](/docs/ja/reference/data-types/dynamic) カラムのデータを、フラット化されたフォーマット (すべての型/パスを個別のサブカラムとして扱う) で書き込みます。

<div id="output_format_native_write_json_as_string">
  ## output\_format\_native\_write\_json\_as\_string
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "0"},{"label": "Native formatでJSONカラムを単一のStringカラムとして書き込めるようにする新しい設定を追加"}]}]} />

[JSON](/docs/ja/reference/data-types/newjson)カラムのデータを、デフォルトのネイティブJSONシリアライゼーションではなく、JSON文字列を含む[String](/docs/ja/reference/data-types/string)カラムとして書き込みます。

<div id="output_format_orc_compression_block_size">
  ## output\_format\_orc\_compression\_block\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="262144" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "262144"},{"label": "新しい設定"}]}]} />

ORC出力フォーマットにおける圧縮ブロックのサイズ (バイト単位) 。

<div id="output_format_orc_compression_method">
  ## output\_format\_orc\_compression\_method
</div>

<SettingsInfoBlock type="ORCCompression" default_value="zstd" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "zstd"},{"label": "Parquet\/ORC\/Arrow は、lz4 や zstd を含む多くの圧縮方式をサポートしています。ClickHouse はこれらすべての圧縮方式に対応しています。'duckdb' のように、より高速な `lz4` 圧縮方式をサポートしていないツールもあるため、デフォルトでは zstd を使用しています。"}]}, {"id": "row-2","items": [{"label": "23.3"},{"label": "lz4_frame"},{"label": "デフォルトで ORC 出力フォーマットに lz4 圧縮を使用"}]}]} />

ORC 出力フォーマットの圧縮方式。サポートされているコーデック: lz4, snappy, zlib, zstd, none (非圧縮)

<div id="output_format_orc_dictionary_key_size_threshold">
  ## output\_format\_orc\_dictionary\_key\_size\_threshold
</div>

<SettingsInfoBlock type="Double" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.9"},{"label": "0"},{"label": "ORC 出力フォーマットの文字列カラムで、一意な値の数が非 NULL 行の総数に対するこの割合を超える場合、dictionary encoding は無効になります。そうでない場合は有効になります"}]}]} />

ORC 出力フォーマットの文字列カラムで、一意な値の数が非 NULL 行の総数に対するこの割合を超える場合、dictionary encoding は無効になります。そうでない場合は有効になります

<div id="output_format_orc_row_index_stride">
  ## output\_format\_orc\_row\_index\_stride
</div>

<SettingsInfoBlock type="UInt64" default_value="10000" />

ORC出力フォーマットでの目標行索引ストライド

<div id="output_format_orc_string_as_string">
  ## output\_format\_orc\_string\_as\_string
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "1"},{"label": "ClickHouse では、通常 UTF-8 として扱われる String データ型に任意のバイナリデータを格納できます。一方、Parquet/ORC/Arrow の String は UTF-8 のみをサポートします。そのため、ClickHouse の String データ型に対して Arrow のどのデータ型を使うかを、String と Binary から選択できます。より正確で互換性が高いのは Binary ですが、デフォルトで String を使用したほうが、多くの場合、ユーザーの期待に沿います。"}]}]} />

String 型のカラムでは、Binary ではなく ORC String 型を使用します

<div id="output_format_orc_writer_time_zone_name">
  ## output\_format\_orc\_writer\_time\_zone\_name
</div>

<SettingsInfoBlock type="String" default_value="GMT" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "GMT"},{"label": "ORC ライター のタイムゾーン名を指定します。デフォルトの ORC ライター のタイムゾーンは GMT です。"}]}]} />

ORC ライター のタイムゾーン名を指定します。デフォルトの ORC ライター のタイムゾーンは GMT です。

<div id="output_format_parallel_formatting">
  ## output\_format\_parallel\_formatting
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

データのフォーマットを並列で処理するかどうかを有効または無効にします。[TSV](/docs/ja/reference/formats/TabSeparated/TabSeparated)、[TSKV](/docs/ja/reference/formats/TabSeparated/TSKV)、[CSV](/docs/ja/reference/formats/CSV/CSV)、[JSONEachRow](/docs/ja/reference/formats/JSON/JSONEachRow) フォーマットでのみサポートされています。

設定可能な値:

* 1 — 有効。
* 0 — 無効。

<div id="output_format_parquet_batch_size">
  ## output\_format\_parquet\_batch\_size
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="1024" />

この行数ごとにページサイズを確認します。平均的な値のサイズが数 KB を超えるカラムがある場合は、設定値を小さくすることを検討してください。

<div id="output_format_parquet_bloom_filter_bits_per_value">
  ## output\_format\_parquet\_bloom\_filter\_bits\_per\_value
</div>

<SettingsInfoBlock type="Double" default_value="10.5" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "10.5"},{"label": "新しい設定"}]}]} />

Parquet ブルームフィルタで、個々の一意な値に使用するビット数のおおよその目安です。推定偽陽性率：

* 6   ビット - 10%
* 10.5 ビット -  1%
* 16.9 ビット -  0.1%
* 26.4 ビット -  0.01%
* 41   ビット -  0.001%

<div id="output_format_parquet_bloom_filter_flush_threshold_bytes">
  ## output\_format\_parquet\_bloom\_filter\_flush\_threshold\_bytes
</div>

<SettingsInfoBlock type="UInt64" default_value="134217728" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "134217728"},{"label": "新しい設定"}]}]} />

Parquetファイル内でブルームフィルタをどこに配置するかを指定します。ブルームフィルタは、おおよそこのサイズごとにまとめて書き込まれます。具体的には、次のとおりです。

* 0 の場合、各行グループのブルームフィルタは、その行グループの直後に書き込まれます。
  * すべてのブルームフィルタの合計サイズより大きい場合、すべての行グループのブルームフィルタはメモリ内に蓄積され、その後ファイル末尾付近にまとめて書き込まれます。
  * それ以外の場合、ブルームフィルタはメモリ内に蓄積され、合計サイズがこの値を超えるたびに書き出されます。

<div id="output_format_parquet_compression_method">
  ## output\_format\_parquet\_compression\_method
</div>

<SettingsInfoBlock type="ParquetCompression" default_value="zstd" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "zstd"},{"label": "Parquet\/ORC\/Arrow は、lz4 や zstd を含む多くの圧縮方式をサポートしています。ClickHouse はこれらすべての圧縮方式をサポートしています。'duckdb' など一部のツールは、より高速な `lz4` 圧縮方式をサポートしていないため、デフォルトは zstd に設定されています。"}]}, {"id": "row-2","items": [{"label": "23.3"},{"label": "lz4"},{"label": "Parquet 出力フォーマットでは、デフォルトで lz4 圧縮を使用する"}]}]} />

Parquet 出力フォーマットの圧縮方式。サポートされるコーデック: snappy, lz4, brotli, zstd, gzip, none (非圧縮)

<div id="output_format_parquet_data_page_size">
  ## output\_format\_parquet\_data\_page\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="1048576" />

圧縮前の目標ページサイズ (バイト単位) 。

<div id="output_format_parquet_date_as_uint16">
  ## output\_format\_parquet\_date\_as\_uint16
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "24.12 で導入された軽微な互換性破壊の変更に対応する互換性設定を追加しました。"}]}, {"id": "row-2","items": [{"label": "24.12"},{"label": "0"},{"label": "Date は単純な UInt16 ではなく Date32 として書き込まれます（Parquet で Date に最も近い 2 つの型です）。"}]}]} />

Date の値は、32 ビットの Parquet DATE 型に変換して書き込む (読み戻すと Date32) 代わりに、単純な 16 ビット数値として書き込みます (読み戻すと UInt16) 。

<div id="output_format_parquet_datetime_as_uint32">
  ## output\_format\_parquet\_datetime\_as\_uint32
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.12"},{"label": "0"},{"label": "DateTime は UInt32 ではなく DateTime64(3) として書き込まれます（この 2 つは DateTime に最も近い Parquet 型です）。"}]}]} />

DateTime の値をミリ秒に変換して書き込む (読み戻し時は DateTime64(3)) 代わりに、生の Unix timestamp として書き込みます (読み戻し時は UInt32) 。

<div id="output_format_parquet_enum_as_byte_array">
  ## output\_format\_parquet\_enum\_as\_byte\_array
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "1"},{"label": "デフォルトで、Enum をバイト配列として Parquet に書き込む"}]}, {"id": "row-2","items": [{"label": "25.7"},{"label": "0"},{"label": "Parquet の物理型 BYTE_ARRAY および論理型 ENUM を使用して Enum を書き込む"}]}]} />

Parquet の物理型 BYTE\_ARRAY および論理型 ENUM を使用して Enum を書き込む

<div id="output_format_parquet_fixed_string_as_fixed_byte_array">
  ## output\_format\_parquet\_fixed\_string\_as\_fixed\_byte\_array
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "23.2"},{"label": "1"},{"label": "デフォルトで FixedString に Parquet FIXED_LENGTH_BYTE_ARRAY 型を使用"}]}]} />

FixedString 型のカラムでは、Binary ではなく Parquet FIXED\_LEN\_BYTE\_ARRAY 型を使用します。

<div id="output_format_parquet_geometadata">
  ## output\_format\_parquet\_geometadata
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.7"},{"label": "1"},{"label": "Geoカラムの情報をParquetメタデータに書き込み、カラムをWKB形式でエンコードできるようにする新しい設定。"}]}]} />

Geoカラムの情報をParquetメタデータに書き込み、カラムをWKB形式でエンコードできるようにします。

<div id="output_format_parquet_max_dictionary_size">
  ## output\_format\_parquet\_max\_dictionary\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="1048576" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "1048576"},{"label": "新しい設定"}]}]} />

Dictionary のサイズがこのバイト数を超えた場合、Dictionary を使用しないエンコーディングに切り替えます。dictionary encoding を無効にするには、0 に設定します。

<div id="output_format_parquet_parallel_encoding">
  ## output\_format\_parquet\_parallel\_encoding
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

Parquetのエンコードを複数スレッドで行います。

<div id="output_format_parquet_row_group_size">
  ## output\_format\_parquet\_row\_group\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="1000000" />

行数で指定する目標の行グループサイズ。

<div id="output_format_parquet_row_group_size_bytes">
  ## output\_format\_parquet\_row\_group\_size\_bytes
</div>

<SettingsInfoBlock type="UInt64" default_value="536870912" />

圧縮前の目標行グループサイズ (バイト単位) 。

<div id="output_format_parquet_string_as_string">
  ## output\_format\_parquet\_string\_as\_string
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "1"},{"label": "ClickHouse では、通常 UTF-8 として扱われる String データ型に、任意のバイナリデータを格納できます。一方、Parquet\/ORC\/Arrow の String は UTF-8 のみをサポートします。そのため、ClickHouse の String データ型に対して Arrow のどのデータ型を使用するかを、String と Binary から選択できます。より正確で互換性が高いのは Binary ですが、ほとんどの場合、デフォルトで String を使用する方がユーザーの期待に合います。"}]}]} />

String 型のカラムでは、Binary ではなく Parquet String 型を使用します。

<div id="output_format_parquet_write_bloom_filter">
  ## output\_format\_parquet\_write\_bloom\_filter
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "1"},{"label": "Parquet ブルームフィルタの書き込みに対応しました。"}]}]} />

Parquet ファイルにブルームフィルタを書き込みます。

<div id="output_format_parquet_write_checksums">
  ## output\_format\_parquet\_write\_checksums
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.11"},{"label": "1"},{"label": "新しい設定"}]}]} />

Parquet のページヘッダーに crc32 チェックサムを書き込みます。

<div id="output_format_parquet_write_page_index">
  ## output\_format\_parquet\_write\_page\_index
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.7"},{"label": "1"},{"label": "Parquet ファイル にページインデックスを書き込めるようになりました。"}]}]} />

Parquet ファイル にカラムインデックスとオフセットインデックス (つまり、各データページに関する統計情報であり、読み取り時の filter pushdown に利用される場合があります) を書き込みます。

<div id="output_format_pretty_color">
  ## output\_format\_pretty\_color
</div>

<SettingsInfoBlock type="UInt64Auto" default_value="auto" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.1"},{"label": "auto"},{"label": "出力先が TTY でない場合は ANSI エスケープを無効にするため、auto 値も許可するように設定が変更されました"}]}]} />

Pretty フォーマットで ANSI エスケープシーケンスを使用します。0 - 無効、1 - 有効、'auto' - 端末出力の場合に有効。

<div id="output_format_pretty_display_footer_column_names">
  ## output\_format\_pretty\_display\_footer\_column\_names
</div>

<SettingsInfoBlock type="UInt64" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.6"},{"label": "1"},{"label": "テーブルの行数が多い場合に、フッターにカラム名を表示する設定が追加されました。しきい値は output_format_pretty_display_footer_column_names_min_rows で制御されます。"}]}]} />

テーブルの行数が多い場合に、フッターにカラム名を表示します。

設定可能な値:

* 0 — フッターにはカラム名は表示されません。
* 1 — 行数が [output\_format\_pretty\_display\_footer\_column\_names\_min\_rows](/docs/ja/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names_min_rows) で設定されたしきい値以上の場合、フッターにカラム名が表示されます (デフォルトは 50) 。

**例**

クエリ:

```sql theme={null}
SELECT *, toTypeName(*) FROM (SELECT * FROM system.numbers LIMIT 1000);
```

結果:

```response theme={null}
      ┌─number─┬─toTypeName(number)─┐
   1. │      0 │ UInt64             │
   2. │      1 │ UInt64             │
   3. │      2 │ UInt64             │
   ...
 999. │    998 │ UInt64             │
1000. │    999 │ UInt64             │
      └─number─┴─toTypeName(number)─┘
```

<div id="output_format_pretty_display_footer_column_names_min_rows">
  ## output\_format\_pretty\_display\_footer\_column\_names\_min\_rows
</div>

<SettingsInfoBlock type="UInt64" default_value="50" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.6"},{"label": "50"},{"label": "output_format_pretty_display_footer_column_names_min_rows のしきい値を制御する設定を追加しました。デフォルト値は 50 です。"}]}]} />

設定 [output\_format\_pretty\_display\_footer\_column\_names](/docs/ja/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names) が有効な場合に、カラム名付きのフッターを表示する最小行数を設定します。

<div id="output_format_pretty_fallback_to_vertical">
  ## output\_format\_pretty\_fallback\_to\_vertical
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1"},{"label": "新しい設定"}]}]} />

有効な場合、テーブルの幅が広く行数が少ないと、Pretty フォーマットは Vertical フォーマットと同様の形式で出力します。
この動作の詳細な調整については、`output_format_pretty_fallback_to_vertical_max_rows_per_chunk` および `output_format_pretty_fallback_to_vertical_min_table_width` を参照してください。

<div id="output_format_pretty_fallback_to_vertical_max_rows_per_chunk">
  ## output\_format\_pretty\_fallback\_to\_vertical\_max\_rows\_per\_chunk
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "100"},{"label": "新しい設定"}]}]} />

Vertical フォーマット へのフォールバック (`output_format_pretty_fallback_to_vertical`を参照) は、chunk内のレコード数が指定した値を超えない場合にのみ有効になります。

<div id="output_format_pretty_fallback_to_vertical_min_columns">
  ## output\_format\_pretty\_fallback\_to\_vertical\_min\_columns
</div>

<SettingsInfoBlock type="UInt64" default_value="5" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "5"},{"label": "新しい設定"}]}]} />

Verticalフォーマットへのフォールバック (`output_format_pretty_fallback_to_vertical` を参照) は、カラム数が指定した値より大きい場合にのみ有効になります。

<div id="output_format_pretty_fallback_to_vertical_min_table_width">
  ## output\_format\_pretty\_fallback\_to\_vertical\_min\_table\_width
</div>

<SettingsInfoBlock type="UInt64" default_value="250" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "250"},{"label": "新しい設定"}]}]} />

Vertical フォーマットへのフォールバック (`output_format_pretty_fallback_to_vertical` を参照) は、テーブル内のカラム長の合計が指定された値以上である場合、またはいずれかの値に改行文字が含まれている場合にのみ有効になります。

<div id="output_format_pretty_glue_chunks">
  ## output\_format\_pretty\_glue\_chunks
</div>

<SettingsInfoBlock type="UInt64Auto" default_value="auto" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "auto"},{"label": "Pretty フォーマットをより見やすくするための新しい設定。"}]}]} />

Pretty フォーマットで表示されるデータが複数の chunk に分かれて到着した場合、遅れて到着した場合でも、次の chunk のカラム幅が前の chunk と同じであれば、ANSIエスケープシーケンスを使って前の行に戻り、前の chunk のフッターを上書きして、新しい chunk のデータを続けて表示します。これにより、結果がより見やすくなります。

0 - 無効、1 - 有効、'auto' - 端末使用時に有効。

<div id="output_format_pretty_grid_charset">
  ## output\_format\_pretty\_grid\_charset
</div>

<SettingsInfoBlock type="String" default_value="UTF-8" />

グリッドの罫線を表示するための文字セット。使用可能な文字セット: ASCII、UTF-8 (デフォルト) 。

対話型モードでは、この設定が明示的に指定されていない限り、端末が UTF-8 をサポートしていない場合 (`LC_ALL`、`LC_CTYPE`、`LANG` 環境変数に基づいて判定) 、`clickhouse-client` は自動的に `ASCII` に切り替えます。

<div id="output_format_pretty_highlight_digit_groups">
  ## output\_format\_pretty\_highlight\_digit\_groups
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "1"},{"label": "有効で、かつ出力先が端末の場合、千、百万などの単位に対応する各桁を下線で強調表示します。"}]}]} />

有効で、かつ出力先が端末の場合、千、百万などの単位に対応する各桁を下線で強調表示します。

<div id="output_format_pretty_highlight_trailing_spaces">
  ## output\_format\_pretty\_highlight\_trailing\_spaces
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1"},{"label": "新しい設定"}]}]} />

有効で、かつ出力先がターミナルの場合、行末の空白を灰色の下線で強調表示します。

<div id="output_format_pretty_max_column_name_width_cut_to">
  ## output\_format\_pretty\_max\_column\_name\_width\_cut\_to
</div>

<SettingsInfoBlock type="UInt64" default_value="24" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "24"},{"label": "新しい設定"}]}]} />

カラム名が長すぎる場合は、この長さに切り詰めます。
カラム名は、`output_format_pretty_max_column_name_width_cut_to` と `output_format_pretty_max_column_name_width_min_chars_to_cut` の合計より長い場合に切り詰められます。

<div id="output_format_pretty_max_column_name_width_min_chars_to_cut">
  ## output\_format\_pretty\_max\_column\_name\_width\_min\_chars\_to\_cut
</div>

<SettingsInfoBlock type="UInt64" default_value="4" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "4"},{"label": "新しい設定"}]}]} />

カラム名が長すぎる場合に切り詰める最小文字数です。
カラム名は、`output_format_pretty_max_column_name_width_cut_to` に `output_format_pretty_max_column_name_width_min_chars_to_cut` を加えた長さを超える場合に切り詰められます。

<div id="output_format_pretty_max_column_pad_width">
  ## output\_format\_pretty\_max\_column\_pad\_width
</div>

<SettingsInfoBlock type="UInt64" default_value="250" />

Prettyフォーマットで、カラム内のすべての値に適用するパディングの最大幅です。

<div id="output_format_pretty_max_rows">
  ## output\_format\_pretty\_max\_rows
</div>

<SettingsInfoBlock type="UInt64" default_value="1000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "1000"},{"label": "使いやすさの観点から、スクロール量が少なくて済みます。"}]}]} />

Pretty フォーマットの行数上限。

<div id="output_format_pretty_max_value_width">
  ## output\_format\_pretty\_max\_value\_width
</div>

<SettingsInfoBlock type="UInt64" default_value="10000" />

Pretty フォーマットで表示する値の最大表示幅です。これを超える場合は切り詰められます。
値が 0 の場合は、切り詰められません。

<div id="output_format_pretty_max_value_width_apply_for_single_value">
  ## output\_format\_pretty\_max\_value\_width\_apply\_for\_single\_value
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "0"},{"label": "Prettyフォーマットでは、単一の値は切り詰められません。"}]}]} />

値を切り詰める (`output_format_pretty_max_value_width` 設定を参照) のは、block 内の単一の値でない場合に限られます。それ以外の場合は値全体が出力されます。これは `SHOW CREATE TABLE` クエリで便利です。

<div id="output_format_pretty_multiline_fields">
  ## output\_format\_pretty\_multiline\_fields
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1"},{"label": "新しい設定"}]}]} />

有効な場合、Prettyフォーマットでは、表のセル内の複数行フィールドが複数行のまま表示されるため、表の枠線が維持されます。
無効な場合はそのまま表示されるため、表のレイアウトが崩れる可能性があります (無効のままにしておく利点の 1 つは、複数行の値をコピー＆ペーストしやすくなることです) 。

<div id="output_format_pretty_named_tuples_as_json">
  ## output\_format\_pretty\_named\_tuples\_as\_json
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.12"},{"label": "1"},{"label": "Prettyフォーマットで名前付きタプルをJSON オブジェクトとして出力するかどうかを制御する新しい設定"}]}]} />

Prettyフォーマットで名前付きタプルを整形されたJSON オブジェクトとして出力するかどうかを制御します。

<div id="output_format_pretty_row_numbers">
  ## output\_format\_pretty\_row\_numbers
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "1"},{"label": "使い勝手が向上します。"}]}]} />

Pretty 出力フォーマットでは、各行の前に行番号を追加します

<div id="output_format_pretty_single_large_number_tip_threshold">
  ## output\_format\_pretty\_single\_large\_number\_tip\_threshold
</div>

<SettingsInfoBlock type="UInt64" default_value="1000000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.2"},{"label": "1000000"},{"label": "ブロックがこの値を超える単一の数値（0 を除く）のみで構成されている場合、テーブルの右側に読みやすい数値のヒントを表示します"}]}]} />

ブロックがこの値を超える単一の数値 (0 を除く) のみで構成されている場合、テーブルの右側に読みやすい数値のヒントを表示します

<div id="output_format_pretty_squash_consecutive_ms">
  ## output\_format\_pretty\_squash\_consecutive\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="50" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "50"},{"label": "新しい設定を追加"}]}]} />

次のブロックを指定したミリ秒数まで待機し、書き込む前に前のブロックとまとめます。
これにより、小さすぎるブロックが頻繁に出力されるのを防ぎつつ、データをストリーミング形式で表示できます。

<div id="output_format_pretty_squash_max_wait_ms">
  ## output\_format\_pretty\_squash\_max\_wait\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="1000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1000"},{"label": "新しい設定を追加"}]}]} />

前回の出力から指定したミリ秒数を超えて経過した場合、保留中のブロックをPrettyフォーマットで出力します。

<div id="output_format_pretty_use_nbsp_for_padding">
  ## output\_format\_pretty\_use\_nbsp\_for\_padding
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "新しい設定。有効にすると、`Pretty` 出力のパディングが ASCII スペースではなく `U+00A0` でレンダリングされるため、通常のスペースの連続を圧縮するツールを介したコピー＆ペーストでも保持されます。"}]}]} />

有効にすると、`Pretty` 出力フォーマットのパディングは ASCII スペースではなく `U+00A0` でレンダリングされます。
出力は等幅フォントでは見た目は変わりませんが、通常のスペースの連続を圧縮または削除するツールを通しても、パディングは保持されます。
`output_format_pretty_grid_charset` が `UTF-8` の場合にのみ有効です。

<div id="output_format_protobuf_nullables_with_google_wrappers">
  ## output\_format\_protobuf\_nullables\_with\_google\_wrappers
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

Google ラッパーを使用して Nullable カラムをシリアライズする際、デフォルト値を空のラッパーとしてシリアライズします。オフにすると、デフォルト値と NULL 値はシリアライズされません

<div id="output_format_schema">
  ## output\_format\_schema
</div>

[Cap'n Proto](/docs/ja/reference/formats/CapnProto) または [Protobuf](/docs/ja/reference/formats/Protobuf/Protobuf) フォーマットで自動生成されたスキーマを保存するファイルのパスです。

<div id="output_format_sql_insert_include_column_names">
  ## output\_format\_sql\_insert\_include\_column\_names
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

INSERT クエリにカラム名を含めます

<div id="output_format_sql_insert_max_batch_size">
  ## output\_format\_sql\_insert\_max\_batch\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="65409" />

1 つの INSERT ステートメントに含められる最大行数。

<div id="output_format_sql_insert_quote_names">
  ## output\_format\_sql\_insert\_quote\_names
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

カラム名を '\`' 文字で囲みます

<div id="output_format_sql_insert_table_name">
  ## output\_format\_sql\_insert\_table\_name
</div>

<SettingsInfoBlock type="String" default_value="table" />

出力される INSERT クエリ内のテーブル名

<div id="output_format_sql_insert_use_replace">
  ## output\_format\_sql\_insert\_use\_replace
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

INSERTではなくREPLACEステートメントを使用する

<div id="output_format_trim_fixed_string">
  ## output\_format\_trim\_fixed\_string
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "0"},{"label": "テキスト出力フォーマットで FixedString の値の末尾にあるゼロバイトを削除する新しい設定"}]}]} />

テキスト出力フォーマットで、FixedString の値の末尾にあるヌルバイトを削除します。たとえば、`toFixedString('John', 8)` は `John\0\0\0\0` ではなく `John` として出力されます。

<div id="output_format_tsv_crlf_end_of_line">
  ## output\_format\_tsv\_crlf\_end\_of\_line
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

true に設定すると、TSV フォーマットの行末は \n ではなく \r\n になります。

<div id="output_format_values_escape_quote_with_quote">
  ## output\_format\_values\_escape\_quote\_with\_quote
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.2"},{"label": "0"},{"label": "true の場合は ' を '' にエスケープし、そうでない場合は \\' でクォートします"}]}]} />

true の場合は ' を '' にエスケープし、そうでない場合は \\' でクォートします

<div id="output_format_write_statistics">
  ## output\_format\_write\_statistics
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

適切な出力フォーマットで、読み取った行数、バイト数、経過時間に関する統計を出力します。

デフォルトで有効です
