> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # フォーマット設定 > 入出力フォーマットを制御する設定。 export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => { const cells = [["Type", {type}], ["Default value", {default_value}]]; if (changeable_without_restart) { const isYes = String(changeable_without_restart).trim().toLowerCase() === "yes"; const badge = isYes ? Yes : No; cells.push(["Changeable without restart", badge]); } return {cells.map(([h]) => )} {cells.map(([h, v]) => )}

{h}
{v}

; }; export const galaxyOnClick = eventName => () => { try { if (typeof window !== "undefined" && window.galaxy && eventName) { window.galaxy.track(eventName, { interaction: "click" }); } } catch (e) {} }; export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => { if (link) { return Beta ; } return

Beta feature. Learn more.

; }; export const ExperimentalBadge = () => { return

Experimental feature. Learn more.

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

## allow\_special\_bool\_values\_inside\_variant

"on"、"off"、"enable"、"disable" などの特殊なテキスト表現の bool 値を、Variant 型内の Bool 値としてパースできるようにします。

## bool\_false\_representation

TSV/CSV/Vertical/Pretty フォーマットで bool の false 値を表すテキスト。

## bool\_true\_representation

TSV/CSV/Vertical/Pretty フォーマットで、bool 型の true 値を表すテキスト。

## check\_conversion\_from\_numbers\_to\_enum

値が Enum に存在しない場合、Numbers から Enum への変換時に例外を発生させます。設定可能な値: * 0 — 無効。 * 1 — 有効。 **例** ```text theme={null} CREATE TABLE tab ( val Enum('first' = 1, 'second' = 2, 'third' = 3) ) ENGINE = Memory; INSERT INTO tab SETTINGS check_conversion_from_numbers_to_enum = 1 VALUES (4); -- エラーを返す ```

## column\_names\_for\_schema\_inference

カラム名を持たないフォーマットのスキーマ推論で使用するカラム名の一覧です。フォーマット: 'column1,column2,column3,...'

## date\_time\_64\_output\_format\_cut\_trailing\_zeros\_align\_to\_groups\_of\_thousands

datetime64 値の末尾のゼロを動的に削除し、出力の scale を \[0, 3, 6] に調整します。それぞれ '秒'、'ミリ秒'、'マイクロ秒' に対応します。

## date\_time\_input\_format

日付と時刻のテキスト表現を解析するパーサーを選択できます。この設定は[日付と時刻の関数](/ja/reference/functions/regular-functions/date-time-functions)には適用されません。設定可能な値: * `'best_effort'` — 拡張パースを有効にします。 ClickHouse は基本的な `YYYY-MM-DD HH:MM:SS` フォーマットと、すべての [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) の日付・時刻フォーマットをパースできます。たとえば、`'2018-06-08T01:02:03.000Z'` です。 * `'best_effort_us'` — `best_effort` と似ています (違いについては [parseDateTimeBestEffortUS](/ja/reference/functions/regular-functions/type-conversion-functions#parseDateTimeBestEffortUS) を参照してください) * `'basic'` — 基本パーサーを使用します。 ClickHouse は基本的な `YYYY-MM-DD HH:MM:SS` または `YYYY-MM-DD` フォーマットのみをパースできます。たとえば、`2019-08-20 10:18:56` または `2019-08-20` です。関連項目： * [DateTime データ型。](/ja/reference/data-types/datetime) * [日付と時刻を扱う関数。](/ja/reference/functions/regular-functions/date-time-functions)

## date\_time\_output\_format

日付と時刻のテキスト表現の出力フォーマットを選択できます。設定可能な値: * `simple` - シンプルな出力フォーマット。 ClickHouse は、日付と時刻を `YYYY-MM-DD hh:mm:ss` フォーマットで出力します。たとえば、`2019-08-20 10:18:56` です。計算は、データ型の time zone (存在する場合) または server の time zone に基づいて行われます。 * `iso` - ISO 出力フォーマット。 ClickHouse は、日付と時刻を [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) の `YYYY-MM-DDThh:mm:ssZ` フォーマットで出力します。たとえば、`2019-08-20T10:18:56Z` です。出力は UTC であることに注意してください (`Z` は UTC を意味します) 。 * `unix_timestamp` - Unix timestamp 出力フォーマット。 ClickHouse は、日付と時刻を [Unix timestamp](https://en.wikipedia.org/wiki/Unix_time) フォーマットで出力します。たとえば、`1566285536` です。関連項目: * [DateTime データ型。](/ja/reference/data-types/datetime) * [日付と時刻を扱う関数。](/ja/reference/functions/regular-functions/date-time-functions)

## date\_time\_overflow\_behavior

[Date](/ja/reference/data-types/date)、[Date32](/ja/reference/data-types/date32)、[DateTime](/ja/reference/data-types/datetime)、[DateTime64](/ja/reference/data-types/datetime64)、または整数を Date、Date32、DateTime、DateTime64 に変換する際に、値が結果の型で表現できない場合の動作を定義します。設定可能な値: * `ignore` — オーバーフローを暗黙的に無視します。結果は未定義です。 * `throw` — オーバーフローが発生した場合に例外をスローします。 * `saturate` — 結果を飽和させます。値が対象の型で表現可能な最小値より小さい場合、結果は表現可能な最小値になります。値が対象の型で表現可能な最大値より大きい場合、結果は表現可能な最大値になります。デフォルト値: `ignore`。

## errors\_output\_format

エラーをテキスト出力に書き込む方法。

## format\_avro\_schema\_registry\_connection\_timeout

AvroConfluent フォーマット用の設定です。Confluent スキーマレジストリ HTTP クライアントの接続タイムアウトを秒単位で指定します。スキーマの取得とスキーマ登録の両方で使用されます。0 より大きく、600 (10 分) 未満である必要があります。

## format\_avro\_schema\_registry\_receive\_timeout

AvroConfluent フォーマットで使用される Confluent スキーマレジストリ HTTP クライアントの受信タイムアウト (秒単位) です。スキーマの取得と登録の両方で使用されます。0 より大きく、600 (10 分) 未満である必要があります。

## format\_avro\_schema\_registry\_send\_timeout

AvroConfluent フォーマットで使用される Confluent スキーマレジストリ HTTP クライアントの送信タイムアウト (秒単位) です。スキーマの取得とスキーマ登録の両方に使用されます。0 より大きく、600 (10 分) 未満である必要があります。

## format\_avro\_schema\_registry\_url

AvroConfluent フォーマット用: Confluent スキーマレジストリの URL。

## format\_binary\_max\_array\_size

RowBinary フォーマットにおける Array の最大許容サイズです。データが破損している場合に、大量のメモリが割り当てられるのを防ぎます。0 は制限なしを意味します

## format\_binary\_max\_object\_size

JSON type の RowBinary フォーマットにおいて、単一の Object に含められるパスの最大数です。破損したデータによって大量のメモリが割り当てられるのを防ぎます。0 は無制限を意味します

## format\_binary\_max\_string\_size

RowBinary フォーマットにおける String の最大許容サイズです。破損したデータの場合に大量のメモリが割り当てられるのを防ぎます。0 は制限がないことを意味します

## format\_capn\_proto\_enum\_comparising\_mode

ClickHouse Enum と CapnProto Enum の対応付け方法

## format\_capn\_proto\_max\_message\_size

単一の CapnProto メッセージの最大サイズ (バイト単位) です。これは、不正なデータや破損したデータによって過剰なメモリ割り当てが発生するのを防ぎます。デフォルト値は 1 GiB です。

## format\_capn\_proto\_use\_autogenerated\_schema

format\_schema が未設定の場合、自動生成された CapnProto スキーマを使用します

## format\_csv\_allow\_double\_quotes

true に設定すると、ダブルクォートで囲まれた文字列を許可します。

## format\_csv\_allow\_single\_quotes

true に設定すると、シングルクォートで囲まれた文字列を許可します。

## format\_csv\_delimiter

CSVデータで区切り文字として扱う文字を指定します。文字列で設定する場合、その長さは1である必要があります。

## format\_csv\_null\_representation

CSVフォーマットにおけるカスタムNULL表現

## format\_custom\_escaping\_rule

フィールドのエスケープルール (CustomSeparated フォーマット)

## format\_custom\_field\_delimiter

フィールド間の区切り文字 (CustomSeparated フォーマット)

## format\_custom\_result\_after\_delimiter

結果セットの後に付く接尾辞 (CustomSeparated フォーマット用)

## format\_custom\_result\_before\_delimiter

結果セットの前に付加されるプレフィックス (CustomSeparated フォーマット用)

## format\_custom\_row\_after\_delimiter

最後のカラムのフィールドの後ろに付く区切り文字 (CustomSeparated フォーマット)

## format\_custom\_row\_before\_delimiter

最初のカラムのフィールドの前に置かれる区切り文字 (CustomSeparated フォーマット)

## format\_custom\_row\_between\_delimiter

行と行の間の区切り文字 (CustomSeparated フォーマット用)

## format\_display\_secrets\_in\_show\_and\_select

テーブル、データベース、テーブル関数、Dictionaries に対する `SHOW` および `SELECT` クエリでシークレットを表示するかどうかを有効または無効にします。シークレットを表示するには、ユーザーに対して次の設定と権限も必要です。 [`display_secrets_in_show_and_select` server setting](/ja/reference/settings/server-settings/settings#display_secrets_in_show_and_select) が有効になっており、さらに [`displaySecretsInShowAndSelect`](/ja/reference/statements/grant#displaysecretsinshowandselect) 権限を持っている必要があります。設定可能な値: * 0 — 無効。 * 1 — 有効。

## format\_json\_object\_each\_row\_column\_for\_object\_name

[JSONObjectEachRow](/ja/reference/formats/JSON/JSONObjectEachRow)フォーマットで、オブジェクト名の保存/書き込みに使用するカラム名です。カラムの型は String である必要があります。値が空の場合、オブジェクト名にはデフォルトの名前 `row_{i}` が使用されます。

## format\_protobuf\_use\_autogenerated\_schema

format\_schema が設定されていない場合、自動生成された Protobuf を使用します

## format\_regexp

正規表現 (Regexp フォーマット用)

## format\_regexp\_escaping\_rule

フィールドのエスケープルール (Regexp フォーマット用)

## format\_regexp\_skip\_unmatched

正規表現に一致しない行をスキップします (Regexp フォーマット)

## format\_schema

このパラメーターは、[Cap'n Proto](https://capnproto.org/) や [Protobuf](https://developers.google.com/protocol-buffers/) など、スキーマ定義を必要とするフォーマットを使用する場合に役立ちます。値はフォーマットによって異なります。

## format\_schema\_message\_name

`format_schema` で定義したスキーマ内で必要なメッセージ名を指定します。従来の format\_schema 形式 (`file_name:message_name`) との互換性を維持するため、次のようになります。 * `format_schema_message_name` が指定されていない場合、メッセージ名は従来の `format_schema` の値に含まれる `message_name` 部分から推論されます。 * 従来の形式の使用時に `format_schema_message_name` を指定すると、エラーになります。

## format\_schema\_source

`format_schema` の取得元を定義します。設定可能な値: * 'file' (デフォルト) : `format_schema` は、`format_schemas` ディレクトリ内にあるスキーマファイルの名前です。 * 'string': `format_schema` は、スキーマの内容をそのまま記述した文字列です。 * 'query': `format_schema` は、スキーマを取得するためのクエリです。 `format_schema_source` が 'query' に設定されている場合は、以下の条件が適用されます: * クエリは、単一の文字列カラムを持つ 1 行、つまり値をちょうど 1 つだけ返す必要があります。 * クエリの結果は、スキーマの内容として扱われます。 * この結果は、`format_schemas` ディレクトリにローカルでキャッシュされます。 * コマンド `SYSTEM DROP FORMAT SCHEMA CACHE FOR Files` を使用して、ローカル cache をクリアできます。 * 一度キャッシュされると、キャッシュが明示的にクリアされるまで、同一のクエリがスキーマ取得のために再度実行されることはありません * ローカルのキャッシュファイルに加えて、Protobuf メッセージもメモリ内にキャッシュされます。ローカルのキャッシュファイルをクリアした後でも、スキーマを完全に更新するには、`SYSTEM DROP FORMAT SCHEMA CACHE [FOR Protobuf]` を使用してメモリ内キャッシュもクリアする必要があります。 * クエリ `SYSTEM DROP FORMAT SCHEMA CACHE` を実行すると、キャッシュファイルと Protobuf メッセージスキーマの両方のキャッシュを一度にクリアできます。

## format\_template\_resultset

結果セットのフォーマット文字列を含むファイルへのパス (Templateフォーマット用)

## format\_template\_resultset\_format

結果セットのフォーマット文字列 (Template フォーマット用)

## format\_template\_row

行用のフォーマット文字列が含まれるファイルへのパス (Template フォーマット用)

## format\_template\_row\_format

行のフォーマット文字列 (Template フォーマット用)

## format\_template\_rows\_between\_delimiter

行と行の間の区切り文字 (Template フォーマット用)

## format\_tsv\_null\_representation

TSVフォーマットでのカスタムNULL表現

## input\_format\_allow\_errors\_num

テキストフォーマット (CSV、TSV など) の読み込み時に許容されるエラーの最大数を設定します。デフォルト値は 0 です。必ず `input_format_allow_errors_ratio` と組み合わせて使用してください。行の読み込み中にエラーが発生しても、エラーカウンターがまだ `input_format_allow_errors_num` 未満であれば、ClickHouse はその行を無視して次の行に進みます。 `input_format_allow_errors_num` と `input_format_allow_errors_ratio` の両方を超えた場合、ClickHouse は例外をスローします。

## input\_format\_allow\_errors\_ratio

テキストフォーマット (CSV、TSV など) の読み取り時に許容されるエラーの最大割合を設定します。エラーの割合は、0 から 1 までの浮動小数点数で指定します。デフォルト値は 0 です。必ず `input_format_allow_errors_num` と組み合わせて使用してください。行の読み取り中にエラーが発生しても、エラーカウンターが `input_format_allow_errors_ratio` 未満であれば、ClickHouse はその行を無視して次の行の読み取りを続けます。 `input_format_allow_errors_num` と `input_format_allow_errors_ratio` の両方のしきい値を超えた場合、ClickHouse は例外をスローします。

## input\_format\_allow\_seeks

ORC、Parquet、Arrow の入力フォーマットの読み取り時に、シーク (または範囲読み取り) を許可します。有効で、かつソースがこれをサポートしている場合 (たとえば、ローカルファイル、S3、範囲指定をサポートしサイズが判明している HTTP) 、 ClickHouse は必要なバイト範囲だけを読み取り、メモリ使用量を削減できます。無効な場合、またはソースがシークをサポートしていない場合 (たとえば、ファイルサイズが不明な場合や、ストリームがシーク不可の場合) 、一部のリーダーでは、ファイル全体をメモリに読み込む動作にフォールバックすることがあります。デフォルトで有効です。

## input\_format\_arrow\_allow\_missing\_columns

Arrow 入力フォーマットの読み取り時に、欠落したカラムを許可します

## input\_format\_arrow\_case\_insensitive\_column\_matching

Arrow のカラムと CH のカラムの照合時に、大文字と小文字を区別しません。

## input\_format\_arrow\_skip\_columns\_with\_unsupported\_types\_in\_schema\_inference

Arrowフォーマットでスキーマ推論を行う際、サポートされていない型のカラムをスキップします

## input\_format\_avro\_allow\_missing\_fields

Avro/AvroConfluent フォーマットの場合: フィールドがスキーマ内に見つからない場合、エラーではなくデフォルト値を使用します

## input\_format\_avro\_null\_as\_default

Avro/AvroConfluent フォーマット: NULL かつ Nullable ではない列の場合、デフォルト値を挿入します

## input\_format\_binary\_decode\_types\_in\_binary\_format

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

## input\_format\_binary\_max\_type\_complexity

バイナリ型のデコード時における型ノードの最大数 (深さではなく総数) 。`Map(String, UInt32)` = 3ノード。悪意のある入力から保護します。0 = 無制限。

## input\_format\_binary\_read\_json\_as\_string

RowBinary入力フォーマットで、[JSON](/ja/reference/data-types/newjson) データ型の値を JSON [String](/ja/reference/data-types/string) 値として読み取ります。

## input\_format\_bson\_skip\_fields\_with\_unsupported\_types\_in\_schema\_inference

BSON フォーマットのスキーマ推論時に、未対応の型を持つフィールドをスキップします。

## input\_format\_capn\_proto\_skip\_fields\_with\_unsupported\_types\_in\_schema\_inference

CapnProtoフォーマットのスキーマ推論時に、未対応の型のカラムをスキップします

## input\_format\_column\_name\_matching\_mode

各種フォーマット (JSONEachRow、CSVWithNames、JSONColumns、BSONEachRow、RowBinaryWithNames など) でデータを取り込む際のカラム名の照合モードを定義します。サポートされるモード: * match\_case: 大文字と小文字を区別して照合します * ignore\_case: 大文字と小文字を区別せずに照合します * auto: まず大文字と小文字を区別して照合し、失敗した場合は大文字と小文字を区別せずに照合します。

## input\_format\_connection\_handling

このオプションを有効にすると、接続が予期せず閉じた場合、バッファ内に残っているデータはエラーとして扱われず、パースおよび処理されますこのオプションを有効にすると、並列パースが無効になり、重複排除はできなくなります

## input\_format\_csv\_allow\_cr\_end\_of\_line

true に設定すると、後続文字のない行末の \r を許可します

## input\_format\_csv\_allow\_variable\_number\_of\_columns

CSV入力で余分なカラムがある場合 (ファイルに想定より多くのカラムが含まれている場合) はそれらを無視し、CSV入力で欠落しているフィールドはデフォルト値として扱います

## input\_format\_csv\_allow\_whitespace\_or\_tab\_as\_delimiter

CSV文字列で、フィールドの区切り文字としてスペースおよびタブ(\t)を使えるようにします

## input\_format\_csv\_arrays\_as\_nested\_csv

CSV から Array を読み取る際、要素がネストされた CSV としてシリアライズされたうえで文字列に格納されていることを想定します。例: "\[""Hello"", ""world"", ""42"""" TV""]"。配列を囲む角括弧は省略できます。

## input\_format\_csv\_deserialize\_separate\_columns\_into\_tuple

true に設定すると、CSVフォーマットで記述された個別のカラムを Tuple カラムとしてデシリアライズできます。

## input\_format\_csv\_detect\_header

CSVフォーマット内の名前と型を含むヘッダーを自動的に検出します

## input\_format\_csv\_empty\_as\_default

CSV入力の空のフィールドをデフォルト値として扱います。

## input\_format\_csv\_enum\_as\_number

CSVフォーマットで挿入されるenum値を、enumのインデックスとして扱います

## input\_format\_csv\_skip\_first\_lines

CSVフォーマットのデータ先頭で、指定した行数をスキップします

## input\_format\_csv\_skip\_trailing\_empty\_lines

CSVフォーマットの末尾にある空行をスキップします

## input\_format\_csv\_trim\_whitespaces

CSVの文字列の先頭と末尾にあるスペースおよびタブ (\t) 文字を削除します

## input\_format\_csv\_try\_infer\_numbers\_from\_strings

有効にすると、スキーマ推論時に ClickHouse は文字列フィールドから数値を推論しようとします。 CSV データに引用符で囲まれた UInt64 値が含まれている場合に役立ちます。デフォルトでは無効です。

## input\_format\_csv\_try\_infer\_strings\_from\_quoted\_tuples

入力データ内の引用符付き Tuple を、String 型の値として解釈します。

## input\_format\_csv\_use\_best\_effort\_in\_schema\_inference

CSVフォーマットでスキーマを推論する際に、いくつかの調整とヒューリスティクスを使用します

## input\_format\_csv\_use\_default\_on\_bad\_values

不正な値によってCSVフィールドのデシリアライズに失敗した場合に、カラムにデフォルト値を設定できるようにします

## input\_format\_custom\_allow\_variable\_number\_of\_columns

CustomSeparated 入力で余分なカラム (ファイルに想定より多くのカラムがある場合) を無視し、不足しているフィールドはデフォルト値として扱います

## input\_format\_custom\_detect\_header

CustomSeparated フォーマットで名前と型を含むヘッダーを自動的に検出します

## input\_format\_custom\_skip\_trailing\_empty\_lines

CustomSeparated フォーマットで末尾の空行をスキップする

## input\_format\_defaults\_for\_omitted\_fields

`INSERT` クエリの実行時に、省略された入力カラムの値を、対応するカラムのデフォルト値で補います。このオプションは、[JSONEachRow](/ja/reference/formats/JSON/JSONEachRow) (およびその他の JSON フォーマット) 、[CSV](/ja/reference/formats/CSV/CSV)、[TabSeparated](/ja/reference/formats/TabSeparated/TabSeparated)、[TSKV](/ja/reference/formats/TabSeparated/TSKV)、[Parquet](/ja/reference/formats/Parquet/Parquet)、[Arrow](/ja/reference/formats/Arrow/Arrow)、[Avro](/ja/reference/formats/Avro/Avro)、[ORC](/ja/reference/formats/ORC)、[Native](/ja/reference/formats/Native) フォーマット、および `WithNames`/`WithNamesAndTypes` 接尾辞を持つフォーマットに適用されます。このオプションを有効にすると、拡張されたテーブルメタデータがサーバーからクライアントへ送信されます。そのため、サーバーで追加の計算リソースを消費し、パフォーマンスが低下する可能性があります。設定可能な値: * 0 — 無効。 * 1 — 有効。

## input\_format\_force\_null\_for\_omitted\_fields

省略されたフィールドを NULL 値で強制的に初期化します

## input\_format\_hive\_text\_allow\_variable\_number\_of\_columns

Hive Text入力では、余分なカラム (ファイルのカラム数が想定より多い場合) を無視し、不足しているフィールドはデフォルト値として扱います。

## input\_format\_hive\_text\_collection\_items\_delimiter

Hive テキストファイルにおけるコレクション (array または map) の要素間の区切り文字

## input\_format\_hive\_text\_fields\_delimiter

Hive テキストファイルにおけるフィールド間の区切り文字

## input\_format\_hive\_text\_map\_keys\_delimiter

Hive テキストファイルにおける map のキーと値の区切り文字

## input\_format\_import\_nested\_json

ネストされたオブジェクトを含む JSON データの挿入を有効または無効にします。対応フォーマット: * [JSONEachRow](/ja/reference/formats/JSON/JSONEachRow) 設定可能な値: * 0 — 無効。 * 1 — 有効。関連項目: * `JSONEachRow` フォーマットでの [Nested 構造の使用](/ja/guides/clickhouse/data-formats/json/formats#accessing-nested-json-objects)。

## input\_format\_ipv4\_default\_on\_conversion\_error

IPv4 のデシリアライゼーションでは、変換エラーが発生した場合、例外をスローする代わりにデフォルト値を使用します。デフォルトでは無効です。

## input\_format\_ipv6\_default\_on\_conversion\_error

IPv6 のデシリアライゼーションでは、変換エラーが発生した場合、例外をスローする代わりにデフォルト値が使用されます。デフォルトでは無効です。

## input\_format\_json\_compact\_allow\_variable\_number\_of\_columns

JSONCompact/JSONCompactEachRow 入力フォーマットで、行ごとのカラム数が可変であることを許可します。想定より多くのカラムを含む行では余分なカラムを無視し、不足しているカラムはデフォルト値として扱います。デフォルトでは無効です。

## input\_format\_json\_defaults\_for\_missing\_elements\_in\_named\_tuple

名前付きタプルのパース時に、JSON オブジェクト内で欠けている要素にデフォルト値を挿入します。この設定は、`input_format_json_named_tuples_as_objects` 設定が有効な場合にのみ機能します。デフォルトで有効です。

## input\_format\_json\_empty\_as\_default

有効にすると、JSON 入力内の空のフィールドをデフォルト値に置き換えます。デフォルト式が複雑な場合は、`input_format_defaults_for_omitted_fields` も有効にする必要があります。設定可能な値: * 0 — 無効。 * 1 — 有効。

## input\_format\_json\_ignore\_unknown\_keys\_in\_named\_tuple

名前付きタプルの JSON オブジェクト内にある不明なキーを無視します。デフォルトで有効です。

## input\_format\_json\_ignore\_unnecessary\_fields

不要なフィールドを無視し、それらをパースしません。これを有効にすると、形式が無効な JSON 文字列や重複フィールドを含む JSON 文字列でも例外がスローされない場合があります

## input\_format\_json\_infer\_array\_of\_dynamic\_from\_array\_of\_different\_types

有効な場合、スキーマ推論時に ClickHouse は、異なるデータ型の値を含む JSON 配列に対して Array(Dynamic) 型を使用します。例: ```sql theme={null} SET input_format_json_infer_array_of_dynamic_from_array_of_different_types=1; DESC format(JSONEachRow, '{"a" : [42, "hello", [1, 2, 3]]}'); ``` ```response theme={null} ┌─name─┬─type───────────┐ │ a │ Array(Dynamic) │ └──────┴────────────────┘ ``` ```sql theme={null} SET input_format_json_infer_array_of_dynamic_from_array_of_different_types=0; DESC format(JSONEachRow, '{"a" : [42, "hello", [1, 2, 3]]}'); ``` ```response theme={null} ┌─name─┬─type─────────────────────────────────────────────────────────────┐ │ a │ Tuple(Nullable(Int64), Nullable(String), Array(Nullable(Int64))) │ └──────┴──────────────────────────────────────────────────────────────────┘ ``` デフォルトで有効です。

## input\_format\_json\_infer\_incomplete\_types\_as\_strings

スキーマ推論時に、データサンプル内で `Null`/`{}`/`[]` のみを含む JSON キーに対して String 型を使用できるようにします。 JSON フォーマットでは任意の値を String として読み取れるため、型が不明なキーに String 型を使用することで、スキーマ推論中に `Cannot determine type for column 'column_name' by first 25000 rows of data, most likely this column contains only Nulls or empty Arrays/Maps` のようなエラーを回避できます。 Example: ```sql theme={null} SET input_format_json_infer_incomplete_types_as_strings = 1, input_format_json_try_infer_named_tuples_from_objects = 1; DESCRIBE format(JSONEachRow, '{"obj" : {"a" : [1,2,3], "b" : "hello", "c" : null, "d" : {}, "e" : []}}'); SELECT * FROM format(JSONEachRow, '{"obj" : {"a" : [1,2,3], "b" : "hello", "c" : null, "d" : {}, "e" : []}}'); ``` 結果: ``` ┌─name─┬─type───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐ │ obj │ Tuple(a Array(Nullable(Int64)), b Nullable(String), c Nullable(String), d Nullable(String), e Array(Nullable(String))) │ │ │ │ │ │ └──────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘ ┌─obj────────────────────────────┐ │ ([1,2,3],'hello',NULL,'{}',[]) │ └────────────────────────────────┘ ``` デフォルトで有効です。

## input\_format\_json\_map\_as\_array\_of\_tuples

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

## input\_format\_json\_max\_depth

JSON 内のフィールドの最大の深さです。これは厳密な制限ではないため、必ずしも正確に適用されるとは限りません。

## input\_format\_json\_named\_tuples\_as\_objects

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

## input\_format\_json\_read\_arrays\_as\_strings

JSON 入力フォーマットで JSON 配列を String としてパースできるようにします。例: ```sql theme={null} SET input_format_json_read_arrays_as_strings = 1; SELECT arr, toTypeName(arr), JSONExtractArrayRaw(arr)[3] from format(JSONEachRow, 'arr String', '{"arr" : [1, "Hello", [1,2,3]]}'); ``` 結果: ``` ┌─arr───────────────────┬─toTypeName(arr)─┬─arrayElement(JSONExtractArrayRaw(arr), 3)─┐ │ [1, "Hello", [1,2,3]] │ String │ [1,2,3] │ └───────────────────────┴─────────────────┴───────────────────────────────────────────┘ ``` デフォルトで有効です。

## input\_format\_json\_read\_bools\_as\_numbers

JSON入力フォーマットで、bool値を数値としてパースすることを許可します。デフォルトで有効です。

## input\_format\_json\_read\_bools\_as\_strings

JSON 入力フォーマットで bool 値を文字列としてパースできるようにします。デフォルトで有効です。

## input\_format\_json\_read\_numbers\_as\_strings

JSON 入力フォーマットで数値を文字列としてパースできるようにします。デフォルトで有効です。

## input\_format\_json\_read\_objects\_as\_strings

JSON 入力フォーマットで、JSON オブジェクトを String としてパースできるようにします。例: ```sql theme={null} SET input_format_json_read_objects_as_strings = 1; CREATE TABLE test (id UInt64, obj String, date Date) ENGINE=Memory(); INSERT INTO test FORMAT JSONEachRow {"id" : 1, "obj" : {"a" : 1, "b" : "Hello"}, "date" : "2020-01-01"}; SELECT * FROM test; ``` 結果: ``` ┌─id─┬─obj──────────────────────┬───────date─┐ │ 1 │ {"a" : 1, "b" : "Hello"} │ 2020-01-01 │ └────┴──────────────────────────┴────────────┘ ``` デフォルトで有効です。

## input\_format\_json\_throw\_on\_bad\_escape\_sequence

JSON入力フォーマットで JSON 文字列に不正なエスケープシーケンスが含まれている場合、例外をスローします。無効にすると、不正なエスケープシーケンスはデータ内にそのまま残ります。デフォルトで有効です。

## input\_format\_json\_try\_infer\_named\_tuples\_from\_objects

有効にすると、スキーマ推論時に ClickHouse は JSON オブジェクトから名前付き Tuple を推論しようとします。生成される名前付き Tuple には、サンプルデータ内の対応するすべての JSON オブジェクトに含まれる全要素が含まれます。例: ```sql theme={null} SET input_format_json_try_infer_named_tuples_from_objects = 1; DESC format(JSONEachRow, '{"obj" : {"a" : 42, "b" : "Hello"}}, {"obj" : {"a" : 43, "c" : [1, 2, 3]}}, {"obj" : {"d" : {"e" : 42}}}') ``` 結果: ``` ┌─name─┬─type───────────────────────────────────────────────────────────────────────────────────────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐ │ obj │ Tuple(a Nullable(Int64), b Nullable(String), c Array(Nullable(Int64)), d Tuple(e Nullable(Int64))) │ │ │ │ │ │ └──────┴────────────────────────────────────────────────────────────────────────────────────────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘ ``` デフォルトで有効です。

## input\_format\_json\_try\_infer\_numbers\_from\_strings

有効にすると、スキーマ推論時に ClickHouse は文字列フィールドから数値を推論しようとします。これは、JSON データに引用符で囲まれた UInt64 の数値が含まれている場合に役立ちます。デフォルトでは無効です。

## input\_format\_json\_use\_string\_type\_for\_ambiguous\_paths\_in\_named\_tuples\_inference\_from\_objects

JSON オブジェクトから名前付きタプルを推論する際、パスが曖昧な場合は例外の代わりに String 型を使用します

## input\_format\_json\_validate\_types\_from\_metadata

JSON/JSONCompact/JSONColumnsWithMetadata 入力フォーマットでは、この設定が 1 に設定されている場合、入力データ内のメタデータに含まれる型が、テーブル内の対応するカラムの型と比較されます。デフォルトで有効です。

## input\_format\_max\_block\_size\_bytes

入力フォーマットでデータをパースする際に生成されるブロックのサイズを、バイト単位で制限します。ClickHouse 側でブロックが生成される行ベースの入力フォーマットで使用されます。 0 は、バイト単位の制限がないことを意味します。

## input\_format\_max\_block\_wait\_ms

行ベースの入力フォーマットで、パース中にブロックが出力されるまでの最大待機時間をミリ秒単位で制限します。0 は制限なしを意味します。このオプションは、`input_format_connection_handling` が有効な場合にのみ機能します。値を設定すると並列パースも無効になり、重複排除はできなくなります。ストリーミング insert の場合は、`min_insert_block_size_rows=0` と `min_insert_block_size_bytes=0` も設定する必要があります。そうしないと、パース済みのブロックがそれらのしきい値に達するまで、ブロックをまとめる段階で引き続きメモリ内に蓄積され、速やかな insert が妨げられる可能性があります。 **例: Wikipedia の最近の変更を ClickHouse にストリーミングする** ```bash theme={null} clickhouse-client --query 'CREATE TABLE wikipedia_edits (data JSON)' curl -sS --globoff -H 'Accept: application/json' --no-buffer \ 'https://stream.wikimedia.org/v2/stream/recentchange' \ | clickhouse-client \ --query 'INSERT INTO wikipedia_edits FORMAT JSONAsObject' \ --input_format_max_block_wait_ms 1000 \ --input_format_connection_handling 1 \ --min_insert_block_size_rows 0 \ --min_insert_block_size_bytes 0 ```

## input\_format\_max\_bytes\_to\_read\_for\_schema\_inference

自動スキーマ推論のために読み取るデータ量の上限 (バイト単位) 。

## input\_format\_max\_rows\_to\_read\_for\_schema\_inference

自動的なスキーマ推論のために読み取るデータの最大行数。

## input\_format\_msgpack\_number\_of\_columns

挿入される MsgPack データのカラム数です。データからスキーマを自動推論する際に使用されます。

## input\_format\_mysql\_dump\_map\_column\_names

MySQL dump 内のテーブルのカラム名と ClickHouse テーブルのカラム名を対応付けます

## input\_format\_mysql\_dump\_table\_name

データの読み取り元となるMySQLダンプ内のテーブル名

## input\_format\_native\_allow\_types\_conversion

Native input formatでの型変換を許可します

## input\_format\_native\_decode\_types\_in\_binary\_format

Native input formatで、型名の代わりにデータ型をバイナリフォーマットで読み取ります

## input\_format\_null\_as\_default

これらのフィールドの Data type が [Nullable](/ja/reference/data-types/nullable) でない場合、[NULL](/ja/reference/syntax#literals) フィールドを[デフォルト値](/ja/reference/statements/create/table#default_values)で初期化する機能を有効または無効にします。カラムの型が Nullable ではなく、この設定が無効な場合、`NULL` を挿入すると例外が発生します。カラムの型が Nullable の場合は、この設定に関係なく、`NULL` 値はそのまま挿入されます。この設定は、ほとんどの入力フォーマットに適用されます。複雑なデフォルト式については、`input_format_defaults_for_omitted_fields` も有効にする必要があります。設定可能な値: * 0 — Nullable ではないカラムに `NULL` を挿入すると例外が発生します。 * 1 — `NULL` フィールドはカラムのデフォルト値で初期化されます。

## input\_format\_orc\_allow\_missing\_columns

ORC入力フォーマットの読み取り時に、欠落したカラムを許可します

## input\_format\_orc\_case\_insensitive\_column\_matching

ORCカラムとCHカラムの照合時に、大文字と小文字を区別しません。

## input\_format\_orc\_dictionary\_as\_low\_cardinality

ORCファイルの読み込み時に、辞書エンコードされたORCカラムをLowCardinalityカラムとして扱います。

## input\_format\_orc\_filter\_push\_down

ORCファイルの読み取り時に、ORCメタデータ内のWHERE/PREWHERE式、min/max統計、またはブルームフィルターに基づいて、ストライプ全体または行グループ全体をスキップします。

## input\_format\_orc\_reader\_time\_zone\_name

ORC 行リーダーで使用するタイムゾーン名です。デフォルトでは GMT が使用されます。

## input\_format\_orc\_row\_batch\_size

ORCストライプの読み取り時のバッチサイズ。

## input\_format\_orc\_skip\_columns\_with\_unsupported\_types\_in\_schema\_inference

ORCフォーマットのスキーマ推論時に、サポートされていない型のカラムをスキップします

## input\_format\_orc\_use\_fast\_decoder

より高速な ORC デコーダの実装を使用します。

## input\_format\_parallel\_parsing

データフォーマットの順序を保持した並列パースを有効または無効にします。[TabSeparated (TSV)](/ja/reference/formats/TabSeparated/TabSeparated)、[TSKV](/ja/reference/formats/TabSeparated/TSKV)、[CSV](/ja/reference/formats/CSV/CSV)、[JSONEachRow](/ja/reference/formats/JSON/JSONEachRow) フォーマットでのみサポートされます。設定可能な値: * 1 — 有効。 * 0 — 無効。

## input\_format\_parquet\_allow\_geoparquet\_parser

geoカラムパーサーを使用して、Array(UInt8) を Point/Linestring/Polygon/MultiLineString/MultiPolygon 型に変換します

## input\_format\_parquet\_allow\_missing\_columns

Parquet 入力フォーマットの読み取り時に欠落したカラムを許可します

## input\_format\_parquet\_bloom\_filter\_push\_down

Parquetファイルの読み取り時に、WHERE式とParquetメタデータ内のブルームフィルタに基づいて、行グループ全体をスキップします。

## input\_format\_parquet\_case\_insensitive\_column\_matching

Parquet のカラムと CH columns を照合する際に、大文字と小文字を区別しません。

## input\_format\_parquet\_enable\_json\_parsing

Parquetファイルを読み込む際、JSONカラムをClickHouse JSON Columnとしてパースします。

## input\_format\_parquet\_enable\_row\_group\_prefetch

Parquet のパース時に行グループのプリフェッチを有効にします。現在、プリフェッチに対応しているのはシングルスレッドのパースのみです。

## input\_format\_parquet\_filter\_push\_down

Parquetファイルの読み取り時に、Parquetメタデータ内のWHERE/PREWHERE式および最小値/最大値の統計情報に基づいて、行グループ全体をスキップします。

## input\_format\_parquet\_local\_file\_min\_bytes\_for\_seek

Parquet入力フォーマットで、ローカル読み取り (ファイル) 時に、読み飛ばしながら読み込む代わりに seek を行うために必要な最小バイト数

## input\_format\_parquet\_local\_time\_as\_utc

isAdjustedToUTC=false の Parquet タイムスタンプに対して、スキーマ推論で使用するデータ型を決定します。true の場合は DateTime64(..., 'UTC')、false の場合は DateTime64(...) です。ClickHouse にはローカルの wall-clock time を表すデータ型がないため、どちらの動作も完全に正しいわけではありません。直感に反しますが、おそらく 'true' のほうがまだ誤りの少ない選択です。これは、'UTC' タイムスタンプを String としてフォーマットすると、正しいローカル時刻の表現が得られるためです。

## input\_format\_parquet\_max\_block\_size

Parquet リーダーの最大ブロックサイズ。

## input\_format\_parquet\_memory\_high\_watermark

Parquet リーダー v3 のおおよそのメモリ上限です。並列に読み取る行グループまたはカラムの数を制限します。1 つのクエリで複数のファイルを読み取る場合、この制限はそれらのファイル全体での総メモリ使用量に適用されます。

## input\_format\_parquet\_memory\_low\_watermark

メモリ使用量がしきい値を下回る場合、プリフェッチをより積極的にスケジュールします。たとえば、ネットワーク経由で読み取る必要がある小さなブルームフィルタが多数ある場合に役立つ可能性があります。

## input\_format\_parquet\_page\_filter\_push\_down

カラム索引の最小値/最大値を使ってページをスキップします。

## input\_format\_parquet\_prefer\_block\_bytes

Parquet リーダーが出力する平均ブロックサイズ (バイト)

## input\_format\_parquet\_preserve\_order

Parquet ファイルの読み取り時に行を並べ替えないようにします。通常、行の順序は保証されず、クエリパイプラインの他の部分で崩れる可能性もあるため、推奨されません。代わりに `ORDER BY _row_number` を使用してください。

## input\_format\_parquet\_skip\_columns\_with\_unsupported\_types\_in\_schema\_inference

Parquet フォーマットのスキーマ推論時に、未対応の型を持つカラムをスキップします

## input\_format\_parquet\_use\_offset\_index

ページフィルタリングを使用しない場合のParquet fileからのページ読み取り方法に対する軽微な調整です。

## input\_format\_parquet\_verify\_checksums

Parquetファイルの読み取り時に、ページのチェックサムを検証します。

## input\_format\_protobuf\_flatten\_google\_wrappers

通常の非ネストのカラムに対して Google wrapper を有効にします。たとえば、String カラム 'str' に対する google.protobuf.StringValue 'str' です。Nullable カラムでは、空の wrapper はデフォルト値として認識され、存在しない場合は NULL として扱われます

## input\_format\_protobuf\_oneof\_presence

特別な列に enum 値を設定することで、protobuf oneof のどのフィールドが見つかったかを示します

## input\_format\_protobuf\_skip\_fields\_with\_unsupported\_types\_in\_schema\_inference

Protobufフォーマットのスキーマ推論時に、サポートされていない型のフィールドをスキップします

## input\_format\_record\_errors\_file\_path

テキストフォーマット (CSV、TSV) の読み取り時に発生したエラーを記録するファイルのパスです。

## input\_format\_skip\_unknown\_fields

余分なデータの挿入をスキップする機能を有効または無効にします。データの書き込み時に、入力データにターゲットテーブルに存在しないカラムが含まれている場合、ClickHouse は例外をスローします。スキップを有効にすると、ClickHouse は余分なデータを挿入せず、例外もスローしません。対応フォーマット: * [JSONEachRow](/ja/reference/formats/JSON/JSONEachRow) (およびその他の JSON フォーマット) * [BSONEachRow](/ja/reference/formats/BSONEachRow) (およびその他の JSON フォーマット) * [TSKV](/ja/reference/formats/TabSeparated/TSKV) * WithNames/WithNamesAndTypes の接尾辞を持つすべてのフォーマット * [MySQLDump](/ja/reference/formats/MySQLDump) * [Native](/ja/reference/formats/Native) 設定可能な値: * 0 — 無効。 * 1 — 有効。

## input\_format\_try\_infer\_dates

有効な場合、ClickHouse はテキストフォーマットのスキーマ推論で、文字列フィールドから型 `Date` を推論しようとします。入力データ内のあるカラムのすべてのフィールドが日付として正常にパースされた場合、結果の型は `Date` になります。少なくとも 1 つのフィールドが日付としてパースされなかった場合、結果の型は `String` になります。デフォルトで有効です。

## input\_format\_try\_infer\_datetimes

有効な場合、ClickHouse はテキストフォーマットのスキーマ推論で、文字列フィールドから `DateTime64` 型を推論しようとします。入力データのあるカラム内のすべてのフィールドを日時として正常に解析できた場合、結果の型は `DateTime64` になります。1 つでも日時として解析できないフィールドがある場合、結果の型は `String` になります。デフォルトで有効です。

## input\_format\_try\_infer\_datetimes\_only\_datetime64

input\_format\_try\_infer\_datetimes が有効な場合、DateTime 型は推論せず、DateTime64 のみを推論します

## input\_format\_try\_infer\_exponent\_floats

テキストフォーマットでスキーマを推論する際、指数表記の浮動小数点数の推論を試みます (JSON を除く。JSON では指数表記の数値は常に推論されます)

## input\_format\_try\_infer\_integers

有効な場合、ClickHouse はテキストフォーマットのスキーマ推論で、浮動小数点数ではなく整数を推論しようとします。入力データのカラム内のすべての数値が整数であれば、結果の型は `Int64` になります。1 つでも浮動小数点数が含まれている場合、結果の型は `Float64` になります。デフォルトで有効です。

## input\_format\_try\_infer\_variants

有効にすると、ClickHouse は、カラム/配列要素に複数の型の可能性がある場合、テキストフォーマットのスキーマ推論で [`Variant`](/ja/reference/data-types/variant) 型の推論を試みます。設定可能な値: * 0 — 無効。 * 1 — 有効。

## input\_format\_tsv\_allow\_variable\_number\_of\_columns

TSV 入力で余分なカラムを無視し (ファイルのカラム数が想定より多い場合) 、不足しているフィールドはデフォルト値として扱います

## input\_format\_tsv\_crlf\_end\_of\_line

true に設定すると、file関数は \n ではなく \r\n を行末とする TSVフォーマットを読み取ります。

## input\_format\_tsv\_detect\_header

TSVフォーマットで、名前と型を含むヘッダーを自動的に検出します

## input\_format\_tsv\_empty\_as\_default

TSV入力内の空のフィールドをデフォルト値として扱います。

## input\_format\_tsv\_enum\_as\_number

TSV フォーマットで挿入される enum 値を、enum のインデックスとして扱います。

## input\_format\_tsv\_skip\_first\_lines

TSVフォーマットのデータ先頭で、指定した行数をスキップします

## input\_format\_tsv\_skip\_trailing\_empty\_lines

TSVフォーマットの末尾にある空行をスキップします

## input\_format\_tsv\_use\_best\_effort\_in\_schema\_inference

TSVフォーマットでスキーマを推論する際に、いくつかの調整とヒューリスティクスを使用します

## input\_format\_values\_accurate\_types\_of\_literals

Values フォーマットでは、template を使用して式をパースおよび解釈する際、overflow や精度の問題が発生する可能性を避けるため、リテラルの実際の型を確認します。

## input\_format\_values\_deduce\_templates\_of\_expressions

Valuesフォーマットでは、フィールドをストリーミングパーサーでパースできない場合、SQLパーサーを実行して SQL 式のテンプレートを推定し、そのテンプレートを使ってすべての行のパースを試みたうえで、すべての行について式を解釈します。

## input\_format\_values\_interpret\_expressions

Values フォーマットの場合、フィールドをストリーミングパーサーで解析できなければ、SQL パーサーを実行し、SQL 式として解釈を試みます。

## input\_format\_with\_names\_use\_header

データ挿入時のカラム順序チェックを有効または無効にします。挿入パフォーマンスを向上させるため、入力データのカラム順序がターゲットテーブルと同じであることが確実な場合は、このチェックを無効にすることを推奨します。対応フォーマット: * [CSVWithNames](/ja/reference/formats/CSV/CSVWithNames) * [CSVWithNamesAndTypes](/ja/reference/formats/CSV/CSVWithNamesAndTypes) * [TabSeparatedWithNames](/ja/reference/formats/TabSeparated/TabSeparatedWithNames) * [TabSeparatedWithNamesAndTypes](/ja/reference/formats/TabSeparated/TabSeparatedWithNamesAndTypes) * [JSONCompactEachRowWithNames](/ja/reference/formats/JSON/JSONCompactEachRowWithNames) * [JSONCompactEachRowWithNamesAndTypes](/ja/reference/formats/JSON/JSONCompactEachRowWithNamesAndTypes) * [JSONCompactStringsEachRowWithNames](/ja/reference/formats/JSON/JSONCompactStringsEachRowWithNames) * [JSONCompactStringsEachRowWithNamesAndTypes](/ja/reference/formats/JSON/JSONCompactStringsEachRowWithNamesAndTypes) * [RowBinaryWithNames](/ja/reference/formats/RowBinary/RowBinaryWithNames) * [RowBinaryWithNamesAndTypes](/ja/reference/formats/RowBinary/RowBinaryWithNamesAndTypes) * [CustomSeparatedWithNames](/ja/reference/formats/CustomSeparated/CustomSeparatedWithNames) * [CustomSeparatedWithNamesAndTypes](/ja/reference/formats/CustomSeparated/CustomSeparatedWithNamesAndTypes) 設定可能な値: * 0 — 無効。 * 1 — 有効。

## input\_format\_with\_types\_use\_header

フォーマットパーサーが、入力データのデータ型とターゲットテーブルのデータ型が一致しているかどうかをチェックするかを制御します。対応フォーマット: * [CSVWithNamesAndTypes](/ja/reference/formats/CSV/CSVWithNamesAndTypes) * [TabSeparatedWithNamesAndTypes](/ja/reference/formats/TabSeparated/TabSeparatedWithNamesAndTypes) * [JSONCompactEachRowWithNamesAndTypes](/ja/reference/formats/JSON/JSONCompactEachRowWithNamesAndTypes) * [JSONCompactStringsEachRowWithNamesAndTypes](/ja/reference/formats/JSON/JSONCompactStringsEachRowWithNamesAndTypes) * [RowBinaryWithNamesAndTypes](/ja/reference/formats/RowBinary/RowBinaryWithNamesAndTypes) * [CustomSeparatedWithNamesAndTypes](/ja/reference/formats/CustomSeparated/CustomSeparatedWithNamesAndTypes) 設定可能な値: * 0 — 無効。 * 1 — 有効。

## insert\_distributed\_one\_random\_shard

distributed key がない場合に、[Distributed](/ja/reference/engines/table-engines/special/distributed) テーブルへの挿入先としてランダムな分片を使用するかどうかを設定します。既定では、複数の分片を持つ `Distributed` テーブルにデータを挿入する際、distributed key がない場合、ClickHouseサーバーは挿入リクエストを拒否します。`insert_distributed_one_random_shard = 1` に設定すると挿入が許可され、データはすべての分片に対してランダムに振り分けられます。設定可能な値: * 0 — 複数の分片があり、distributed key が指定されていない場合、挿入は拒否されます。 * 1 — distributed key が指定されていない場合、利用可能なすべての分片の中からランダムに選ばれた分片に挿入されます。

## interval\_output\_format

インターバル型のテキスト表現に使用する出力フォーマットを選択できます。設定可能な値: * `kusto` - KQL スタイルの出力フォーマット。 ClickHouse はインターバルを [KQL フォーマット](https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-timespan-format-strings#the-constant-c-format-specifier) で出力します。たとえば、`toIntervalDay(2)` は `2.00:00:00` としてフォーマットされます。なお、長さが一定でないインターバル型 (`IntervalMonth` および `IntervalYear` など) では、インターバルあたりの平均秒数が考慮されます。 * `numeric` - 数値出力フォーマット。 ClickHouse はインターバルを基になる数値表現のまま出力します。たとえば、`toIntervalDay(2)` は `2` としてフォーマットされます。関連項目: * [Interval](/ja/reference/data-types/special-data-types/interval)

## into\_outfile\_create\_parent\_directories

INTO OUTFILE の使用時に親ディレクトリがまだ存在しない場合、自動的に作成します。

## json\_type\_escape\_dots\_in\_keys

有効にすると、JSONキー内のドットはパース時にエスケープされます。

## max\_dynamic\_subcolumns\_in\_json\_type\_parsing

JSONカラムのパース時に、各カラムで作成可能な動的サブカラムの最大数です。これにより、データ型で指定された動的パラメータにかかわらず、パース中の動的サブカラム数を制御できます。

## output\_format\_arrow\_compression\_method

Arrow 出力フォーマットの圧縮方式。対応する codec: 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

変換先がない出力型を、生のバイナリデータとして出力します。false の場合、このような型では UNKNOWN\_TYPE 例外が発生します。

## output\_format\_arrow\_use\_64\_bit\_indexes\_for\_dictionary

Arrow形式のDictionaryの索引には常に64ビット整数を使用します

## output\_format\_arrow\_use\_signed\_indexes\_for\_dictionary

Arrowフォーマットの Dictionary の索引には符号付き整数を使用します

## 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](/ja/reference/data-types/newjson)データ型の値を、RowBinary出力フォーマットで JSON [String](/ja/reference/data-types/string) 値として出力します。

## output\_format\_bson\_string\_as\_string

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

## output\_format\_compression\_level

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

## output\_format\_compression\_zstd\_window\_log

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

## output\_format\_csv\_crlf\_end\_of\_line

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

## output\_format\_csv\_serialize\_tuple\_into\_separate\_columns

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

## output\_format\_decimal\_trailing\_zeros

Decimal 値を出力する際に、末尾のゼロも出力します。例: `1.23` ではなく `1.230000`。デフォルトでは無効です。

## output\_format\_json\_array\_of\_rows

[JSONEachRow](/ja/reference/formats/JSON/JSONEachRow) フォーマットで、すべての行を JSON 配列として出力する機能を有効にします。設定可能な値: * 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"} ```

## output\_format\_json\_escape\_forward\_slashes

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

## output\_format\_json\_map\_as\_array\_of\_tuples

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

## output\_format\_json\_named\_tuples\_as\_objects

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

## output\_format\_json\_pretty\_print

この設定は、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 } } ], ``` デフォルトで有効です。

## output\_format\_json\_quote\_64bit\_floats

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

## output\_format\_json\_quote\_64bit\_integers

[JSON](/ja/reference/formats/JSON/JSON)フォーマットで出力する際に、64 ビット以上の[整数](/ja/reference/data-types/int-uint) (`UInt64` や `Int128` など) を引用符で囲むかどうかを制御します。このような整数は、デフォルトで引用符で囲まれます。この動作は、ほとんどの JavaScript 実装と互換性があります。設定可能な値: * 0 — 整数は引用符なしで出力されます。 * 1 — 整数は引用符で囲まれて出力されます。

## output\_format\_json\_quote\_decimals

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

## output\_format\_json\_quote\_denormals

[JSON](/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 } } ```

## 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 シーケンスの検証を制御します。JSON/JSONCompact/JSONColumnsWithMetadata フォーマットには影響せず、これらは常に UTF-8 を検証します。デフォルトでは無効です。

## output\_format\_markdown\_escape\_special\_characters

有効にすると、Markdown 内の特殊文字をエスケープします。 [Common Mark](https://spec.commonmark.org/0.30/#example-12) では、次の特殊文字をでエスケープできるものとして定義しています。 ``` ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~ ``` 設定可能な値: * 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](/ja/reference/data-types/newjson) および [Dynamic](/ja/reference/data-types/dynamic) カラムのデータを、フラット化されたフォーマットですべての型/パスを個別のサブカラムとして書き込みます。

## output\_format\_native\_write\_json\_as\_string

デフォルトのネイティブJSONシリアライゼーションの代わりに、[JSON](/ja/reference/data-types/newjson)カラムのデータを、JSON文字列を含む単一の[String](/ja/reference/data-types/string)カラムとしてNative 出力フォーマットで書き込みます。

## 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 エンコーディングを無効にします。それ以外の場合は、Dictionary エンコーディングが有効になります

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

データのフォーマット処理を並列化するかどうかを有効または無効にします。[TSV](/ja/reference/formats/TabSeparated/TabSeparated)、[TSKV](/ja/reference/formats/TabSeparated/TSKV)、[CSV](/ja/reference/formats/CSV/CSV)、[JSONEachRow](/ja/reference/formats/JSON/JSONEachRow) フォーマットでのみサポートされています。設定可能な値: * 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 出力フォーマットの圧縮方式。対応している codec: 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 の値をミリ秒に変換せず、生の Unix timestamp として書き込みます (読み戻すと UInt32 として扱われます) 。

## output\_format\_parquet\_enum\_as\_byte\_array

Enum を Parquet の物理型 BYTE\_ARRAY、論理型 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 エンコーディングを無効にするには、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

テーブルの行数が多い場合に、フッターへカラム名を表示します。設定可能な値: * 0 — フッターにはカラム名は表示されません。 * 1 — 行数が [output\_format\_pretty\_display\_footer\_column\_names\_min\_rows](#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)─┘ ```

## output\_format\_pretty\_display\_footer\_column\_names\_min\_rows

設定 [output\_format\_pretty\_display\_footer\_column\_names](#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 (デフォルト) 。

## 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_to` と `output_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_to` に `output_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\_protobuf\_nullables\_with\_google\_wrappers

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

## output\_format\_schema

自動生成されたスキーマを [Cap'n Proto](/ja/reference/formats/CapnProto) または [Protobuf](/ja/reference/formats/Protobuf/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

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

## precise\_float\_parsing

より正確な (ただし低速な) 浮動小数点数のパースアルゴリズムを優先します

## schema\_inference\_hints

スキーマのないフォーマットでスキーマ推論を行う際に、ヒントとして使用するカラム名と型の一覧です。例: クエリ: ```sql theme={null} desc format(JSONEachRow, '{"x" : 1, "y" : "String", "z" : "0.0.0.0" }') settings schema_inference_hints='x UInt8, z IPv4'; ``` 結果: ```sql theme={null} x UInt8 y Nullable(String) z IPv4 ``` `schema_inference_hints` の形式が正しくない場合や、タイプミスや誤ったデータ型などが含まれている場合は、schema\_inference\_hints 全体が無視されます。

## schema\_inference\_make\_columns\_nullable

スキーマ推論で、推論された型を `Nullable` にするかどうかを制御します。設定可能な値: * 0 - 推論された型は `Nullable` になりません (この場合に NULL 値をどう扱うかは input\_format\_null\_as\_default で制御します) 、 * 1 - すべての推論された型が `Nullable` になります、 * 2 または `auto` - 推論された型は、スキーマ推論中に解析されるサンプル内でカラムに `NULL` が含まれている場合、またはファイルのメタデータにカラムの NULL 許容性に関する情報が含まれている場合にのみ `Nullable` になります、 * 3 - フォーマットが対応している場合 (例: Parquet) は、推論された型の NULL 許容性はファイルのメタデータに従います。それ以外の場合 (例: CSV) は常に `Nullable` になります。

## schema\_inference\_make\_json\_columns\_nullable

スキーマ推論時に、推論された JSON 型を `Nullable` にするかどうかを制御します。この設定を schema\_inference\_make\_columns\_nullable とあわせて有効にすると、推論された JSON 型は `Nullable` になります。

## schema\_inference\_mode

スキーマ推論のモードです。'default' - すべてのファイルが同じスキーマを持つとみなし、任意のファイルからスキーマを推論できます。'union' - ファイルごとに異なるスキーマを持つことができ、結果のスキーマはすべてのファイルのスキーマのユニオンになります

## show\_create\_query\_identifier\_quoting\_rule

SHOW CREATE クエリ内の識別子の引用符付けルールを設定します

## show\_create\_query\_identifier\_quoting\_style

SHOW CREATE クエリにおける識別子のクォートスタイルを設定します

## type\_json\_allow\_duplicated\_key\_with\_literal\_and\_nested\_object

有効にすると、`{"a" : 42, "a" : {"b" : 42}}` のような、一部のキーが重複していても、そのうちの一方がネストされたオブジェクトである JSON をパースできるようになります。

## type\_json\_skip\_duplicated\_paths

有効にすると、JSONオブジェクトを JSON type にパースする際、重複したパスは無視され、例外を発生させる代わりに最初のものだけが挿入されます

## type\_json\_skip\_invalid\_typed\_paths

有効にすると、型付きパスを持つ JSON type のカラムで、JSON の値を宣言された型に変換できないフィールドは、エラーをスローする代わりにスキップされます。スキップされたフィールドは欠落しているものとして扱われ、型付きパスの定義に応じてデフォルト値または NULL 値が使用されます。この設定は、特定のパスに型が宣言されている JSON type のカラム (例: JSON(a Int64, b String)) にのみ適用されます。通常の型付きカラムに insert する場合の JSONEachRow など、通常の JSON input formats には適用されません。設定可能な値: * 0 — 無効 (型が一致しない場合はエラーをスロー) 。 * 1 — 有効 (型が一致しない場合はフィールドをスキップ) 。

## type\_json\_use\_partial\_match\_to\_skip\_paths\_by\_regexp

有効にすると、JSON object を JSON type にパースする際、SKIP REGEXP で指定した正規表現は、パスをスキップするために部分一致が必要です。無効にすると、完全一致が必要です。

## validate\_experimental\_and\_suspicious\_types\_inside\_nested\_types

Array/Map/Tuple のようなネストされた型の内部で、実験的な型や疑わしい型の使用を検証します