> ## 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.
# input_format_* フォーマット設定
> input_format_* 生成グループ内の ClickHouse フォーマット設定。
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
型
{type}
デフォルト値
{default_value}
{changeable_without_restart &&
再起動せずに変更可能
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
これらの設定は、[ソース](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/FormatFactorySettings.h)から自動生成されています。
## 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 の入力フォーマットの読み取り時に、seek (または範囲読み取り) を許可します。
有効にすると、かつ読み取り元がこれをサポートしている場合 (例: ローカルファイル、S3、範囲指定をサポートしサイズが既知の HTTP) 、
ClickHouse は必要なバイト範囲だけを読み取り、メモリ使用量を抑えることができます。
無効な場合、または読み取り元が seek をサポートしていない場合 (例: ファイルサイズが不明、または stream が seek できない場合) 、
一部のリーダーはファイル全体をメモリに読み込む動作にフォールバックすることがあります。
デフォルトで有効です。
## input\_format\_arrow\_allow\_missing\_columns
Arrow 入力フォーマットの読み取り時に、欠落しているカラムを許可します
## input\_format\_arrow\_case\_insensitive\_column\_matching
ArrowカラムとCH columnsの照合時に、大文字と小文字を区別しません。
## input\_format\_arrow\_skip\_columns\_with\_unsupported\_types\_in\_schema\_inference
Arrowフォーマットのスキーマ推論時に、未対応の型のカラムをスキップします
## input\_format\_arrow\_use\_native\_reader
Apache Arrow ライブラリベースのリーダーではなく、Arrow および ArrowStream フォーマットに ClickHouse ネイティブリーダーを使用します。
## 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](/docs/ja/reference/data-types/newjson) データ型の値を JSON [String](/docs/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 カラムにデシリアライズできます。
CSVフォーマットの名前と型を含むヘッダーを自動的に検出します
## input\_format\_csv\_empty\_as\_default
CSV入力内の空のフィールドはデフォルト値として扱います。
## input\_format\_csv\_enum\_as\_number
CSVフォーマットで挿入される enum 値を enum インデックスとして扱います
## input\_format\_csv\_missing\_nullable\_as\_empty\_string
CSV で `Nullable(String)` の欠損値をどのように読み取るかを制御します。欠損値とは、引用符で囲まれていない、カンマの間・前・後にある空の項目のことです。この設定を有効にすると、`input_format_csv_empty_as_default` の値にかかわらず、`Nullable(String)` の欠損値は NULL ではなく空の `String` として解釈されます。
## 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 入力で余分なカラム (ファイルのカラム数が想定より多い場合) を無視し、CustomSeparated 入力で不足しているフィールドはデフォルト値として扱います
CustomSeparated フォーマットの名前と型を含むヘッダーを自動的に検出します
## input\_format\_custom\_skip\_trailing\_empty\_lines
CustomSeparated フォーマットの末尾にある空行をスキップします
## input\_format\_defaults\_for\_omitted\_fields
`INSERT` クエリの実行時に、省略された入力カラムの値を、対応するカラムのデフォルト値に置き換えます。このオプションは、[JSONEachRow](/docs/ja/reference/formats/JSON/JSONEachRow) (およびその他の JSON フォーマット) 、[CSV](/docs/ja/reference/formats/CSV/CSV)、[TabSeparated](/docs/ja/reference/formats/TabSeparated/TabSeparated)、[TSKV](/docs/ja/reference/formats/TabSeparated/TSKV)、[Parquet](/docs/ja/reference/formats/Parquet/Parquet)、[Arrow](/docs/ja/reference/formats/Arrow/Arrow)、[Avro](/docs/ja/reference/formats/Avro/Avro)、[ORC](/docs/ja/reference/formats/ORC)、[Native](/docs/ja/reference/formats/Native) フォーマット、および `WithNames`/`WithNamesAndTypes` 接尾辞を持つフォーマットに適用されます。
このオプションを有効にすると、拡張テーブルのメタデータがサーバーからクライアントに送信されます。これにより、サーバーで追加の計算リソースが消費され、パフォーマンスが低下する可能性があります。
設定可能な値:
* 0 — 無効。
* 1 — 有効。
## input\_format\_force\_null\_for\_omitted\_fields
省略されたフィールドを強制的に NULL 値で初期化します
## input\_format\_geojson\_unsupported\_geometry\_handling
`GeoJSON` 入力の読み込み時に、ClickHouse の `Geometry` 型で表現できない有効な `GeoJSON` のジオメトリ型 (`GeometryCollection` や `MultiPoint` など) を `geometry` カラムに格納する必要がある場合の動作を制御します。
設定可能な値:
* `'throw'` (デフォルト) — 例外をスローします。
* `'null'` — `geometry` カラムに `NULL` 値を挿入し、パースを続行します。
これは `geometry` カラムが materialized されている場合にのみ適用されます。要求された出力カラムでない場合、そのようなジオメトリは形式の妥当性のみ検証され、この処理はトリガーされません。
## input\_format\_hive\_text\_allow\_variable\_number\_of\_columns
Hive Text の入力時に余分なカラムを無視し (ファイルのカラム数が想定より多い場合) 、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](/docs/ja/reference/formats/JSON/JSONEachRow)
設定可能な値:
* 0 — 無効。
* 1 — 有効。
関連項目:
* `JSONEachRow` フォーマットでの [Nested 構造の使用](/docs/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` のようなエラーを回避できます。
例:
```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 配列を文字列としてパースできるようにします。
例:
```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 オブジェクトを文字列としてパースできるようにします。
例:
```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 オブジェクトから named Tuple を推論します。
生成される named 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 オブジェクトから named tuple を推論する際、あいまいなパスでは例外の代わりに 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` が有効な場合にのみ機能します。値を設定すると、並列パースも無効になり、重複排除もできなくなります。
ストリーミング挿入では、`min_insert_block_size_rows=0` と `min_insert_block_size_bytes=0` も設定する必要があります。そうしないと、パース済みのブロックがそれらの閾値に達するまで、ブロックをまとめる段階でメモリ内に蓄積され続け、適時に挿入されなくなる可能性があります。
**例: Wikipedia の recent changes を 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 dump 内のテーブル名
## input\_format\_native\_allow\_types\_conversion
Native入力フォーマットでのデータ型変換を許可します
## input\_format\_native\_decode\_types\_in\_binary\_format
Native入力フォーマット で、型名の代わりにデータ型をバイナリ形式で読み取ります
## input\_format\_null\_as\_default
これらのフィールドのデータ型が [Nullable](/docs/ja/reference/data-types/nullable) でない場合に、[NULL](/docs/ja/reference/syntax#literals) フィールドを[デフォルト値](/docs/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)](/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 — 無効。
## 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ファイルの読み取り時に、Parquet メタデータ内の WHERE 式と ブルームフィルタ に基づいて、行グループ全体をスキップします。
## input\_format\_parquet\_case\_insensitive\_column\_matching
Parquet のカラムを CH のカラムと照合する際に、大文字と小文字を区別しません。
## input\_format\_parquet\_enable\_json\_parsing
Parquet ファイルを読み取る際、JSON カラムを ClickHouse の JSON カラムとしてパースします。
## 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を行うために必要な、ローカル読み取り (file) の最小バイト数
## input\_format\_parquet\_local\_time\_as\_utc
isAdjustedToUTC=false の Parquet timestamp に対して、スキーマ推論で使用するデータ型を決定します。true の場合は DateTime64(..., 'UTC')、false の場合は DateTime64(...) です。ClickHouse にはローカルの wall-clock time を表すデータ型がないため、どちらの動作も完全に正しいわけではありません。直感に反しますが、おそらく 'true' のほうがまだ誤りの少ない選択肢です。これは、'UTC' timestamp を 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ファイルからのページ読み取り方法に関する軽微な調整。
## 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](/docs/ja/reference/formats/JSON/JSONEachRow) (およびその他の JSON フォーマット)
* [BSONEachRow](/docs/ja/reference/formats/BSONEachRow) (およびその他の JSON フォーマット)
* [TSKV](/docs/ja/reference/formats/TabSeparated/TSKV)
* WithNames/WithNamesAndTypes の接尾辞を持つすべてのフォーマット
* [MySQLDump](/docs/ja/reference/formats/MySQLDump)
* [Native](/docs/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 は、カラム/Array の要素に複数の型候補がある場合、テキストフォーマットのスキーマ推論で [`Variant`](/docs/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 フォーマットを読み取ります。
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 フォーマットの場合: テンプレートを使用して式をパースおよび解釈する際は、オーバーフローや精度の問題を回避するため、リテラルの実際の型を確認します。
## input\_format\_values\_deduce\_templates\_of\_expressions
Values フォーマットでは、フィールドをストリーミングパーサーでパースできない場合、SQL パーサーを実行して SQL 式のテンプレートを推定し、そのテンプレートを使ってすべての行のパースを試みたうえで、すべての行について式を解釈します。
## input\_format\_values\_interpret\_expressions
Valuesフォーマットでは、フィールドをストリーミングパーサーで解析できない場合、SQLパーサーを実行し、SQL式として解釈を試みます。
データ挿入時に、カラムの順序をチェックするかどうかを有効または無効にします。
insert のパフォーマンスを向上させるには、入力データのカラム順序がターゲットテーブルと同じであることが確実な場合、このチェックを無効にすることを推奨します。
対応フォーマット:
* [CSVWithNames](/docs/ja/reference/formats/CSV/CSVWithNames)
* [CSVWithNamesAndTypes](/docs/ja/reference/formats/CSV/CSVWithNamesAndTypes)
* [TabSeparatedWithNames](/docs/ja/reference/formats/TabSeparated/TabSeparatedWithNames)
* [TabSeparatedWithNamesAndTypes](/docs/ja/reference/formats/TabSeparated/TabSeparatedWithNamesAndTypes)
* [JSONCompactEachRowWithNames](/docs/ja/reference/formats/JSON/JSONCompactEachRowWithNames)
* [JSONCompactEachRowWithNamesAndTypes](/docs/ja/reference/formats/JSON/JSONCompactEachRowWithNamesAndTypes)
* [JSONCompactStringsEachRowWithNames](/docs/ja/reference/formats/JSON/JSONCompactStringsEachRowWithNames)
* [JSONCompactStringsEachRowWithNamesAndTypes](/docs/ja/reference/formats/JSON/JSONCompactStringsEachRowWithNamesAndTypes)
* [RowBinaryWithNames](/docs/ja/reference/formats/RowBinary/RowBinaryWithNames)
* [RowBinaryWithNamesAndTypes](/docs/ja/reference/formats/RowBinary/RowBinaryWithNamesAndTypes)
* [CustomSeparatedWithNames](/docs/ja/reference/formats/CustomSeparated/CustomSeparatedWithNames)
* [CustomSeparatedWithNamesAndTypes](/docs/ja/reference/formats/CustomSeparated/CustomSeparatedWithNamesAndTypes)
設定可能な値:
* 0 — 無効。
* 1 — 有効。
フォーマットパーサーが、入力データのデータ型とターゲットテーブルのデータ型が一致しているかどうかを確認するかを制御します。
対応フォーマット:
* [CSVWithNamesAndTypes](/docs/ja/reference/formats/CSV/CSVWithNamesAndTypes)
* [TabSeparatedWithNamesAndTypes](/docs/ja/reference/formats/TabSeparated/TabSeparatedWithNamesAndTypes)
* [JSONCompactEachRowWithNamesAndTypes](/docs/ja/reference/formats/JSON/JSONCompactEachRowWithNamesAndTypes)
* [JSONCompactStringsEachRowWithNamesAndTypes](/docs/ja/reference/formats/JSON/JSONCompactStringsEachRowWithNamesAndTypes)
* [RowBinaryWithNamesAndTypes](/docs/ja/reference/formats/RowBinary/RowBinaryWithNamesAndTypes)
* [CustomSeparatedWithNamesAndTypes](/docs/ja/reference/formats/CustomSeparated/CustomSeparatedWithNamesAndTypes)
設定可能な値:
* 0 — 無効。
* 1 — 有効。