` として解析します。
## 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\_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
クエリのプロファイリングで使用する[イントロスペクション関数](/docs/ja/reference/functions/regular-functions/introspection)を有効または無効にします。
設定可能な値:
* 1 — イントロスペクション関数が有効。
* 0 — イントロスペクション関数が無効。
**関連項目**
* [Sampling Query Profiler](/docs/ja/concepts/features/performance/troubleshoot/sampling-query-profiler)
* システムテーブル [trace\_log](/docs/ja/reference/system-tables/trace_log)
## allow\_key\_condition\_coalesce\_rewrite
const` 形式の述語（および同等の `ifNull`、または定数が左辺にある場合）を、索引解析の前に選言へ書き換えるための新しい設定です。これにより、各 `a_i`` に対するカラムごとの主キーおよびスキップ索引を利用できます。`coalesce(a, 42, b)` や `coalesce(a, b, 42)` のような一部定数を含む形式も処理されます。"}]}]} />
`coalesce` または `ifNull` を含む `WHERE`/`PREWHERE` 述語について、MergeTree の主キーおよびスキップ索引でグラニュールを枝刈りできるようにします。この設定がない場合、このような述語は索引解析では不透明なものとして扱われ、枝刈りされないため、一致しないことが明らかなグラニュールも読み込まれます。影響するのはどのグラニュールを読み込むかだけであり、行は引き続き元の述語でフィルタされるため、クエリ結果は変わりません。
索引解析の前に、次の 2 種類の述語パターンが書き換えられます。
* `coalesce`/`ifNull` に対する比較 (たとえば `coalesce(a, b) = 5`) は、各 argument の索引で枝刈りできるよう、選言に書き換えられます: `a = 5 OR (a IS NULL AND b = 5)`。argument がさらに多い場合も同様に拡張されます。
* 条件として直接使用される、偽とみなされる (ゼロの) 定数デフォルトを持つ `coalesce`/`ifNull` (たとえば `ifNull(a = 5, 0)` や `coalesce(a = 5, 0)`) は、内部の述語 `a = 5` にアンラップされます。このような wrapper は、内部述語の三値の結果を確定的なブール値に畳み込みます (`NULL` を `false` に対応付けます) 。
## allow\_limit\_by\_partitions\_independently
パーティション式が `LIMIT BY` カラムの決定論的関数である場合、別個のスレッドでパーティションごとに独立して `LIMIT BY` を評価できるようにします。
## allow\_materialized\_view\_with\_bad\_select
存在しないテーブルまたはカラムを参照する SELECT query を含む CREATE MATERIALIZED VIEW を許可します。ただし、構文的には有効である必要があります。refreshable MVs には適用されません。また、MV のスキーマを SELECT query から推論する必要がある場合にも適用されません (つまり、CREATE にカラムリストがなく、TO table もない場合です) 。ソーステーブルより前に MV を作成する際に使用できます。
## 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 に対して安全ではありません。