` として解析します。
## allow\_asynchronous\_read\_from\_io\_pool\_for\_merge\_tree
MergeTree テーブルからの読み取りにバックグラウンド I/O プールを使用します。この設定により、I/O 律速のクエリではパフォーマンスが向上する場合があります。
## allow\_calculating\_subcolumns\_sizes\_for\_merge\_tree\_reading
有効にすると、ClickHouse は各サブカラムの読み取りに必要なファイルサイズを計算し、タスクサイズとブロックサイズをより適切に算出します。
## allow\_changing\_replica\_until\_first\_data\_packet
有効な場合、ヘッジドリクエストでは、すでにある程度 Progress が進んでいても、最初の Data パケットを受信するまで新しい接続を開始できます
(ただし、`receive_data_timeout` のタイムアウト時間内に Progress が更新されていない場合に限ります) 。無効な場合は、最初に Progress が進んだ時点以降、レプリカの切り替えは行われません。
## allow\_create\_index\_without\_type
TYPE を指定しない CREATE INDEX クエリを許可します。このクエリは無視されます。SQL 互換性テストのための設定です。
## allow\_custom\_error\_code\_in\_throwif
関数 throwIf() でカスタムエラーコードを有効にします。true の場合、送出される例外に想定外のエラーコードが付与されることがあります。
## allow\_ddl
true に設定すると、ユーザーは DDL クエリを実行できます。
## allow\_delta\_kernel\_rs
**別名**: `allow_experimental_delta_kernel_rs`
Delta Lake テーブルの読み取りに `delta-kernel-rs` 実装を使用できるようにします。
## allow\_distinct\_partitions\_independently
パーティション式が `DISTINCT` カラムの決定論的関数である場合、ストリーム間のマージを省略し、パーティションごとの `DISTINCT` を別スレッドで独立して評価します。パーティション数がコア数に近く、各パーティションのサイズがほぼ同じ場合に有効です。それ以外の場合は、コストヒューリスティックによりこの最適化は省略されます。[max\_number\_of\_partitions\_for\_independent\_distinct](/ja/reference/settings/session-settings/max-number#max_number_of_partitions_for_independent_distinct) および [force\_distinct\_partitions\_independently](/ja/reference/settings/session-settings/force#force_distinct_partitions_independently) を参照してください。`FINAL` または並列レプリカでは適用されません。
[max\_rows\_in\_distinct](/ja/reference/settings/session-settings/max-rows#max_rows_in_distinct) または [max\_bytes\_in\_distinct](/ja/reference/settings/session-settings/max-bytes#max_bytes_in_distinct) が設定されている場合は適用されません。これらの上限は、マージ後の結果全体を対象とする単一の `DISTINCT` 変換によって適用されるため、グローバルな意味を維持するためにストリーム間のマージは保持されます。
## allow\_distributed\_ddl
これを true に設定すると、ユーザーは分散 DDL クエリを実行できます。
## allow\_drop\_detached
ALTER TABLE ... DROP DETACHED PART\[ITION] ... クエリの実行を許可します
## allow\_dynamic\_type\_in\_join\_keys
JOIN キーで Dynamic 型を使用できるようにします。互換性のために追加された設定です。他の型との比較で予期しない結果になる可能性があるため、JOIN キーで Dynamic 型を使用することは推奨されません。
## allow\_execute\_multiif\_columnar
multiIf 関数の列指向実行を許可する
## allow\_fuzz\_query\_functions
クエリ文字列に対して AST にランダムな変更を加える `fuzzQuery` 関数を有効にします。
## allow\_general\_join\_planning
より複雑な条件を処理できる、より汎用的な JOIN 計画アルゴリズムを使用できるようにしますが、これはハッシュ結合でのみ機能します。ハッシュ結合が有効でない場合は、この設定の値に関係なく、通常の JOIN 計画アルゴリズムが使用されます。
現在の HTTP リクエストのヘッダー値を取得できる関数 `getClientHTTPHeader` の使用を許可します。`Cookie` などの一部のヘッダーには機密情報が含まれる可能性があるため、セキュリティ上の理由からデフォルトでは有効になっていません。なお、`X-ClickHouse-*`、`Authentication`、`Authorization` の各ヘッダーは常に制限されており、この関数では取得できません。
## allow\_hyperscan
Hyperscan ライブラリを使用する関数を許可します。コンパイルに長時間かかったり、リソースを過剰に消費したりする可能性を避けるには、無効にしてください。
## allow\_iceberg\_remove\_orphan\_files
Iceberg テーブルで 'ALTER TABLE ... EXECUTE remove\_orphan\_files()' を使用できるようにします。
## allow\_insert\_into\_iceberg
**別名**: `allow_experimental_insert_into_iceberg`
Iceberg に対する `insert` クエリの実行を許可します。
## allow\_introspection\_functions
クエリのプロファイリングで使用する[イントロスペクション関数](/ja/reference/functions/regular-functions/introspection)を有効または無効にします。
設定可能な値:
* 1 — イントロスペクション関数が有効。
* 0 — イントロスペクション関数が無効。
**関連項目**
* [Sampling Query Profiler](/ja/concepts/features/performance/troubleshoot/sampling-query-profiler)
* システムテーブル [trace\_log](/ja/reference/system-tables/trace_log)
## allow\_key\_condition\_coalesce\_rewrite
const` 形式の述語（および同等の `ifNull`、または定数が左辺にある場合）を、索引解析の前に選言へ書き換えるための新しい設定です。これにより、各 `a_i` のカラムごとの主キーおよびスキップ索引を利用できます。`coalesce(a, 42, b)` や `coalesce(a, b, 42)` のような、一部が定数の形式も処理されます。"}]}]} />
`coalesce(a_1, ..., a_N) const` 形式の述語 (および同等の `ifNull`、または定数が左辺にある場合) を、索引解析の前に選言 `(a_1 const) OR (a_1 IS NULL AND a_2 const) OR ... OR (a_1 IS NULL AND ... AND a_{N-1} IS NULL AND a_N const)` へ書き換えます。これにより、各 `a_i` のカラムごとの主キーおよびスキップ索引を利用できます。`coalesce(a, 42, b)` や `coalesce(a, b, 42)` のような、一部が定数の形式も処理されます。引数リストは `coalesce` 自体と同様に正規化されます (`NULL` リテラルは削除され、最初の非 `Nullable` 引数より後の引数は削除されます) 。末尾に非 `NULL` 定数がある場合は、最終分岐として出力されます。この書き換えは索引の枝刈りにのみ追加されるものであり、ランタイムフィルタリングでは引き続き元の述語が使用されます。
さらに、`nullIf(key, sentinel) = const` 形式の完全一致述語 (`sentinel != const` かつ型が完全に一致する場合) は `key = const` に書き換えられるため、`key` の主キー、パーティション、およびスキップ索引でグラニュールを直接枝刈りできます。範囲条件および選言条件に対する nullIf の枝刈りはサポートされていません。
## allow\_limit\_by\_partitions\_independently
パーティション式が `LIMIT BY` カラムの決定論的関数である場合、別個のスレッドでパーティションごとに独立して `LIMIT BY` を評価できるようにします。
## allow\_lossy\_numeric\_supertype
有効にすると、損失のない共通型を持たない数値引数のセット (たとえば `Decimal` と `Float64`、または `Int64` と `Float64`) に対する `if`/`multiIf`/`coalesce`/`ifNull`/`array`/`map` は、失敗する代わりに、精度が失われる可能性のある数値スーパータイプ (`Float64`) に解決されます。これにより、結果を `sum`、`avg`、`min`、`max` などの値を結合する集約関数で直接使用できます。これは `use_variant_as_common_type` とは独立しており、`use_variant_as_common_type` の有効・無効にかかわらず数値スーパータイプが生成されます。無効の場合 (デフォルト) 、このような引数セットには共通型がないため、`Variant` になる (`use_variant_as_common_type` が有効な場合) か、`NO_COMMON_TYPE` になります。
## allow\_materialized\_view\_with\_bad\_select
存在しないテーブルまたはカラムを参照する SELECT query を含む CREATE MATERIALIZED VIEW を許可します。ただし、構文的には有効である必要があります。refreshable MVs には適用されません。また、MV のスキーマを SELECT query から推論する必要がある場合にも適用されません (つまり、CREATE にカラムリストがなく、TO table もない場合です) 。ソーステーブルより前に MV を作成する際に使用できます。
## allow\_metadata\_only\_named\_tuple\_alter
true の場合、名前付き Tuple に新しいサブフィールドを追加するだけの ALTER MODIFY COLUMN は、メタデータのみを変更します (データ mutation は実行されません) 。
false に設定すると、従来の完全 mutation の動作を強制します。
## allow\_minmax\_index\_for\_json
JSON (Object) カラムに対する minmax スキップ索引の作成を許可します。デフォルトでは無効です。これは、minmax
索引のシリアライゼーション処理では、JSON カラムに含まれる可能性がある異種の Field 値を扱えないためです。
## allow\_named\_collection\_override\_by\_default
デフォルトで named collections のフィールドの上書きを許可します。
## allow\_non\_metadata\_alters
テーブルのメタデータだけでなく、ディスク上のデータにも影響するalterの実行を許可します
## allow\_nonconst\_timezone\_arguments
toTimeZone()、fromUnixTimestamp\*()、snowflakeIDToDateTime\*() などの一部の時刻関連関数で、非定数のタイムゾーン引数を許可します。
この設定は、互換性のためだけに存在します。ClickHouse では、タイムゾーンはデータ型、すなわちカラムのプロパティです。
この設定を有効にすると、1 つのカラム内の値ごとに異なるタイムゾーンを持てるかのような、誤った印象を与えます。
したがって、この設定は有効にしないでください。
## allow\_nullable\_tuple\_in\_extracted\_subcolumns
`Tuple(...)` 型の抽出されたサブカラムを `Nullable(Tuple(...))` 型として扱えるかどうかを制御します。
* `false`: `Tuple(...)` を返し、サブカラムが存在しない行にはデフォルトのタプル値を使用します。
* `true`: `Nullable(Tuple(...))` を返し、サブカラムが存在しない行には `NULL` を使用します。
この設定が制御するのは、抽出されたサブカラムの動作のみです。
テーブルで `Nullable(Tuple(...))` カラムを作成できるかどうかは制御しません。これは `enable_nullable_tuple_type` で制御されます。
ClickHouse は、サーバー起動時に読み込まれたこの設定値を使用します。
`SET` またはクエリレベルの `SETTINGS` による変更では、抽出されたサブカラムの動作は変わりません。
抽出されたサブカラムの動作を変更するには、起動時プロファイル設定 (たとえば users.xml) で `allow_nullable_tuple_in_extracted_subcolumns` を更新し、サーバーを再起動してください。
## allow\_rank\_dense\_rank\_arguments
後方互換性のため、`RANK` および `DENSE_RANK` ウィンドウ関数に引数を渡せるようにします。
SQL 標準では、`RANK` および `DENSE_RANK` は引数を取りません。これらは
`OVER (ORDER BY ...)` ウィンドウのみに基づいて行を順位付けします。26.5 より前の ClickHouse バージョンでは、
`RANK(x) OVER (...)` のようなクエリは引数を黙って受け入れて無視していたため、ユーザーの混乱を招いていました
(引数が見えているため順位付けに影響するように見えますが、実際には影響しませんでした) 。
この設定が `false` (デフォルト) の場合、`RANK` および `DENSE_RANK` はあらゆる引数を拒否し、
`NUMBER_OF_ARGUMENTS_DOESNT_MATCH` 例外を返します。`true` に設定すると、従来の寛容な動作が
復元され、26.5 より前と同様に引数は黙って無視されます。
## allow\_reorder\_prewhere\_conditions
条件をWHEREからPREWHEREに移動する際に、フィルタリングを最適化するため条件の並び順の変更を許可します
## allow\_replace\_partition\_from\_empty\_source
ソースのそのパーティションにパーツが存在しない場合でも、`ALTER TABLE ... REPLACE PARTITION ... FROM ...` で宛先パーティションをサイレントに削除できるようにします。
デフォルトでは、これは許可されていません。要求されたパーティションにデータがないソースから `REPLACE PARTITION` を実行すると、例外が発生します。これは、この操作が実質的に宛先に対するサイレントな `DROP PARTITION` になるためです (宛先のデータは削除されますが、それを置き換えるデータはありません) 。これは、意図しないデータ損失の一般的な原因です ([#23727](https://github.com/ClickHouse/ClickHouse/issues/23727) を参照) 。
たとえば、宛先のデータを消去するために意図的に空のソースパーティションを使う場合は、この設定を有効にすると従来の動作に戻せます。無条件に削除したい場合は、代わりに `ALTER TABLE ... DROP PARTITION ...` を使用してください。
## allow\_settings\_after\_format\_in\_insert
`INSERT` クエリで、`FORMAT` の後に `SETTINGS` を許可するかどうかを制御します。`SETTINGS` の一部が値として解釈される可能性があるため、この設定の使用は推奨されません。
例:
```sql theme={null}
INSERT INTO FUNCTION null('foo String') SETTINGS max_threads=1 VALUES ('bar');
```
ただし、次のクエリは `allow_settings_after_format_in_insert` が有効な場合にのみ動作します:
```sql theme={null}
SET allow_settings_after_format_in_insert=1;
INSERT INTO FUNCTION null('foo String') VALUES ('bar') SETTINGS max_threads=1;
```
設定可能な値:
* 0 — 不可。
* 1 — 許可。
古い構文に依存するユースケースがある場合に限り、後方互換性のためにこの設定を使用してください。
## allow\_simdjson
AVX2 命令が利用可能な場合に、`JSON*` 関数で simdjson ライブラリを使用できるようにします。無効にすると、rapidjson が使用されます。
## allow\_special\_serialization\_kinds\_in\_output\_formats
Sparse や Replicated のような特殊なシリアライゼーション種別を持つカラムを、フルカラム表現に変換せずに出力できるようにします。
これにより、フォーマット処理時の不要なデータコピーを避けられます。
## allow\_unrestricted\_reads\_from\_keeper
system.zookeeper table から無制限に (path に条件を指定せずに) 読み取ることを許可します。便利な場合もありますが、ZooKeeper に対して安全ではありません。