Skip to main content
これらの設定は、source から自動生成されています。

output_format_always_write_decimal_point_in_float_and_decimal

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

output_format_arrow_compression_method

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

output_format_arrow_date_as_uint16

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

output_format_arrow_fixed_string_as_fixed_byte_array

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

output_format_arrow_low_cardinality_as_dictionary

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

output_format_arrow_string_as_string

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

output_format_arrow_unsupported_types_as_binary

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

output_format_arrow_use_64_bit_indexes_for_dictionary

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

output_format_arrow_use_native_writer

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

output_format_arrow_use_signed_indexes_for_dictionary

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

output_format_avro_codec

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

output_format_avro_confluent_subject

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

output_format_avro_rows_in_file

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

output_format_avro_string_column_pattern

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

output_format_avro_sync_interval

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

output_format_binary_encode_types_in_binary_format

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

output_format_binary_write_json_as_string

JSON 型の値を、RowBinary 出力フォーマットでは JSON String 値として書き込みます。

output_format_bson_string_as_string

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

output_format_compression_level

クエリ出力が圧縮される場合のデフォルトの圧縮レベルです。この設定は、SELECT クエリで INTO OUTFILE を使用する場合、またはテーブル関数 fileurlhdfss3azureBlobStorage に書き込む場合に適用されます。 設定可能な値: 122

output_format_compression_zstd_window_log

出力の圧縮方式が zstd の場合に使用できます。0 より大きい値を指定すると、この設定により圧縮ウィンドウサイズ (2 の累乗) が明示的に設定され、zstd 圧縮の long-range モードが有効になります。これにより、圧縮率が向上する場合があります。 設定可能な値: 0 以上の数値。値が小さすぎたり大きすぎたりすると、zstdlib は例外をスローします。一般的な値は 20 (window size = 1MB) から 30 (window size = 1GB) です。

output_format_csv_crlf_end_of_line

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

output_format_csv_header_serialize_tuple_into_separate_columns

output_format_csv_serialize_tuple_into_separate_columns が有効な場合、CSVWithNamesCSVWithNamesAndTypes のヘッダー行では、各 Tuple カラムがその leaf フィールド (t.at.b のようなドット区切りの名前と、leaf の型名) にフラット化されるため、ヘッダーのカラム数はデータと同じになります。CustomSeparated* では、このフラット化は format_custom_escaping_rule = 'CSV' かつ format_custom_field_delimiterformat_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 フォーマットである CSVWithNamesAndTypesCustomSeparatedWithNamesAndTypes では、input_format_with_types_use_header = 0 も必要です。これを設定しないと、フラット化された型の行が単一のトップレベル Tuple 入力フィールドに対して検証され、拒否されます) 。

output_format_csv_serialize_tuple_into_separate_columns

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

output_format_decimal_trailing_zeros

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

output_format_float_precision

0 以外の場合、浮動小数点出力 (Float32Float64BFloat16) は、小数点以下の桁数が最大でこの値になるようにフォーマットされます (末尾のゼロは削除されます) 。 0 の場合 (デフォルト) は、最短の往復変換表現が使用されます。 固定小数点表記では大きすぎる値や、要求された精度に丸めるとすべての有効桁が失われてしまうほど絶対値の小さい値 (仮数が ±0 になる場合) は、代わりに指数表記で出力されます。こうしたフォールバック時には、仮数の小数点以下の桁数が要求された桁数を超えることがあります。 有効範囲: 0 から 100。

output_format_image_height

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

output_format_image_terminal_mode

PNG などの画像出力フォーマットでは、生の画像バイト列を書き出す代わりに、インライン画像プロトコルを使って画像を端末に直接描画します。 設定可能な値:
  • “ (空) — 生の画像バイト列を書き出します (デフォルト) 。
  • iterm — iTerm2 のインライン画像プロトコルを使用します。
  • kitty — Kitty の graphics プロトコルを使用します。
  • sixel — Sixel プロトコルを使用します。
  • auto — 出力先が端末の場合は、その対応機能を検出して itermkittysixel のいずれかを使用します (この順序) 。それ以外の場合は、生の画像バイト列を書き出します。
デフォルト値: “ (空)。

output_format_image_width

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

output_format_json_array_of_rows

JSONEachRowフォーマットで、すべての行を JSON array として出力する機能を有効にします。 設定可能な値:
  • 1 — ClickHouse はすべての行を配列として出力し、各行は JSONEachRow フォーマットになります。
  • 0 — ClickHouse は各行を JSONEachRow フォーマットで個別に出力します。
この設定を有効にしたクエリの例 クエリ:
結果:
設定を無効にしたクエリの例 クエリ:
結果:

output_format_json_escape_forward_slashes

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

output_format_json_map_as_array_of_tuples

Map型のカラムを、TupleのJSON配列としてシリアライズします。 デフォルトでは無効です。

output_format_json_named_tuples_as_objects

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

output_format_json_pretty_print

この設定は、JSON 出力フォーマットを使用する際に、data 配列内の Tuples、Maps、Arrays などのネストされた構造をどのように表示するかを決定します。 たとえば、次のように出力するのではなく:
出力は次のように表示されます:
デフォルトで有効です。

output_format_json_quote_64bit_floats

JSON* フォーマットで出力する際に、64 ビットのfloatsを引用符で囲むかどうかを制御します。 デフォルトでは無効です。

output_format_json_quote_64bit_integers

JSONフォーマットで出力する際に、64 ビット以上の整数 (UInt64Int128 など) をクォートするかどうかを制御します。 これらの整数は、デフォルトでクォートで囲まれます。この動作は、ほとんどの JavaScript 実装と互換性があります。 設定可能な値:
  • 0 — 整数はクォートなしで出力されます。
  • 1 — 整数はクォートで囲まれて出力されます。

output_format_json_quote_decimals

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

output_format_json_quote_denormals

JSON 出力フォーマットで +nan-nan+inf-inf を出力するかどうかを指定します。 設定可能な値:
  • 0 — 無効。
  • 1 — 有効。
次のテーブル account_orders について考えます:
output_format_json_quote_denormals = 0 の場合、クエリの出力では null 値が返されます:
output_format_json_quote_denormals = 1 の場合、クエリは以下を返します:

output_format_json_skip_null_value_in_named_tuples

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

output_format_json_validate_utf8

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

output_format_markdown_escape_special_characters

有効にすると、Markdown の特殊文字をエスケープします。 Common Mark では、エスケープ可能な特殊文字として次のものが定義されています。
設定可能な値:
  • 0 — 無効。
  • 1 — 有効。

output_format_msgpack_uuid_representation

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

output_format_native_encode_types_in_binary_format

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

output_format_native_use_flattened_dynamic_and_json_serialization

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

output_format_native_write_json_as_string

JSONカラムのデータを、デフォルトのネイティブJSONシリアライゼーションではなく、JSON文字列を含むStringカラムとして書き込みます。

output_format_orc_compression_block_size

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

output_format_orc_compression_method

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

output_format_orc_dictionary_key_size_threshold

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

output_format_orc_row_index_stride

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

output_format_orc_string_as_string

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

output_format_orc_writer_time_zone_name

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

output_format_parallel_formatting

データのフォーマットを並列で処理するかどうかを有効または無効にします。TSVTSKVCSVJSONEachRow フォーマットでのみサポートされています。 設定可能な値:
  • 1 — 有効。
  • 0 — 無効。

output_format_parquet_batch_size

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

output_format_parquet_bloom_filter_bits_per_value

Parquet ブルームフィルタで、個々の一意な値に使用するビット数のおおよその目安です。推定偽陽性率:
  • 6 ビット - 10%
  • 10.5 ビット - 1%
  • 16.9 ビット - 0.1%
  • 26.4 ビット - 0.01%
  • 41 ビット - 0.001%

output_format_parquet_bloom_filter_flush_threshold_bytes

Parquetファイル内でブルームフィルタをどこに配置するかを指定します。ブルームフィルタは、おおよそこのサイズごとにまとめて書き込まれます。具体的には、次のとおりです。
  • 0 の場合、各行グループのブルームフィルタは、その行グループの直後に書き込まれます。
    • すべてのブルームフィルタの合計サイズより大きい場合、すべての行グループのブルームフィルタはメモリ内に蓄積され、その後ファイル末尾付近にまとめて書き込まれます。
    • それ以外の場合、ブルームフィルタはメモリ内に蓄積され、合計サイズがこの値を超えるたびに書き出されます。

output_format_parquet_compression_method

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

output_format_parquet_data_page_size

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

output_format_parquet_date_as_uint16

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

output_format_parquet_datetime_as_uint32

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

output_format_parquet_enum_as_byte_array

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

output_format_parquet_fixed_string_as_fixed_byte_array

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

output_format_parquet_geometadata

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

output_format_parquet_max_dictionary_size

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

output_format_parquet_parallel_encoding

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

output_format_parquet_row_group_size

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

output_format_parquet_row_group_size_bytes

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

output_format_parquet_string_as_string

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

output_format_parquet_write_bloom_filter

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

output_format_parquet_write_checksums

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

output_format_parquet_write_page_index

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

output_format_pretty_color

Pretty フォーマットで ANSI エスケープシーケンスを使用します。0 - 無効、1 - 有効、‘auto’ - 端末出力の場合に有効。 テーブルの行数が多い場合に、フッターにカラム名を表示します。 設定可能な値: クエリ:
結果:
設定 output_format_pretty_display_footer_column_names が有効な場合に、カラム名付きのフッターを表示する最小行数を設定します。

output_format_pretty_fallback_to_vertical

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

output_format_pretty_fallback_to_vertical_max_rows_per_chunk

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

output_format_pretty_fallback_to_vertical_min_columns

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

output_format_pretty_fallback_to_vertical_min_table_width

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

output_format_pretty_glue_chunks

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

output_format_pretty_grid_charset

グリッドの罫線を表示するための文字セット。使用可能な文字セット: ASCII、UTF-8 (デフォルト) 。 対話型モードでは、この設定が明示的に指定されていない限り、端末が UTF-8 をサポートしていない場合 (LC_ALLLC_CTYPELANG 環境変数に基づいて判定) 、clickhouse-client は自動的に ASCII に切り替えます。

output_format_pretty_highlight_digit_groups

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

output_format_pretty_highlight_trailing_spaces

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

output_format_pretty_max_column_name_width_cut_to

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

output_format_pretty_max_column_name_width_min_chars_to_cut

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

output_format_pretty_max_column_pad_width

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

output_format_pretty_max_rows

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

output_format_pretty_max_value_width

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

output_format_pretty_max_value_width_apply_for_single_value

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

output_format_pretty_multiline_fields

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

output_format_pretty_named_tuples_as_json

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

output_format_pretty_row_numbers

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

output_format_pretty_single_large_number_tip_threshold

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

output_format_pretty_squash_consecutive_ms

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

output_format_pretty_squash_max_wait_ms

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

output_format_pretty_use_nbsp_for_padding

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

output_format_protobuf_nullables_with_google_wrappers

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

output_format_schema

Cap’n Proto または Protobuf フォーマットで自動生成されたスキーマを保存するファイルのパスです。

output_format_sql_insert_include_column_names

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

output_format_sql_insert_max_batch_size

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

output_format_sql_insert_quote_names

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

output_format_sql_insert_table_name

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

output_format_sql_insert_use_replace

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

output_format_trim_fixed_string

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

output_format_tsv_crlf_end_of_line

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

output_format_values_escape_quote_with_quote

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

output_format_write_statistics

適切な出力フォーマットで、読み取った行数、バイト数、経過時間に関する統計を出力します。 デフォルトで有効です
最終更新日 2026年7月23日