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

# その他のセッション設定

> 「Other」生成グループ内の ClickHouse セッション設定。

これらの設定は [system.settings](https://clickhouse.com/docs/ja/reference/system-tables/settings.md) で参照でき、[ソースコード](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) から自動生成されています。

## adaptive\_aggregator\_freeze\_threshold

型

UInt64

デフォルト値

16384

アダプティブアグリゲータがスレッドのローカルハッシュテーブルを凍結するキー数です (`enable_adaptive_aggregator` を参照) 。値を小さくすると、凍結されたテーブルはキャッシュに収まりやすくなり、大きくすると頻出キーをより多く保持できます。0 を指定すると、最初の機会にテーブルを凍結します。この場合、アルゴリズムはキー hash による純粋な分片と同様に動作します。各キーは hash によってルーティングされ、単一の所有者によって集計されますが、スキャン中にスレッド間で交換されるのではなく、マージフェーズまで処理が延期されます。

## adaptive\_aggregator\_freeze\_threshold\_bytes

型

UInt64

デフォルト値

4194304

アダプティブアグリゲータがスレッドのローカルハッシュテーブルを凍結するメモリサイズです (`enable_adaptive_aggregator` を参照) 。この値と `adaptive_aggregator_freeze_threshold` のうち、先に達した方でテーブルが凍結されます。サイズは、ローカルテーブル自体が割り当てたバイト数 (ハッシュテーブルの buffer とそのアリーナ) であり、block 間で確認されます。キーまたは aggregation state が wide な場合、このバイト上限が重要になります。キー数のしきい値だけでは、そのようなテーブルが CPU cache を超えるほど大きくなる可能性があります。デフォルト値では、通常のキー幅および state 幅のテーブルは引き続きキー数によって凍結されます。0 を指定するとバイト上限が無効になり、キー数のしきい値のみで決まります。

## add\_http\_cors\_header

型

Bool

デフォルト値

0

HTTP CORS ヘッダーを追加して書き込みます。

## analyze\_index\_with\_multiple\_key\_columns\_per\_condition

型

Bool

デフォルト値

1

索引解析時に、`WHERE`/`PREWHERE` 式に含まれる1つの原子的な条件 (単一の比較、`IN`、`has` など) で、複数のキーカラムを絞り込めるようにします。

例えば、テーブルに `ORDER BY (toDate(ts), ts)` が指定されていて、クエリに `WHERE ts = '2026-01-10 00:00:00' AND user_id = 42` が含まれている場合、2つの条件のうち1つ目の条件で両方のキーカラムが絞り込まれます。つまり、`toDate(ts) = '2026-01-10' AND ts = '2026-01-10 00:00:00'` と記述した場合と同様に解析されます。この設定が無効の場合、この述語で絞り込まれるのは `ts` のみです。なお、`(a, b) IN ((1, 2), (3, 4))` のようなタプルのメンバーシップ述語では、この設定が無効であっても複数のキーカラムを絞り込めます。

## analyze\_index\_with\_space\_filling\_curves

型

Bool

デフォルト値

1

テーブルの索引に空間充填曲線が含まれている場合 (例: `ORDER BY mortonEncode(x, y)` や `ORDER BY hilbertEncode(x, y)`) 、クエリにその引数に対する条件 (例: `x >= 10 AND x <= 20 AND y >= 20 AND y <= 30`) があるときは、索引解析に空間充填曲線を使用します。現在、曲線の実装では各引数に32ビットしか使用していないため、2次元解析では `UInt64` 引数を持つ曲線はスキップされます。

## analyzer\_inline\_views

[実験的な機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#experimental-features)

型

Bool

デフォルト値

0

有効にすると、アナライザは通常の (非マテリアライズドかつ非パラメータ化された) ビューを、それを定義するサブクエリで置き換えます。これにより、述語プッシュダウンやカラムのプルーニングなど、ビュー境界をまたぐ最適化が可能になります。

## anti\_join\_include\_columns\_from\_both\_sides

型

Bool

デフォルト値

1

有効な場合 (デフォルト) 、`ANTI` JOIN では結合結果から両側のカラムにアクセスでき、`SELECT *` も両側のカラムを返します。これは ClickHouse の従来 (レガシー) の動作です。
無効な場合、アナライザは SQL 標準に従い、`ANTI` JOIN でアクセスできるカラムを保持される側に制限します。
`LEFT ANTI JOIN` では左テーブルのカラムのみ、`RIGHT ANTI JOIN` では右テーブルのカラムのみにアクセスできます。
この制限は、`SELECT`、`PREWHERE`、`WHERE`、`GROUP BY`、`HAVING`、`QUALIFY`、`ORDER BY`、`LIMIT BY` 句など、結合結果から解決される式に適用され、`t1.*` のような修飾付きワイルドカードも対象となります。
保持されない側のカラムを明示的に参照すると、`SEMI_ANTI_JOIN_COLUMN_ACCESS_DENIED` 例外が送出されます。対象には、`t2.b` のような修飾付き参照、`t2.*` のような修飾付きワイルドカード、`d.id` のような `USING` カラム、`db.table.column` のような完全修飾参照が含まれます。また、`if(false, t2.b, 42)` のように静的に到達しない分岐内であっても、この制限は適用されます。なお、アクセス可能などのカラムにも一致しない修飾なしの識別子については、従来どおり汎用の `UNKNOWN_IDENTIFIER` 例外となります。
同じ `JOIN` の `JOIN ON` 式からは、この設定にかかわらず両側にアクセスできます。

## any\_join\_distinct\_right\_table\_keys

型

Bool

デフォルト値

0

`ANY INNER|LEFT JOIN` 操作で従来の ClickHouse server の動作を有効にします。

> [!NOTE]
>
> この設定は、ユースケースが従来の `JOIN` の動作に依存している場合に限り、後方互換性のために使用してください。

従来の動作が有効な場合:

* ClickHouse は左から右へのテーブルキーの多対一マッピングというロジックを使用するため、`t1 ANY LEFT JOIN t2` と `t2 ANY RIGHT JOIN t1` の結果は同一になりません。
* `ANY INNER JOIN` 操作の結果には、`SEMI LEFT JOIN` 操作と同様に、左テーブルのすべての行が含まれます。

従来の動作が無効な場合:

* ClickHouse は `ANY RIGHT JOIN` 操作で一対多のキーマッピングを行うロジックを使用するため、`t1 ANY LEFT JOIN t2` と `t2 ANY RIGHT JOIN t1` の結果は同一になります。
* `ANY INNER JOIN` 操作の結果には、左テーブルと右テーブルの両方について、キーごとに 1 行が含まれます。

設定可能な値:

* 0 — 従来の動作は無効です。
* 1 — 従来の動作は有効です。

関連項目:

* [JOIN strictness](https://clickhouse.com/docs/ja/reference/statements/select/join.md#settings)

## archive\_adaptive\_buffer\_max\_size\_bytes

型

UInt64

デフォルト値

8388608

アーカイブファイル (たとえば tar アーカイブ) への書き込み時に使用されるアダプティブバッファの最大サイズを制限します

## array\_count\_legacy\_uint32\_result

型

Bool

デフォルト値

0

有効にすると、関数 `arrayCount` は `UInt64` ではなく、バージョン 26.10 より前と同様に `UInt32` を返します。`UInt32` の結果は、条件に一致する要素が `4294967295` 個を超える配列では警告なしにラップアラウンドします。また、この設定は結果の定数性も 26.10 より前の挙動に戻します。つまり、定数 false に畳み込まれる述語は、配列が非定数であっても定数の結果カラムを生成します。

ローリングアップグレード中は、アップグレード済みのサーバー上で分散クエリを実行するユーザーに対してこの設定を有効にしてください。これにより、未アップグレードのサーバーがイニシエーターとなる分散クエリの挙動を完全に維持できます (旧バージョンのイニシエーターはこの設定を転送しないため、有効にしないと、アップグレード済みの分片上でローカルに評価される型依存の式が `UInt64` を受け取ることになります) 。アップグレードが完了したら、この設定は削除してください。分片側のクエリをどのユーザーで実行するかは、クラスターの設定によって異なります。interserver `secret` が設定されている場合はイニシエーターの現在のユーザー、それ以外の場合はクラスター定義または `remote` テーブル関数で指定されたユーザー (指定がない場合は `default`) となります。最も簡単かつ確実なのは、アップグレード済みサーバーのすべてのユーザーに対してこの設定を有効にする方法です。

## arrow\_flight\_request\_descriptor\_type

型

ArrowFlightDescriptorType

デフォルト値

path

Arrow Flight リクエストで使用するディスクリプタの種類です。'path' はデータセット名をパスディスクリプタとして送信します。'command' は SQL クエリを command ディスクリプタとして送信します (Dremio では必須) 。

設定可能な値:

* 'path' — FlightDescriptor::Path を使用します (デフォルト。ほとんどの Arrow Flight サーバーで動作します)
* 'command' — SELECT クエリとともに FlightDescriptor::Command を使用します (Dremio では必須)

## arrow\_flight\_request\_timeout\_sec

型

UInt64

デフォルト値

300

個々の Arrow Flight リクエストのタイムアウト (秒) です。この上限はリクエスト全体に適用されます。読み取りの場合は、最初のレコードバッチを受信するまでの待機時間だけでなく、結果ストリーム全体が対象となります。0 を指定するとタイムアウトは無効になります。この場合、Flight サーバーがリクエストを受け付けたまま応答しないと、接続が閉じられるまでクエリがブロックされます。

## backup\_s3\_expired\_token\_retry\_timeout\_ms

型

UInt64

デフォルト値

120000

バックアップまたは復元中に、応答で `ExpiredToken` が返された S3 リクエストを再試行する最大時間 (ミリ秒) です。再試行回数が `backup_restore_s3_retry_attempts` に達した場合も、再試行は停止します。0 を指定すると、この再試行は無効になります。AWS S3 の `HEAD` 応答は汎用的な HTTP ステータスしか返さないため、`HEAD` によるメタデータリクエストはこの再試行の対象外です。

## backup\_slow\_all\_threads\_after\_retryable\_s3\_error

型

Bool

デフォルト値

0

`true` に設定すると、同じバックアップエンドポイントに対して S3 リクエストを実行しているすべてのスレッドが、
いずれか 1 つの S3 リクエストで 'Slow Down' などの再試行可能な S3 エラーが発生した後に
遅延されます。
`false` に設定すると、各スレッドは他のスレッドとは独立して、S3 リクエストのバックオフを処理します。

## cache\_warmer\_threads

型

UInt64

デフォルト値

4

ClickHouse Cloudでのみ有効です。[cache\_populated\_by\_fetch](https://clickhouse.com/docs/ja/reference/settings/merge-tree-settings/cache-populated-by-fetch.md#cache_populated_by_fetch) が有効な場合に、新しいデータパーツをファイルシステムキャッシュへ先読み的にダウンロードするバックグラウンドスレッド数です。無効にするには 0 を指定します。

## calculate\_text\_stack\_trace

型

Bool

デフォルト値

1

クエリ実行中に例外が発生した場合に、テキスト形式のスタックトレースを計算します。これがデフォルトです。これにはシンボルのルックアップが必要なため、大量の不正なクエリが実行されると、ファジングテストが遅くなることがあります。通常、このオプションを無効にすべきではありません。

## cancel\_http\_readonly\_queries\_on\_client\_close

型

Bool

デフォルト値

0

クライアントがレスポンスを待たずに接続を閉じた場合、HTTP の読み取り専用クエリ (例: `SELECT`) をキャンセルします。

Cloud でのデフォルト値: `1`.

## cascades\_aggregation\_pushdown

[ベータ機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

型

Bool

デフォルト値

1

Cascades オプティマイザーにおいて、部分集約を join の下にプッシュダウンする (即時実行集約) ことを、コストベースの選択肢の1つとして検討します。
`enable_cascades_optimizer = 1` および `make_distributed_plan = 1` と併用した場合にのみ有効になります。

## checksum\_on\_read

型

Bool

デフォルト値

1

読み取り時にチェックサムを検証します。これはデフォルトで有効になっており、本番環境では常に有効にしておくべきです。この設定を無効にしても、利点が得られることはありません。使用するのは、実験やベンチマークの場合のみにしてください。この設定が適用されるのは、MergeTree family のテーブルのみです。その他のテーブルエンジンや、ネットワーク経由でデータを受信する場合は、チェックサムは常に検証されます。

## 圧縮

レスポンスボディに汎用圧縮を適用します。例: `compression=gz`。これは `Content-Encoding` (HTTP 圧縮) および従来の `compress` パラメータ (ClickHouse ネイティブ圧縮) とは独立しています。URL パスで圧縮ファイルの拡張子を指定することも同等です。

これは HTTP インターフェイスのレスポンス整形設定です。クエリの実行前に処理され (レスポンスバッファは事前に設定されるため) 、HTTP URL パラメータ、URL パスのファイル拡張子、またはユーザープロファイルを介して指定する必要があります。クエリ内の `SETTINGS` 句で指定しても効果はなく、拒否されます。

## connection\_pool\_max\_wait\_ms

型

Milliseconds

デフォルト値

0

接続プールが満杯の場合に、接続を待機する時間 (ミリ秒) 。

接続プールはレプリカごとに1つ存在するため、この待機はレプリカ単位で適用されます。待機時間が経過すると、その試行は `NO_FREE_CONNECTION` で失敗します。分散 `SELECT` が使用するフェイルオーバー経路では、これは使用できないその他のレプリカと同様に扱われます。つまりクエリは残りのレプリカを試行し、そのすべてを試し終えて初めて `ALL_CONNECTION_TRIES_FAILED` で失敗します。したがって、この設定でクエリ全体の時間が制限されるわけではありません。`N` 個のレプリカがあり、それぞれ `T` 回試行する場合、合計の待機時間は `connection_pool_max_wait_ms` × `N` × `T` に達する可能性があります。ここで `T` は [connections\_with\_failover\_max\_tries](https://clickhouse.com/docs/ja/reference/settings/session-settings/other.md#connections_with_failover_max_tries) ですが、レプリカは除外される前に必ず一度は試行されるため、1 を下回ることはありません。クエリ自体を制限するには [max\_execution\_time](https://clickhouse.com/docs/ja/reference/settings/session-settings/max-execution.md#max_execution_time) を使用してください。

`skip_unavailable_shards` によってこれが抑制されることはありません。イニシエーターに空き接続 slot がなかったレプリカにはそもそも接続が行われていないため、その分片は使用不可とは扱われません。

設定可能な値:

* 正の整数。
* 0 — 無制限のタイムアウト。この場合でも待機は `KILL QUERY` によって中断され、また [timeout\_overflow\_mode](https://clickhouse.com/docs/ja/reference/settings/session-settings/timeout-overflow-mode.md#timeout_overflow_mode) が既定値の `throw` であれば `max_execution_time` によっても中断されます。
  `break` の場合は時間制限によってクエリがキャンセルされないため、接続が解放されるまで待機が続きます。`KILL QUERY` による中断は引き続き有効です。

## connections\_with\_failover\_max\_tries

型

UInt64

デフォルト値

3

Distributed テーブルエンジンで、各レプリカに対して行う接続試行の最大回数。

## convert\_query\_to\_cnf

型

Bool

デフォルト値

0

`true` に設定すると、`SELECT` クエリは連言標準形 (CNF) に変換されます。クエリを CNF に書き換えることで、実行が高速になる場合があります (詳しくはこの [Github issue](https://github.com/ClickHouse/ClickHouse/issues/11749) を参照してください) 。

たとえば、次の `SELECT` クエリは変更されません (デフォルトの動作) :

```sql theme={null}
EXPLAIN SYNTAX
SELECT *
FROM
(
    SELECT number AS x
    FROM numbers(20)
) AS a
WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))
SETTINGS convert_query_to_cnf = false;
```

結果は次のとおりです：

```response theme={null}
┌─explain────────────────────────────────────────────────────────┐
│ SELECT x                                                       │
│ FROM                                                           │
│ (                                                              │
│     SELECT number AS x                                         │
│     FROM numbers(20)                                           │
│     WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15)) │
│ ) AS a                                                         │
│ WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))     │
│ SETTINGS convert_query_to_cnf = 0                              │
└────────────────────────────────────────────────────────────────┘
```

`convert_query_to_cnf` を `true` に設定して、何が変わるか見てみましょう。

```sql theme={null}
EXPLAIN SYNTAX
SELECT *
FROM
(
    SELECT number AS x
    FROM numbers(20)
) AS a
WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))
SETTINGS convert_query_to_cnf = true;
```

`WHERE`句は CNF に書き換えられていますが、結果セットはまったく同じで、ブール値の論理は変わっていません：

```response theme={null}
┌─explain───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ SELECT x                                                                                                              │
│ FROM                                                                                                                  │
│ (                                                                                                                     │
│     SELECT number AS x                                                                                                │
│     FROM numbers(20)                                                                                                  │
│     WHERE ((x <= 15) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x >= 10) OR (x >= 1)) │
│ ) AS a                                                                                                                │
│ WHERE ((x >= 10) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x <= 15) OR (x <= 5))     │
│ SETTINGS convert_query_to_cnf = 1                                                                                     │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
```

設定可能な値: true, false

## count\_matches\_stop\_at\_empty\_match

型

Bool

デフォルト値

0

`countMatches` 関数では、パターンが長さ 0 に一致した時点でカウントを停止します。

## cross\_to\_inner\_join\_rewrite

型

UInt64

デフォルト値

1

WHERE 句に結合条件となる式がある場合、comma/cross join の代わりに inner join を使用します。値: 0 - 書き換えなし、1 - 可能な場合は comma/cross に適用、2 - すべての comma join を強制的に書き換え、cross は可能な場合に書き換え

## data\_type\_default\_nullable

型

Bool

デフォルト値

0

カラム定義で明示的な修飾子 [NULL or NOT NULL](https://clickhouse.com/docs/ja/reference/statements/create/table.md#null-or-not-null-modifiers) を指定しないデータ型を、[Nullable](https://clickhouse.com/docs/ja/reference/data-types/nullable.md) として扱うかどうかを指定します。
この設定は `CREATE TABLE`、`ALTER TABLE ... ADD COLUMN`、`ALTER TABLE ... MODIFY COLUMN` に適用されます。

設定可能な値:

* 1 — カラム定義のデータ型は、デフォルトで `Nullable` に設定されます。
* 0 — カラム定義のデータ型は、デフォルトで `Nullable` に設定されません。

## decimal\_check\_overflow

型

Bool

デフォルト値

1

Decimal の算術/比較演算でオーバーフローをチェックします

## deduplicate\_blocks\_in\_dependent\_materialized\_views

型

Bool

デフォルト値

1

Replicated\* テーブルからデータを受け取る materialized view に対する重複排除チェックを有効または無効にします。

設定可能な値:

* 0 — 無効。
* 1 — 有効。

有効にすると、ClickHouse は Replicated\* テーブルに依存する materialized view 内のブロックに対して重複排除を実行します。
この設定は、障害によって挿入処理が再試行される場合に、materialized view に重複データが含まれないようにするのに役立ちます。

**関連項目**

* [IN 演算子における NULL の処理](https://clickhouse.com/docs/ja/concepts/features/operations/insert/deduplicating-inserts-on-retries.md#insert-deduplication-with-materialized-views)

## defer\_partition\_pruning\_after\_final

型

Bool

デフォルト値

1

有効な場合 (デフォルト) 、パーティションキーカラムがソートキーに含まれていない
テーブルに対する `FINAL` クエリでは、パーティションプルーニングはスキップされます。これは
26.3 で導入された、正しさを優先した動作です。`FINAL` では、同じ主キーを共有しながら
異なるパーティションに存在する行を重複排除する必要が生じる場合があり、パーティションプルーニングを行うと、
そのような行が重複排除の対象から気づかれないまま除外される可能性があります。

無効な場合は、`FINAL` を使用していてもパーティションプルーニングが適用され、26.3 より前の
動作に戻ります。これは、パーティションカラムに対する `WHERE` 条件を含むクエリでは大幅に高速になる
可能性がありますが、同じ主キーを持つ行が異なるパーティションに存在しない場合にのみ正しい動作となります。
たとえば、パーティションカラムが insert 時に設定され、その後は変更されないイベントログテーブルなどです。

この設定が影響するのは、パーティションキーカラムがソートキーに含まれていない
パーティションテーブルだけです。その他のテーブルでは、パーティションプルーニングは常に適用されます。

設定可能な値:

* 0 — `FINAL` の前にパーティションプルーニングを適用します (26.3 より前の動作。高速ですが、一般的には安全ではありません) 。
* 1 — `FINAL` の後までパーティションプルーニングを遅らせます (デフォルト。正しさを優先) 。

## describe\_compact\_output

型

Bool

デフォルト値

0

true の場合、DESCRIBE クエリの結果にはカラム名と型のみが含まれます

## dialect

型

Dialect

デフォルト値

clickhouse

クエリの解析に使用するdialect。

サポートされる値:

* `clickhouse` (デフォルト) — 標準のClickHouse SQL。
* `kusto` — Kusto Query Language。ベータ設定の`allow_experimental_kusto_dialect`が必要です。
* `prql` — PRQL。実験的設定の`allow_experimental_prql_dialect`が必要です。
* `polyglot` — 他のdialect (MySQL、PostgreSQLなど) のSQLをClickHouse SQLにトランスパイルします。実験的設定の`allow_experimental_polyglot_dialect`が必要です。
* `promql` — `promql_database`、`promql_table`、`promql_evaluation_time`設定で構成されたTimeSeriesテーブルに対して評価されるPromQL (Prometheus Query Language) 。
* `clickhouse_json` — SQLテキストの代わりに、クエリをJSON AST (`parseQueryToJSON`の出力) として解釈します。dialectを元に戻せるよう、`SET`クエリは引き続き通常の形式で認識されます。実験的設定の`enable_json_ast_dialect`が必要です。
* `logsql` — VictoriaLogsのログクエリ言語であるLogsQL。`logsql_database`および`logsql_table`設定で指定されたログテーブルに対する`SELECT`クエリに変換されます。実験的設定の`enable_logsql_dialect`が必要です。
* `trino` — Trino SQL: Trinoの構文 (`ARRAY[...]`、`TRY_CAST`、`UNNEST`など) を変換し、Trinoの関数名をClickHouseの同等のものにマッピングします。ベータ設定の`enable_trino_dialect`が必要です。

## discard\_query\_data

型

Bool

デフォルト値

0

有効にすると、サーバーはクエリ結果の行をクライアントに送信しなくなります。クエリ自体は引き続き実行され、サーバー上で完全に記録されます。また、クライアントはそれ以外のパケットを引き続き受信します。

シャドートラフィック、ベンチマーク、ファジングで使用します。

セカンダリクエリには影響しません。

ネイティブ TCP プロトコルにのみ適用されます。

## distinct\_overflow\_mode

型

OverflowMode

デフォルト値

throw

データ量がいずれかの上限を超えたときの動作を設定します。

設定可能な値:

* `throw`: 例外をスローします (デフォルト) 。
* `break`: クエリの実行を停止し、データソースが尽きたかのように
  部分的な結果を返します。

## do\_not\_merge\_across\_partitions\_select\_final

型

Bool

デフォルト値

0

異なるパーティション間でのマージを避けることで、FINAL クエリを最適化します。

有効にすると、SELECT FINAL クエリの実行時に、異なるパーティションのパーツがまとめてマージされることはありません。代わりに、マージは各パーティション内でのみ個別に行われます。これにより、パーティション化されたテーブルを扱う際のクエリパフォーマンスを大幅に向上させることができます。

## dynamic\_throw\_on\_type\_mismatch

型

Bool

デフォルト値

1

デフォルト実装を使用して [Dynamic](https://clickhouse.com/docs/ja/reference/data-types/dynamic.md) カラムに関数を適用する際、
実際の型がその関数に適合しない行に対してどのように動作するかを制御します。

* `true` (デフォルト) — 例外をスローします。
* `false` — 代わりに、それらの行では `NULL` を返します。

## enforce\_strict\_identifier\_format

型

Bool

デフォルト値

0

有効にすると、英数字とアンダースコアのみを含む識別子だけが許可されます。

## engine\_url\_skip\_empty\_files

型

Bool

デフォルト値

0

[URL](https://clickhouse.com/docs/ja/reference/engines/table-engines/special/url.md) エンジンのテーブルで空のファイルをスキップするかどうかを有効または無効にします。

設定可能な値:

* 0 — 空のファイルが要求されたフォーマットと互換性がない場合、`SELECT` は例外をスローします。
* 1 — 空のファイルに対して、`SELECT` は空の結果を返します。

## exact\_rows\_before\_limit

型

Bool

デフォルト値

0

有効にすると、ClickHouse は `rows_before_limit_at_least` 統計の正確な値を返しますが、その代わり、limit より前のデータを最後まで完全に読み取る必要があります

## except\_default\_mode

型

SetOperationMode

デフォルト値

ALL

EXCEPTクエリのデフォルトモードを設定します。設定可能な値: 空文字列、'ALL'、'DISTINCT'。空文字列の場合、モードを指定しないクエリは例外を返します。

## exclude\_materialize\_skip\_indexes\_on\_insert

指定したスキップ索引を、INSERT 時の構築および保存の対象から除外します。除外されたスキップ索引は、[マージ中](https://clickhouse.com/docs/ja/reference/settings/merge-tree-settings/materialize.md#materialize_skip_indexes_on_merge)または明示的な
[MATERIALIZE INDEX](https://clickhouse.com/docs/ja/reference/statements/alter/skipping-index.md#materialize-index)クエリによって引き続き構築および保存されます。

[materialize\_skip\_indexes\_on\_insert](https://clickhouse.com/docs/ja/reference/settings/session-settings/materialize.md#materialize_skip_indexes_on_insert) が false の場合、この設定は効果を持ちません。

例:

```sql theme={null}
CREATE TABLE tab
(
    a UInt64,
    b UInt64,
    INDEX idx_a a TYPE minmax,
    INDEX idx_b b TYPE set(3)
)
ENGINE = MergeTree ORDER BY tuple();

SET exclude_materialize_skip_indexes_on_insert='idx_a'; -- idx_a will be not be updated upon insert
--SET exclude_materialize_skip_indexes_on_insert='idx_a, idx_b'; -- neither index would be updated on insert

INSERT INTO tab SELECT number, number / 50 FROM numbers(100); -- only idx_b is updated

-- since it is a session setting it can be set on a per-query level
INSERT INTO tab SELECT number, number / 50 FROM numbers(100, 100) SETTINGS exclude_materialize_skip_indexes_on_insert='idx_b';

ALTER TABLE tab MATERIALIZE INDEX idx_a; -- this query can be used to explicitly materialize the index

SET exclude_materialize_skip_indexes_on_insert = DEFAULT; -- reset setting to default
```

## execute\_exists\_as\_scalar\_subquery

型

Bool

デフォルト値

1

相関しない EXISTS サブクエリをスカラーサブクエリとして実行します。スカラーサブクエリと同様に cache が使用され、結果には定数畳み込みが適用されます。

Cloud でのデフォルト値: `0`.

## explain\_query\_plan\_default

型

ExplainQueryPlanDefault

デフォルト値

pretty

`EXPLAIN PLAN` で使用されるデフォルトのフォーマットです。

設定可能な値:

* `pretty` (26.7 以降のデフォルト) — `actions`、`compact`、`pretty` はデフォルトで `true` となり、コンパクトで見やすく、`actions` の注釈が付いたプランを生成します。
* `legacy` — 26.7 より前の出力。

`EXPLAIN` ステートメントで `actions`、`compact`、または `pretty` オプションを明示的に指定した場合 (たとえば `EXPLAIN actions = 0, compact = 0, pretty = 0 SELECT ...`) 、常にこの設定よりも明示指定の方が優先されます。

`json = 1` または `distributed = 1` を指定した `EXPLAIN PLAN` では、`actions`、`compact`、または `pretty` が明示的に設定されていない限り、この設定に関係なく従来の (26.7 より前の) デフォルトが使われます。pretty 出力では JSON の結果や分片ごとの分散実行プランを表現できないため、これらのモードは `legacy` 形式でのみ正しくレンダリングされます。

## explain\_syntax\_single\_record

型

Bool

デフォルト値

1

`EXPLAIN SYNTAX` の出力を、行ごとに 1 レコードではなく 1 つのレコード (埋め込み改行を含む) として返します。これにより、結果は復元可能な単一の行になります (たとえば、`SELECT count() FROM (EXPLAIN SYNTAX ...)` は `1` を返します) 。

`EXPLAIN SYNTAX` ステートメントで `single_record` オプションを明示的に指定した場合 (たとえば、`EXPLAIN SYNTAX single_record = 0 SELECT ...`) 、この設定より常に優先されます。

26.8 より前の行ごとに 1 レコードを返す出力に戻すには、`false` に設定するか、`compatibility` を `26.8` より前の任意のバージョンに設定します。

## extract\_key\_value\_pairs\_max\_pairs\_per\_row

**別名**: `extract_kvp_max_pairs_per_row`

型

UInt64

デフォルト値

1000

`extractKeyValuePairs` 関数で生成可能なペアの最大数。メモリを過剰に消費しないようにするための保護策として使用されます。

## extremes

型

Bool

デフォルト値

0

極値 (クエリ結果の各カラムにおける最小値と最大値) を計算するかどうかを指定します。0 または 1 を指定できます。デフォルトは 0 (無効) です。
詳細については、「Extreme values」セクションを参照してください。

## fallback\_to\_stale\_replicas\_for\_distributed\_queries

型

Bool

デフォルト値

1

更新済みのデータを利用できない場合、古いレプリカに対してクエリを強制的に実行します。[Replication](https://clickhouse.com/docs/ja/reference/engines/table-engines/mergetree-family/replication.md)を参照してください。

ClickHouse は、テーブルの古いレプリカの中から最も適切なものを選択します。

レプリケートテーブルを参照する分散テーブルに対して `SELECT` を実行する際に使用されます。

デフォルト値は 1 (有効) です。

## file\_like\_engine\_default\_partition\_strategy

型

FileLikeEngineDefaultPartitionStrategy

デフォルト値

hive

ファイル系テーブルエンジンのデフォルトのパーティション方式。glob または `{_partition_id}` プレースホルダーを含まないパスを持つ `CREATE` クエリにのみ適用されます。`{_partition_id}` を含むパスでは常に `wildcard` が使用されます。別の glob を含むパスではパーティション方式は使用されず、`PARTITION BY` は無視されます。この設定が `wildcard` であってもパスに `{_partition_id}` がない場合は、パーティション方式は使用されません。この決定をエンジン引数に永続化できないテーブルエンジン (例: `HDFS`) は、このような `CREATE` を拒否します。

## filesystem\_prefetches\_limit

型

UInt64

デフォルト値

200

prefetch の最大数です。0 は無制限を意味します。prefetch の数を制限したい場合は、設定 `filesystem_prefetches_max_memory_usage` を使用することを推奨します

## filter

クエリをラップするサブクエリとして `WHERE` 句を追加します。複数のフィルターは AND で結合されます。HTTP インターフェイスでは複数の `filter` URL パラメータを指定でき、それらは指定順に AND で結合され、この設定の値とも AND で結合されます。

これは、解析済みクエリにエンジンが適用するクエリ構築設定です (派生テーブルとしてラップします) 。そのため既存のクエリと組み合わせて使用でき、すべてのプロトコルで機能します。HTTP URL パラメータ、クエリ内の `SETTINGS` clause、またはユーザープロファイルで指定できます。

結果を返す `SELECT` / `UNION` クエリの形を変更します。書き込みクエリ (`INSERT … SELECT`、`CREATE … AS SELECT`) では、ソース `SELECT` 自身の `SETTINGS` clauseに指定されている場合にのみ有効です。プロファイルまたはセッションから継承された値、あるいは `INSERT` / `CREATE` ステートメント自体に設定された値は、ソース `SELECT` には伝播しません。これは、他のすべての設定にも適用される非伝播ルールと同じです。

> [!CAUTION]
>
> `filter` はアクセス制御の仕組み**ではなく**、[行レベルセキュリティポリシー](https://clickhouse.com/docs/ja/concepts/features/security/access-rights.md#row-policy-management)や `additional_table_filters` 設定の代替として使用してはなりません。ラップするサブクエリに `WHERE` を追加するだけであるため、フィルターが適用される前に基盤となるデータが読み取られ、処理されます。クエリは処理中にフィルターで除外された行を観測できます (たとえば、`throwIf` を使用してエラーパス経由で情報を漏えいさせることができます) 。ユーザーがアクセスできる行を制限することが目的の場合は、行レベルセキュリティまたは `additional_table_filters` を使用してください。

## final

型

Bool

デフォルト値

0

クエリ内のすべてのテーブルのうち、[FINAL](https://clickhouse.com/docs/ja/reference/statements/select/from.md#final-modifier) を適用できるものに対して、[FINAL](https://clickhouse.com/docs/ja/reference/statements/select/from.md#final-modifier) 修飾子を自動的に適用します。これには、結合されたテーブル、サブクエリ内のテーブル、および分散テーブルが含まれます。

設定可能な値:

* 0 - 無効
* 1 - 有効

例:

```sql theme={null}
CREATE TABLE test
(
    key Int64,
    some String
)
ENGINE = ReplacingMergeTree
ORDER BY key;

INSERT INTO test FORMAT Values (1, 'first');
INSERT INTO test FORMAT Values (1, 'second');

SELECT * FROM test;
┌─key─┬─some───┐
│   1 │ second │
└─────┴────────┘
┌─key─┬─some──┐
│   1 │ first │
└─────┴───────┘

SELECT * FROM test SETTINGS final = 1;
┌─key─┬─some───┐
│   1 │ second │
└─────┴────────┘

SET final = 1;
SELECT * FROM test;
┌─key─┬─some───┐
│   1 │ second │
└─────┴────────┘
```

## finalize\_projection\_parts\_synchronously

型

Bool

デフォルト値

0

有効にすると、INSERT 中にプロジェクションパーツが同期的にファイナライズされ、S3 アップロードの並列度は下がるものの、ピークメモリ使用量を削減できます。デフォルトでは、各プロジェクションの出力ストリームは、パーツ全体 (すべてのプロジェクションを含む) のファイナライズが完了するまで維持されます。これにより S3 アップロードを並行して実行できますが、ピークメモリはプロジェクション数に比例して増加します。この設定が影響するのは INSERT パスのみで、merge と mutation ではすでにプロジェクションが同期的にファイナライズされます。

## flatten\_nested

型

Bool

デフォルト値

1

[nested](https://clickhouse.com/docs/ja/reference/data-types/nested-data-structures/index.md)カラムのデータフォーマットを指定します。

設定可能な値:

* 1 — Nested カラムは個別の配列にフラット化されます。
* 0 — Nested カラムは単一のタプル配列のまま保持されます。

**使用法**

この設定を `0` にすると、任意のレベルのネストを使用できます。

**例**

クエリ:

```sql theme={null}
SET flatten_nested = 1;
CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();

SHOW CREATE TABLE t_nest;
```

結果:

```text theme={null}
┌─statement───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
    `n.a` Array(UInt32),
    `n.b` Array(UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
```

クエリ:

```sql theme={null}
SET flatten_nested = 0;

CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();

SHOW CREATE TABLE t_nest;
```

結果:

```text theme={null}
┌─statement──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
    `n` Nested(a UInt32, b UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
```

## format

クエリの入力と出力の両方の `FORMAT` をオーバーライドします。クエリまたはファイル拡張子で指定されたフォーマットよりも優先されます。より具体的な `input_format` および `output_format` 設定は、それぞれ入力と出力について、この汎用的な `format` 設定より優先されます。

## framing\_output\_format

[ベータ機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

型

String

デフォルト値

None

クエリ応答のさまざまな部分を単一ストリームに多重化できます。データの chunk、totals と extremes、progress パケット、profile events (メトリクス) 、サーバーログなど、ネイティブプロトコルがサポートするすべてが対象です。

フレーミングフォーマットは出力フォーマットとは独立しています。任意の出力フォーマットで生成されたバイトを、そのバイト列の chunk を分離し、必要に応じてエンコードすることでカプセル化します。すべての `data`、`totals`、`extremes` パケットのペイロードを連結したものは、フレーミングなしで出力フォーマットが生成する内容と完全に一致します。補助パケット (progress、ログ、profile events、exceptions) は JSON で表現されます。

意図的な例外が 1 つあります。totals と extremes を表現できないため通常の出力では省略する出力フォーマット (`JSONCompactEachRow` ファミリー) は、フレーミング使用時には `totals` および `extremes` パケットにそれらを出力します。このようなフォーマットでは、`data` パケットのみを連結したものがフレーミングなしの出力と完全に一致し、`totals` および `extremes` パケットにはフレーミングなしの出力には含まれない追加の行が格納されます。

サーバーログは `send_logs_level` 設定が指定されている場合に含まれ、profile events は `send_profile_events` 設定が有効な場合に含まれます (これらは `interactive_delay` マイクロ秒ごとに最大 1 回送信され、progress パケットも `interactive_delay` によりスロットリングされます) 。

成功したストリームは、ネイティブプロトコルの最終 progress パケットと同様に、クエリ終了時のロギングで出力される末尾の `log` および `profile_events` パケットの後に書き込まれる、最終カウンター (`result_rows`、`result_bytes`、`memory_usage`) を含む最終 `progress` パケットで終了します。失敗時には、`exception` パケットが最後のパケットになります。ただし、パケットストリームの一部がすでに応答として出力され、破棄できなくなった後に失敗が発生した場合は例外です (パケット書き込みが途中で失敗した場合、`exception` パケット自体の配信に失敗した場合、またはフラッシュやクローズ中に応答ストリームが失敗した場合) 。この場合、フレーミングはフェイルクローズとなります。つまり、ストリームは終端 `exception` パケットなしで終了し、クライアントには解析可能な終端パケットではなく、切り詰められた応答と中断された HTTP 接続が示されます。部分的なパケットストリームの後に何かが追加されることはないため、通常の HTTP エラー本文がそこに混在することはありません。

クエリが自身の `SETTINGS` clause によってのみ有効化するもの (フレーミングフォーマット、`send_logs_level`、`send_profile_events`) は、クエリがパースされるまで判明しません。そのため、対応するログおよび profile events はクエリ実行以降でのみキャプチャされます。パース、プラン、分析フェーズのログおよび profile events は、設定がセッションまたは URL で指定されている場合にのみキャプチャされます。たとえば、分析中に失敗するクエリ (未知のテーブルへの参照など) で、`SETTINGS` clause 内でのみ `send_logs_level` を有効にした場合、分析フェーズのログではなく `exception` パケットのみが配信されます。これらをキャプチャするには、セッションまたは URL で `send_logs_level` を設定してください。

同じ検出タイミングに関する注意点は `send_logs_source_regexp` にも適用されます。ログキューは各エントリがキャプチャされた時点でソースに基づいてエントリをフィルタリングするため、クエリ自身の `SETTINGS` clause でのみ設定された正規表現は、クエリ実行以降でのみ有効になります。パース、プラン、分析フェーズの `log` パケットは設定のセッションまたは URL の値でフィルタリングされます (そこで設定されていない場合はフィルタリングされません) 。そのため、クエリレベルの正規表現に一致しないソースが含まれる場合があります。反対に、より限定的なセッションまたは URL の正規表現によって除外されたエントリは、より広範なクエリレベルの正規表現によって復元されません。クエリのライフサイクル全体をフィルタリングするには、セッションまたは URL で `send_logs_source_regexp` を設定してください。

この設定は現在 HTTP プロトコルに適用され、その他のインターフェイスでは無視されます。

設定可能な値:

* `None` - 該当するもの (data、totals、extremes、progress) をすべて出力フォーマットにそのまま渡し、該当しないもの (メトリクス、ログ) はすべて無視します。そのため、デフォルトでは従来どおり動作します。
* `EventStream` - パケットを HTTP のサーバー送信イベント (`text/event-stream`) としてフレーミングします。各パケットは、対応する名前 (`data`、`totals`、`extremes`、`progress`、`log`、`profile_events`、`exception`) を持つイベントとして送信されます。progress およびその他の補助パケットは JSON として送信されます。サーバー送信イベントは、改行 (キャリッジリターン `\r` を含む) を区切り文字として扱うテキストプロトコルであるため、整形済みデータのブロックはイベントの単一の `data` フィールドに base64 エンコードされます。デコードすると、すべての改行を含む完全に整形されたペイロードになります。これを示すため、`Content-Type` には `payload=base64` パラメータが含まれます。この方法では、テキスト形式・バイナリ形式を問わず、任意の出力フォーマットをバイト単位で正確に転送できます。
* `JSONEachPacketBase64` - 各パケットは1行ごとの JSON オブジェクトであり、整形済みデータは base64 エンコードされます。例: `{"packet":"data","data":"eyJ4IjoxfQo="}`。バイナリ出力フォーマットに適しています。
* `JSONEachPacketString` - 各パケットは1行ごとの JSON オブジェクトであり、整形済みデータは文字列に格納されます。例: `{"packet":"data","data":"{\"x\":1}\n"}`。

`JSONEachPacketString` は、ペイロードのバイトを検証または再エンコードせずに JSON 文字列に格納します。`String` および `FixedString` カラムには任意のバイトを格納できるため、テキスト出力フォーマット (`JSONEachRow`、`TSV`、`CSV` など) は、このような値に対して無効な UTF-8 を出力する場合があります。これは、デフォルトの `output_format_json_validate_utf8 = 0` を使用した場合の ClickHouse 自身の `JSONEachRow` と同様です。そのため、生成される NDJSON ストリームが有効な UTF-8 であることは保証されません。任意のバイトをバイト単位で正確に転送するには、`JSONEachPacketBase64` を使用してください。

例:

```bash theme={null}
curl "http://localhost:8123/?framing_output_format=JSONEachPacketString" -d "SELECT number FROM numbers(3) FORMAT JSONEachRow"
```

結果：

```text theme={null}
{"packet":"data","data":"{\"number\":\"0\"}\n{\"number\":\"1\"}\n{\"number\":\"2\"}\n"}
{"packet":"profile_events","profile_events":[{"host_name":"localhost","current_time":"2026-07-11 00:00:00","thread_id":"0","type":"increment","name":"SelectedRows","value":"3"}]}
{"packet":"progress","progress":{"read_rows":"3","read_bytes":"24","total_rows_to_read":"3","result_rows":"3","result_bytes":"24","elapsed_ns":"1265958"}}
```

## fsync\_metadata

型

Bool

デフォルト値

1

`.sql` ファイルの書き込み時に [fsync](http://pubs.opengroup.org/onlinepubs/9699919799/functions/fsync.html) を有効または無効にします。デフォルトでは有効です。

server に、作成と削除が絶えず行われる非常に小さな table が数百万ある場合は、これを無効にするのが適切です。

## functions\_h3\_default\_if\_invalid

型

Bool

デフォルト値

0

false の場合、h3 関数 (例: h3CellAreaM2) は入力が無効であれば例外を発生させます。true の場合は、0 またはデフォルト値を返します。

## geo\_distance\_returns\_float64\_on\_float64\_arguments

型

Bool

デフォルト値

1

`geoDistance`、`greatCircleDistance`、`greatCircleAngle` 関数の4つの引数がすべて Float64 の場合、戻り値は Float64 となり、内部計算には倍精度が使用されます。以前の ClickHouse バージョンでは、これらの関数は常に Float32 を返していました。

## geotoh3\_argument\_order

[ベータ機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

型

GeoToH3ArgumentOrder

デフォルト値

lat\_lon

Function 'geoToH3' は、'lon\_lat' に設定すると (lon, lat) を、'lat\_lon' に設定すると (lat, lon) を受け入れます。

## get\_zookeeper\_lock\_acquire\_timeout\_ms

型

Milliseconds

デフォルト値

120000

クエリが Keeper クライアントを待機する時間(ミリ秒)を定義します。対象となるのは、クライアントの `Context` のミューテックスの取得と、別のスレッドがそのクライアントのために行っている接続試行の完了です。この時間を超えると、クエリは `TIMEOUT_EXCEEDED` で失敗します。また、クエリがキャンセルされた場合も待機を終了します。

この値はクエリコンテキストから読み取られるため、クエリコンテキストを使用する操作に適用されます。たとえば、`system.zookeeper` からの読み取り、`zookeeperSessionUptime`、`SYSTEM RECONNECT ZOOKEEPER`、クエリコンテキストからの補助 Keeper へのアクセスなどが該当します。
`BACKUP` および `RESTORE` の協調処理や `Replicated` データベースの処理など、グローバルコンテキストまたはバックグラウンドコンテキストを使用する操作では、接続試行が終了するまで待機し、その試行で得られたクライアント、または Keeper エラーを受け取ります。
`SYSTEM RELOAD CONFIG` および `SYSTEM RELOAD ASYNCHRONOUS METRICS` は、それぞれ独立してシリアル化されたリロードパスを使用するため、この設定の対象外です。

設定可能な値:

* 正の整数(ミリ秒単位)。
* 0 — ロック取得のタイムアウトなし。

## glob\_expansion\_max\_elements

型

UInt64

デフォルト値

1000

許可されるアドレス数の上限 (external storage、テーブル関数 など) 。

`url` テーブル関数および `URL` テーブルエンジンは、パターンに該当するアドレスを 1 つずつ生成します。そのため、これらの場合にこの設定で制限されるのは、パターンの大きさではなく、1 つのクエリで生成できるアドレスの数です。`LIMIT` などによって途中で終了するクエリであれば、この値よりもはるかに多くのアドレスを表すパターンを使用できます。`_path` や `_file` に対する述語は生成されたすべてのアドレスに適用されるため、述語によって除外されたアドレスも数に含まれます。

## h3togeo\_lon\_lat\_result\_order

型

Bool

デフォルト値

0

関数 'h3ToGeo' は、true の場合は (lon, lat)、それ以外の場合は (lat, lon) を返します。

## handshake\_timeout\_ms

型

Milliseconds

デフォルト値

10000

ハンドシェイク中にレプリカから Hello パケットを受信するまでのタイムアウト (ミリ秒) 。

## hedged\_connection\_timeout\_ms

型

Milliseconds

デフォルト値

50

ヘッジドリクエストでレプリカとの接続を確立する際の接続タイムアウト

## highlight\_max\_matches\_per\_row

型

UInt64

デフォルト値

10000

[highlight](https://clickhouse.com/docs/ja/reference/functions/regular-functions/string-search-functions.md#highlight) 関数で、1行あたりのハイライト一致数の最大値を設定します。大きなテキスト内で繰り返しの多いパターンをハイライトする際に、過剰なメモリ使用量を防ぐために使用します。

設定可能な値:

* 正の整数。

## hnsw\_candidate\_list\_size\_for\_search

型

UInt64

デフォルト値

256

ベクトル類似度索引の検索時に使用される動的な候補リストのサイズです。`ef_search` とも呼ばれます。

## hsts\_max\_age

型

UInt64

デフォルト値

0

HSTS の有効期限です。0 は HSTS を無効にします。

## idle\_connection\_timeout

型

UInt64

デフォルト値

3600

アイドル状態の TCP 接続を、指定した秒数経過後に切断するまでのタイムアウトです。

設定可能な値:

* 正の整数 (0 の場合は 0 秒後、つまり即座に切断されます) 。

## inject\_random\_order\_for\_select\_without\_order\_by

型

Bool

デフォルト値

0

有効にすると、ORDER BY clause を持たない SELECT クエリに 'ORDER BY rand()' を挿入します。
適用されるのはサブクエリの深さが 0 の場合のみです。サブクエリおよび INSERT INTO ... SELECT は対象外です。
最上位の構造が UNION の場合、'ORDER BY rand()' はすべての child に個別に挿入されます。
ORDER BY がないとクエリ結果が非決定論的になるため、主にテストや開発でのみ有用です。

## input\_format

クエリの入力フォーマットをオーバーライドします。クエリで指定されたフォーマットよりも優先されます。

## interactive\_delay

型

UInt64

デフォルト値

100000

リクエストの実行がキャンセルされたかどうかを確認し、Progressを送信する間隔をマイクロ秒単位で指定します。

## intersect\_default\_mode

型

SetOperationMode

デフォルト値

ALL

INTERSECTクエリのデフォルトモードを設定します。設定可能な値: 空文字列、'ALL'、'DISTINCT'。空の場合、モードを指定しないクエリでは例外がスローされます。

## json\_extract\_named\_tuples\_as\_objects

型

Bool

デフォルト値

0

`JSONExtract` ファミリーの関数において、名前付きタプルを JSON オブジェクトからのみ補完します。無効の場合は、従来どおり JSON配列から名前付きタプルが位置依存で補完されます。そのため、どの配列要素がどの名前付きフィールドに入るかは、タプルの宣言順序によって決まります。名前なしタプルは、この設定にかかわらず常に配列から位置依存で補完されます。

この設定は、文字列として渡される JSON に適用されます。`JSON` データ型のカラムからの抽出は、型指定されたパスか型指定されていないパスかを問わず影響を受けません。この抽出は JSON ドキュメントをパースせずにカラムのサブカラムを読み取るため、この設定が制御するコードを通らないからです。JSON入力形式における名前付きタプルの*カラム*は、別の設定である [input\_format\_json\_named\_tuples\_as\_objects](https://clickhouse.com/docs/ja/reference/settings/formats/input-format.md#input_format_json_named_tuples_as_objects) で制御されます。この設定の対象は抽出関数のみです。

デフォルトでは無効です。

## kill\_throw\_if\_noop

型

Bool

デフォルト値

1

[`KILL QUERY`](https://clickhouse.com/docs/ja/reference/statements/kill#kill-query) および [`KILL MUTATION`](https://clickhouse.com/docs/ja/reference/statements/kill#kill-mutation) の `WHERE` 句に一致する行が 1 件もない場合に、例外をスローするかどうかを制御します。

デフォルトで有効です。`KILL QUERY` は、実行中の `KILL` ステートメント自体を除いて `system.processes` に対象となる行がない場合に例外をスローします。同様に、`KILL MUTATION` は `system.mutations` に一致する行がない場合に例外をスローします。`false` に設定すると、一致する行がなくても例外は発生しません。`TEST` によるドライランでは、例外をスローせずに空のプレビューを返します。`ON CLUSTER` で実行した場合は、一致結果がホスト間で集計されないため、一致する行がなくても例外はスローされません。

設定可能な値:

* 1 — 例外をスローします。
* 0 — 例外をスローしません。

## least\_greatest\_legacy\_null\_behavior

型

Bool

デフォルト値

0

有効にすると、関数 'least' と 'greatest' は、いずれかの引数が NULL の場合に NULL を返します。

## legacy\_array\_join\_function\_nondeterministic\_evaluation

型

Bool

デフォルト値

0

`arrayJoin` 関数と併用される非決定論的関数およびブロック依存の関数の評価方法を制御します。デフォルトでは、`ARRAY JOIN` 句の場合と同様に、`rand()` は出力行ごとに異なる値を返し、`runningDifference` や `neighbor` は展開後のブロックを参照します。有効にすると旧バージョンと同じ動作になります。

## legacy\_column\_name\_of\_tuple\_literal

型

Bool

デフォルト値

0

ハッシュではなく、大きなタプルリテラルの要素名をすべてカラム名として列挙します。この設定は互換性のためにのみ存在します。バージョン 21.7 未満から 21.7 以上へクラスターをローリングアップデートする際は、'true' に設定するのが適切です。

## legacy\_join\_size\_limits\_trigger\_spilling

型

Bool

デフォルト値

0

スピルのしきい値がトリガーになる以前の `max_rows_in_join` および `max_bytes_in_join` の動作を、結合のうちディスク上で実行される部分について復元します。すなわち、いずれかに達した時点でクエリを停止するのではなく、結合がさらにスピルするようになります。
この場合、`join_algorithm = 'grace_hash'` はこの 2 つだけを基準にスピルし、`max_bytes_before_external_join` は 0 を含めて完全に無視します。`hash` / `parallel_hash` は引き続きスピルのしきい値でディスクへ移行し、その後はいずれか一方に達した時点でスピルします。これらのインメモリフェーズでは、従来どおりこの 2 つを厳格な上限として扱います。

これら 2 つの設定の以前の意味を前提に書かれたクエリ向けの設定で、`compatibility` によって自動的に有効になります。

この設定が導入される前のバージョンのサーバーは旧来の意味を適用し、それを変更することはできません。そのため `serialize_query_plan = 1` の場合、スピル動作が新しい意味に依存する結合は、そのようなサーバーへは一切送信されません。異なる取り決めのまま暗黙のうちに実行されるのではなく、クエリが失敗します。この設定を有効にすると、両側で旧来の意味が適用され、これらのクエリが 2 つのバージョン間で動作するようになります。

## limit

型

Double

デフォルト値

0

クエリ結果から取得する最大行数を設定します。[LIMIT](https://clickhouse.com/docs/ja/reference/statements/select/limit.md)句で設定された値を調整します。この値は`LIMIT`にそのまま渡されるため、負の値 (結果の末尾から数える) や`(0, 1)`の小数 (結果に対する割合として解釈される) を含め、`LIMIT`で受け付けられるすべての値を指定できます。

設定可能な値:

* 0 — 行数は制限されません。
* 正の整数 — 指定した行数。
* 負の整数 — 末尾からN行を返します。
* 開区間`(0, 1)`内の実数 — 結果のその割合を返します。

この設定は、結果を返す`SELECT` / `UNION`クエリに適用されます。書き込みクエリ (`INSERT … SELECT`、`CREATE … AS SELECT`) では、ソースの`SELECT`が自身の`SETTINGS` clauseでこの設定を指定している場合にのみ有効です。プロファイルまたはセッションから継承された値、あるいは`INSERT` / `CREATE`ステートメント自体に設定された値は、ソースの`SELECT`には伝播されません。これは、他のすべての設定にも適用される非伝播ルールと同じです。

## load\_marks\_asynchronously

型

Bool

デフォルト値

1

MergeTree の marks をバックグラウンドの thread pool (server setting `load_marks_threadpool_pool_size` を参照) で非同期に読み込み、すべての ストリーム の marks を並列に読み込みます。無効な場合は、marks は ストリーム ごとに順番に同期的に読み込まれるため、`JSON` のように多数の substreams を持つカラムではリモートディスク上で処理が遅くなります。

## lock\_acquire\_timeout

型

Seconds

デフォルト値

120

ロックのリクエストが失敗するまでに待機する秒数を定義します。

このロックタイムアウトは、テーブル に対する読み取り/書き込み操作の実行中にデッドロックを防ぐために使用されます。タイムアウトに達してロックのリクエストが失敗すると、ClickHouse サーバー は例外 `"Locking attempt timed out. Possible deadlock avoided. Client should retry."` をスローし、エラーコード `DEADLOCK_AVOIDED` を返します。

設定可能な値:

* 正の整数 (秒単位) 。
* 0 — ロックタイムアウトなし。

## low\_priority\_query\_wait\_time\_ms

[ベータ機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

型

Milliseconds

デフォルト値

1000

クエリの優先度付けの仕組みが使用されている場合 (設定 `priority` を参照) 、低優先度のクエリは高優先度のクエリが完了するまで待機します。この設定では、その待機時間を指定します。

## make\_distributed\_plan

プライベートプレビュー

型

Bool

デフォルト値

0

分散クエリプランを生成します。

有効にすると、分散クエリプランでまだサポートされていない機能を制御する設定が自動的に調整されます。

* `enable_parallel_replicas = 0` および `automatic_parallel_replicas_mode = 0` — 分散プランが処理を独自に分散します。
* `correlated_subqueries_use_in_memory_buffer = 0`;
* `compile_expressions = 0`;
* `query_plan_direct_read_from_text_index = 0`.

## merge\_table\_max\_tables\_to\_look\_for\_schema\_inference

型

UInt64

デフォルト値

1000

明示的なスキーマを指定せずに `Merge` テーブルを作成する場合、または `merge` テーブル関数を使用する場合、スキーマは指定した数以下の一致するテーブルのスキーマのユニオンとして推論されます。
テーブル数がそれを超える場合は、先頭から指定した数のテーブルに基づいてスキーマが推論されます。

## mongodb\_throw\_on\_unsupported\_query

型

Bool

デフォルト値

1

有効な場合、MongoDBクエリを構築できないとき、MongoDBテーブルはエラーを返します。無効な場合、ClickHouse はテーブル全体を読み込み、ローカルで処理します。

## multiple\_joins\_try\_to\_keep\_original\_names

型

Bool

デフォルト値

0

複数の JOIN の書き換え時に、最上位の式リストへ別名を追加しない

## normalize\_function\_names

型

Bool

デフォルト値

1

関数名を標準名に正規化します

## obfuscate\_seed

`obfuscate` テーブル関数で使用する seed です。任意の文字列を指定でき、各カラムの seed はこの値とカラム名から導出されます。そのため、同じ seed からは常に同じ難読化結果が得られます。空文字列を指定すると、クエリごとに乱数シードが生成されます。

この seed は通常の設定であり、シークレットではありません。値は他の設定と同様に平文で保存・表示されます (`system.query_log` や `system.settings` など)。パスワードなどのシークレットを seed として使用しないでください。異なるクエリの難読化された出力同士を関連付けられないようにする必要がある場合は、固定の seed を設定せず、デフォルトの空の値 (クエリごとに新しい乱数シードを生成) のままにしてください。

## offset

型

Double

デフォルト値

0

クエリ結果の行を返し始める前にスキップする行数を設定します。[OFFSET](https://clickhouse.com/docs/ja/reference/statements/select/offset.md) 句で設定したオフセットを調整します。この値は `OFFSET` にそのまま渡され、負の値や `(0, 1)` の範囲の小数を含め、`OFFSET` で受け付けられるすべての値を指定できます。

設定可能な値:

* 0 — 行をスキップしません。
* 正の整数。
* 負の整数。
* 開区間 `(0, 1)` の実数 — 結果のその割合をスキップします。

**例**

入力テーブル:

```sql theme={null}
CREATE TABLE test (i UInt64) ENGINE = MergeTree() ORDER BY i;
INSERT INTO test SELECT number FROM numbers(500);
```

クエリ：

```sql theme={null}
SET limit = 5;
SET offset = 7;
SELECT * FROM test LIMIT 10 OFFSET 100;
```

結果：

```text theme={null}
┌───i─┐
│ 107 │
│ 108 │
│ 109 │
└─────┘
```

この設定は、結果を返す `SELECT` / `UNION` クエリに影響します。書き込みクエリ (`INSERT … SELECT`、`CREATE … AS SELECT`) では、ソースの `SELECT` 自身の `SETTINGS` 句でこの設定が指定されている場合にのみ有効です。プロファイルまたはセッションから継承された値や、`INSERT` / `CREATE` ステートメント自体に設定された値は、ソースの `SELECT` には伝播しません。これは、他のすべての設定にも適用される非伝播ルールと同じです。

## order

クエリをラップするサブクエリとして、`ORDER BY` 句を追加します。任意の式のリストを指定できます。

これは、パース済みクエリに対してエンジンが適用するクエリ構築用の設定です (クエリを派生テーブルとしてラップします) 。既存のクエリと組み合わせて使用でき、すべてのプロトコルで機能します。HTTP URL パラメータ、クエリ内の `SETTINGS` 句、またはユーザープロファイルで指定できます。

結果を返す `SELECT` / `UNION` クエリの形を変更します。書き込みクエリ (`INSERT … SELECT`、`CREATE … AS SELECT`) では、ソースの `SELECT` 自身の `SETTINGS` 句で指定した場合にのみ有効です。プロファイルまたはセッションから継承した値、あるいは `INSERT` / `CREATE` ステートメント自体に設定した値は、ソースの `SELECT` には伝播しません。これは、他のすべての設定にも適用される非伝播ルールと同じです。

## output\_format

クエリの出力フォーマットを上書きします。クエリ、ファイル拡張子、または `default_format` で指定されたフォーマットよりも優先されます。

## ページ

型

Double

デフォルト値

0

ページネーションされた結果のページ番号を設定します。`offset = limit * (page - 1)` と同等です。`limit` が設定されており、`offset` が設定されていない場合にのみ指定できます。ページ番号は 1 から始まります。`limit` および `offset` と同様に、負の値と小数値をサポートします。

これは、解析済みクエリに対してエンジンが適用するクエリ構築用の設定です (クエリを派生テーブルとしてラップします) 。そのため、既存のクエリと組み合わせて使用でき、すべてのプロトコルで機能します。HTTP URL パラメータ、クエリ内の `SETTINGS` 句、またはユーザープロファイルで指定できます。

結果を返す `SELECT` / `UNION` クエリの形を決定します。書き込みクエリ (`INSERT … SELECT`、`CREATE … AS SELECT`) では、ソース `SELECT` 自体の `SETTINGS` 句にこの設定が指定されている場合にのみ有効です。プロファイルまたはセッションから継承された値、あるいは `INSERT` / `CREATE` ステートメント自体に設定された値は、ソース `SELECT` には伝播しません。これは、ほかのすべての設定にも適用される非伝播ルールと同じです。

## paimon\_target\_snapshot\_id

[実験的な機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#experimental-features)

型

Int64

デフォルト値

-1

Paimon のインクリメンタルモードにおける、クエリレベルで特定のスナップショットを対象にした読み取りです。>0 の場合、リーダーはコミット済みのウォーターマークを進めずに、指定した snapshot\_id の差分のみを取得します。
デフォルト: -1 (無効)

## parallelize\_output\_from\_storages

型

Bool

デフォルト値

1

ストレージからの読み取りステップの出力を並列化します。これにより、可能な場合はストレージからの読み取り直後にクエリ処理を並列化できます。

## partial\_result\_on\_first\_cancel

型

Bool

デフォルト値

0

キャンセル後でも、クエリが部分的な結果を返せるようにします。

## per\_part\_index\_stats

型

Bool

デフォルト値

0

各パートの索引統計をログに記録します

## poll\_interval

型

UInt64

デフォルト値

10

サーバー側のクエリ待機ループを、指定した秒数だけブロックします。

## polyglot\_dialect

[実験的な機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#experimental-features)

polyglotトランスパイラの変換元SQL方言 (例: 'sqlite', 'mysql', 'postgresql', 'snowflake', 'duckdb') 。

## postgresql\_fault\_injection\_probability

型

Float

デフォルト値

0

内部 (レプリケーション用) の PostgreSQL クエリが失敗するおおよその確率です。有効な値の範囲は \[0.0f, 1.0f] です

## predicate\_statistics\_sample\_rate

型

UInt64

デフォルト値

0

述語の選択性統計を `system.predicate_statistics_log` に収集します。N > 0 に設定すると、クエリ ID に基づいて、クエリのおよそ 1/N がサンプリングされます。0 は無効を意味します。

## prefetch\_buffer\_size

型

UInt64

デフォルト値

1048576

filesystem から読み込むための prefetch バッファの最大サイズです。読み取りバッファをそれ以上大きくする必要はないため、256 MiB を超える値は 256 MiB に制限されます。

## print\_pretty\_type\_names

型

Bool

デフォルト値

1

`DESCRIBE` クエリおよび `toTypeName()` 関数で、深くネストされた型名をインデント付きで見やすく表示できるようにします。

例:

```sql theme={null}
CREATE TABLE test (a Tuple(b String, c Tuple(d Nullable(UInt64), e Array(UInt32), f Array(Tuple(g String, h Map(String, Array(Tuple(i String, j UInt64))))), k Date), l Nullable(String))) ENGINE=Memory;
DESCRIBE TABLE test FORMAT TSVRaw SETTINGS print_pretty_type_names=1;
```

```
a   Tuple(
    b String,
    c Tuple(
        d Nullable(UInt64),
        e Array(UInt32),
        f Array(Tuple(
            g String,
            h Map(
                String,
                Array(Tuple(
                    i String,
                    j UInt64
                ))
            )
        )),
        k Date
    ),
    l Nullable(String)
)
```

## priority

型

UInt64

デフォルト値

0

クエリの優先度。1 が最も高く、値が大きいほど優先度は低くなります。0 は優先度を使用しません。

## push\_external\_roles\_in\_interserver\_queries

型

Bool

デフォルト値

1

クエリ実行時に、ユーザーロールをクエリの発行元から他のノードへプッシュすることを有効にします。

## qbit\_one\_bit\_symmetric\_distance

型

Bool

デフォルト値

0

`QBit` の距離関数 (`L2DistanceTransposed`、`cosineDistanceTransposed`、`dotProductTransposed`、およびそれぞれの `...Quantized` 版) が精度 1 で呼び出された場合に、参照ベクトルもその要素の符号に縮約し、2 つの符号ベクトル間のハミング距離 (XOR と popcount で計算) から結果を求めます。

デフォルトでは、精度 1 の場合でも参照ベクトルは元の精度を保持し、格納されたベクトルのみが符号に縮約されます (非対称距離)。対称距離は数倍高速ですが、参照ベクトルの要素の大きさは考慮されません。つまり、参照ベクトルの値が大きい次元も、ゼロに近い次元も同じ重みで扱われます。

## query\_condition\_cache\_time\_condition\_grid\_factor

型

Float

デフォルト値

1

`MergeTree` テーブルの[クエリ条件キャッシュ](https://clickhouse.com/docs/ja/concepts/features/performance/caches/query-condition-cache.md)で現在時刻を含む条件を扱う場合([`use_query_condition_cache_for_time_conditions`](https://clickhouse.com/docs/ja/reference/settings/session-settings/use-query#use_query_condition_cache_for_time_conditions) を参照)に、時刻定数を丸める際のグリッドのサイズを、定数と現在時刻との距離に対する割合で指定します。例えば、デフォルトの係数 1.0 では、`WHERE time >= now() - INTERVAL 10 DAY` の定数は 1 日単位のグリッドに丸められ(上限は 1 日)、`WHERE time >= now() - INTERVAL 1 HOUR` の定数は 1 時間単位のグリッドに丸められます。

値を小さくすると、導出される条件が元の条件に近づき、境界付近での over-read が減りますが、その分キャッシュキーが切り替わる頻度が高くなります。グリッドのステップは最小 1 秒に制限されるため、係数を小さくしても導出が無効化されることはなく、導出される条件が元の条件に収束していきます。0 以下の値を指定すると、導出は完全に無効化されます。

## query\_metric\_log\_interval

型

Int64

デフォルト値

-1

個々のクエリに対する [query\_metric\_log](https://clickhouse.com/docs/ja/reference/system-tables/query_metric_log.md) の収集間隔 (ミリ秒単位) です。

負の値を指定すると、[query\_metric\_log setting](https://clickhouse.com/docs/ja/reference/settings/server-settings/settings/query.md#query_metric_log) の `collect_interval_milliseconds` の値が使用され、存在しない場合はデフォルトで 1000 になります。

単一のクエリの収集を無効にするには、`query_metric_log_interval` を 0 に設定します。

デフォルト値: -1

## queue\_max\_wait\_ms

型

Milliseconds

デフォルト値

0

同時実行リクエスト数が最大値を超えた場合に、リクエストキュー内で待機する時間です。

## rabbitmq\_max\_wait\_ms

型

Milliseconds

デフォルト値

5000

再試行前にRabbitMQから読み取る際の待機時間。

## readonly

型

UInt64

デフォルト値

0

0 - 読み取り専用に関する制限はありません。1 - 閲覧リクエストのみ許可され、明示的に許可された設定の変更も可能です。2 - 閲覧リクエストのみ許可され、'readonly' 設定を除く設定の変更も可能です。

`readonly = 1` の状態で `readonly` 自体を変更可能にしないでください。変更可能にすると、同じ制約で `0` も禁止していない限り、session で `SET readonly = 0` を実行してこの設定を解除できてしまいます。詳しくは[設定に対する制約](https://clickhouse.com/docs/ja/concepts/features/configuration/settings/constraints-on-settings.md#readonly-changeable-in-readonly)を参照してください。

## recursive\_cte\_max\_steps\_in\_type\_inference

型

UInt64

デフォルト値

10

recursive CTE のカラム型を推論する際の最大反復回数です。カラム型は、収束するまで、UNION ALL の非再帰側と再帰側に対して `getLeastSupertype` を繰り返し適用することで決定されます。0 に設定すると型の拡張が無効になり、非再帰部分の型のみが使用されます。

## regexp\_max\_matches\_per\_row

型

UInt64

デフォルト値

1000

1行あたり、単一の正規表現に対する最大一致数を設定します。[extractAllGroupsHorizontal](https://clickhouse.com/docs/ja/reference/functions/regular-functions/string-search-functions.md#extractAllGroupsHorizontal) 関数で貪欲な正規表現を使用する際のメモリ過負荷を防ぐために使用します。

設定可能な値:

* 正の整数。

## reject\_expensive\_hyperscan\_regexps

型

Bool

デフォルト値

1

hyperscan での評価コストが高くなる可能性が高いパターンを拒否します (NFA の状態爆発が原因)

## remerge\_sort\_lowered\_memory\_bytes\_ratio

型

Float

デフォルト値

2

remerge 後のメモリ使用量がこの比率まで減少しない場合、remerge は無効になります。

## remote\_read\_min\_bytes\_for\_seek

型

UInt64

デフォルト値

4194304

ignore を伴う読み取りではなく seek を行うために、リモート読み取り (url、S3) で必要な最小バイト数。

## rename\_files\_after\_processing

* **型:** String

* **デフォルト値:** 空文字列

この設定では、`file` テーブル関数で処理したファイルのリネームパターンを指定できます。このオプションを設定すると、`file` テーブル関数で読み取られたすべてのファイルは、処理が正常に完了した場合に限り、プレースホルダーを含む指定のパターンに従ってリネームされます。

リネームはソースへの書き込みであるため、このオプションを設定してファイルを読み取るクエリには、`READ ON FILE` に加えて `WRITE ON FILE` 権限が必要です。`DESCRIBE` はリネームを行うデータ読み取りパイプラインを構築しないため、`READ ON FILE` のみが必要です。

### プレースホルダー

* `%a` — 元の完全なファイル名 (例: "sample.csv") 。
* `%f` — 拡張子を除いた元のファイル名 (例: "sample") 。
* `%e` — ドット付きの元のファイル拡張子 (例: ".csv") 。
* `%t` — タイムスタンプ (マイクロ秒単位) 。
* `%%` — パーセント記号 ("%") 。

### 例

* オプション: `--rename_files_after_processing="processed_%f_%t%e"`

* クエリ: `SELECT * FROM file('sample.csv')`

`sample.csv` の読み取りに成功すると、ファイル名は `processed_sample_1683473210851438.csv` に変更されます

## replication\_wait\_for\_inactive\_replica\_timeout

型

Int64

デフォルト値

120

非アクティブなレプリカが [`ALTER`](https://clickhouse.com/docs/ja/reference/statements/alter/index)、[`OPTIMIZE`](https://clickhouse.com/docs/ja/reference/statements/optimize)、または [`TRUNCATE`](https://clickhouse.com/docs/ja/reference/statements/truncate) クエリを実行するまでの待機時間 (秒) を指定します。

設定可能な値:

* `0` — 待機しません。
* 負の整数 — 無制限に待機します。
* 正の整数 — 待機する秒数。

## reserve\_memory

[実験的な機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#experimental-features)

型

UInt64

デフォルト値

0

ワークロードスケジューリングで使用されます。単一のサーバーでクエリを実行するために予約される RAM の最小量です。予約は、`workload` クエリ設定の値を使用して、WORKLOAD 階層を通じて行われます。
ワークロードで使用可能なメモリが不足している場合、クエリは開始されず、予約を確保できるまで保留状態で待機します。
`0` は予約を行わないことを意味します。
この設定は、MEMORY RESERVATION リソースが作成されている場合にのみ有効です。

## restore\_replicated\_merge\_tree\_to\_shared\_merge\_tree

型

Bool

デフォルト値

0

RESTORE 時に、テーブルエンジンを Replicated*MergeTree から Shared*MergeTree に置き換えます。

Cloud でのデフォルト値: `1`。

## result\_overflow\_mode

型

OverflowMode

デフォルト値

throw

結果量がいずれかの制限を超えた場合の動作を設定します。

設定可能な値:

* `throw`: 例外をスローします (デフォルト) 。
* `break`: クエリの実行を停止し、ソースデータが尽きたかのように
  部分的な結果を返します。

'break' を使う動作は LIMIT の使用に似ています。`break` は block レベルでのみ実行を中断します。つまり、返される行数は
[`max_result_rows`](https://clickhouse.com/docs/ja/reference/settings/session-settings/max-result#max_result_rows) を上回り、[`max_block_size`](https://clickhouse.com/docs/ja/reference/settings/session-settings/max#max_block_size)
の倍数になり、[`max_threads`](https://clickhouse.com/docs/ja/reference/settings/session-settings/max-threads#max_threads) に依存します。

**例**

```sql title="Query" theme={null}
SET max_threads = 3, max_block_size = 3333;
SET max_result_rows = 3334, result_overflow_mode = 'break';

SELECT *
FROM numbers_mt(100000)
FORMAT Null;
```

```text title="Result" theme={null}
6666 rows in set. ...
```

## resumable\_backup\_from\_snapshot

[実験的な機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#experimental-features)

型

Bool

デフォルト値

0

再開可能な `BACKUP FROM SNAPSHOT` を有効にします。失敗した場合でも、すでに完了したバッチの
エントリを再コピーせずに再実行できます。ディレクトリ形式の
`S3` および `AzureBlobStorage` 宛先では、ClickHouse Cloud でのみ利用できます。
`BACKUP FROM SNAPSHOT` 自体を利用できない ClickHouse オープンソースビルドでこれを有効にすると、`BACKUP` は `WRONG_BACKUP_SETTINGS` で失敗します。

## rows\_before\_aggregation

型

Bool

デフォルト値

0

有効にすると、ClickHouse は rows\_before\_aggregation 統計値の正確な値を返します。これは、集約前に読み取られた行数を表します

## run\_query\_in\_background

型

Bool

デフォルト値

0

有効にすると、サーバーはクエリをバックグラウンドでスケジュールし、クエリがチェック (たとえば、テーブルが存在するか、ユーザーが必要な権限を持っているかなど) を通過して主要な処理に取りかかる直前まで待機したうえで、空の成功結果を返します。接続の状態にかかわらず、クエリは完了まで実行されます。その時点より前に送出されたエラーはクライアントに返されますが、それ以降のエラーは `system.query_log` にのみ記録されます。

バックグラウンドクエリはサーバーの再起動後には存続しません。シャットダウン時にはフォアグラウンドクエリと同じサーバー設定が適用されます。`shutdown_wait_unfinished_queries` は、クエリをキャンセルするか完了を待つかを選択します (キュー内のエントリは、いずれの場合も `system.query_log` にエントリを記録せず破棄されます) 。`shutdown_wait_unfinished` はサーバーの待機時間を制限します。

クエリは `query_id` で追跡できます。実行中は `system.processes`、完了してクエリログのエントリがフラッシュされた後は `system.query_log` で確認できます。

ネイティブ TCP および HTTP プロトコル経由で受信したクエリに適用されます。HTTP では、設定を URL パラメータとして渡します。`SET` では変更できません。クエリごと、またはユーザーやプロファイルのレベルで有効にしてください。

主なユースケースは、クライアント接続が切断されても失われてはならない、長時間実行される `INSERT ... SELECT` です。

## secondary\_indexes\_enable\_bulk\_filtering

**別名**: `secondary_indices_enable_bulk_filtering`

型

Bool

デフォルト値

1

インデックスでの一括フィルタリングアルゴリズムを有効にします。通常はこちらのほうが常に優れていると想定されていますが、互換性の確保と制御のためにこの設定を用意しています。

## select

明示的な `SELECT` 式リストを用いて、クエリをサブクエリとしてラップします。空でない場合、結果を返すクエリは `SELECT <expr_list> FROM (<query>)` でラップされます。

これは、パース済みクエリに対してエンジンが適用するクエリ構築設定です (派生テーブルとしてラップします) 。既存のクエリと組み合わせて使用でき、すべてのプロトコルで機能します。HTTP URL パラメータ、クエリ内の `SETTINGS` 句、またはユーザープロファイルで指定できます。

結果を返す `SELECT` / `UNION` クエリの形状を決定します。書き込みクエリ (`INSERT … SELECT`、`CREATE … AS SELECT`) では、ソース `SELECT` 自身の `SETTINGS` 句で指定されている場合にのみ有効です。プロファイルまたはセッションから継承された値や、`INSERT` / `CREATE` ステートメント自体に設定された値は、ソース `SELECT` には伝播されません。これは、他のすべての設定にも適用される非伝播ルールと同じです。

## select\_sequential\_consistency

型

UInt64

デフォルト値

0

> [!NOTE]
>
> この設定は、SharedMergeTree と ReplicatedMergeTree で動作が異なります。SharedMergeTree における `select_sequential_consistency` の動作の詳細については、[SharedMergeTree consistency](https://clickhouse.com/docs/ja/products/cloud/features/infrastructure/shared-merge-tree.md#consistency) を参照してください。

`SELECT` クエリで逐次整合性を有効または無効にします。`insert_quorum_parallel` を無効にする必要があります (デフォルトでは有効) 。

設定可能な値:

* 0 — 無効。
* 1 — 有効。

使用方法

逐次整合性が有効な場合、ClickHouse は、`insert_quorum` を指定してそれまでに実行されたすべての `INSERT` クエリのデータを含むレプリカに対してのみ、クライアントが `SELECT` クエリを実行できるようにします。クライアントが不完全なレプリカを参照した場合、ClickHouse は例外を生成します。`SELECT` クエリには、まだレプリカのクォーラムに書き込まれていないデータは含まれません。

`insert_quorum_parallel` が有効な場合 (デフォルト) 、`select_sequential_consistency` は機能しません。これは、並列の `INSERT` クエリが異なるクォーラムレプリカのセットに書き込まれる可能性があるため、単一のレプリカがすべての書き込みを受け取っている保証がないためです。

関連項目:

* [insert\_quorum](https://clickhouse.com/docs/ja/reference/settings/session-settings/insert-quorum.md#insert_quorum)
* [insert\_quorum\_timeout](https://clickhouse.com/docs/ja/reference/settings/session-settings/insert-quorum.md#insert_quorum_timeout)
* [insert\_quorum\_parallel](https://clickhouse.com/docs/ja/reference/settings/session-settings/insert-quorum.md#insert_quorum_parallel)

## semi\_join\_include\_columns\_from\_both\_sides

型

Bool

デフォルト値

1

有効な場合 (デフォルト) 、`SEMI` JOIN の結合結果では両側のカラムにアクセスでき、`SELECT *` は両側のカラムを返します。これは ClickHouse のレガシーな動作です。
無効な場合、アナライザは SQL 標準に従い、`SEMI` JOIN でアクセスできるカラムを保持される側に制限します。
`LEFT SEMI JOIN` では左テーブルのカラムのみ、`RIGHT SEMI JOIN` では右テーブルのカラムのみにアクセスできます。
この制限は、`SELECT`、`PREWHERE`、`WHERE`、`GROUP BY`、`HAVING`、`QUALIFY`、`ORDER BY`、`LIMIT BY` の各句など、結合結果から解決される式に適用され、`t1.*` のような修飾付きワイルドカードも対象となります。
保持されない側のカラムを明示的に参照すると、`SEMI_ANTI_JOIN_COLUMN_ACCESS_DENIED` 例外が送出されます。これには、`t2.b` のような修飾付き参照、`t2.*` のような修飾付きワイルドカード、`d.id` のような `USING` カラム、`db.table.column` のような完全修飾参照が含まれます。また、この制限は `if(false, t2.b, 42)` のように静的に到達しない分岐の内部でも適用されます。一方、アクセス可能なカラムのいずれにも一致しない修飾なしの識別子については、従来どおり汎用の `UNKNOWN_IDENTIFIER` 例外にフォールバックします。
同じ `JOIN` の `JOIN ON` 式では、この設定にかかわらず両側のカラムにアクセスできます。

## session\_query\_ids\_history\_size

型

UInt64

デフォルト値

1000

[`system.session_query_ids`](https://clickhouse.com/docs/ja/reference/system-tables/session_query_ids) システムテーブルを通じて公開される、セッションローカルな履歴に保持されるクエリIDの最大数です。
セッション内で実行された内部クエリ以外のすべてのクエリのクエリIDが、クエリ開始時にそこへ記録されます。履歴がこのサイズを超えると、最も古いエントリから順に追い出されます。

この値はクエリ開始時、クエリがパースされる前に読み取られます。そのため、クエリ自身の `SETTINGS` 句では、そのクエリを記録するかどうかを制御できません。代わりに `SET`、HTTP URLパラメータ、または設定プロファイルを使用してください。

設定可能な値:

* 正の整数。
* 0 — 記録は無効です。それ以前に記録されたエントリはテーブルに残ります。

## session\_timezone

[ベータ機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

現在のセッションまたはクエリの暗黙的なタイムゾーンを設定します。
暗黙的なタイムゾーンとは、明示的にタイムゾーンが指定されていない DateTime/DateTime64 型の値に適用されるタイムゾーンのことです。
この設定は、グローバルに設定された (サーバーレベルの) 暗黙的なタイムゾーンよりも優先されます。
値 '' (空文字列) は、現在のセッションまたはクエリの暗黙的なタイムゾーンが [server time zone](https://clickhouse.com/docs/ja/reference/settings/server-settings/settings/other.md#timezone) と同じであることを意味します。

関数 `timeZone()` と `serverTimeZone()` を使用すると、セッションのタイムゾーンとサーバーのタイムゾーンを取得できます。

設定可能な値:

* `system.time_zones` に含まれる任意のタイムゾーン名 (例: `Europe/Berlin`、`UTC`、`Zulu`)
* `Fixed/UTC±HH:MM:SS` の形式で表記する UTC からの固定オフセット (例: `Fixed/UTC+05:30:00`)。オフセットは 15 分の整数倍で、かつ UTC との差が 14 時間以内である必要があります。この範囲で、実在するすべてのタイムゾーンのオフセットをカバーできます。

受け付けられるのはこれらの名前のみです。オペレーティングシステムのタイムゾーンデータベースにしか存在しない名前は使用できません。これは、結果がホストに依存しないよう、ClickHouse が独自のタイムゾーンデータベースのコピーを同梱しているためです。

例:

```sql theme={null}
SELECT timeZone(), serverTimeZone() FORMAT CSV

"Europe/Berlin","Europe/Berlin"
```

```sql theme={null}
SELECT timeZone(), serverTimeZone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT CSV

"Asia/Novosibirsk","Europe/Berlin"
```

明示的にタイムゾーンが指定されていない内側のDateTimeに、セッションのタイムゾーン 'America/Denver' を割り当てます:

```sql theme={null}
SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver' FORMAT TSV

1999-12-13 07:23:23.123
```

> [!WARNING]
>
> DateTime/DateTime64 をパースする関数のすべてが `session_timezone` に従うわけではありません。これにより、気づきにくいエラーが生じる可能性があります。
> 次の例と説明を参照してください。

```sql theme={null}
CREATE TABLE test_tz (`d` DateTime('UTC')) ENGINE = Memory AS SELECT toDateTime('2000-01-01 00:00:00', 'UTC');

SELECT *, timeZone() FROM test_tz WHERE d = toDateTime('2000-01-01 00:00:00') SETTINGS session_timezone = 'Asia/Novosibirsk'
0 rows in set.

SELECT *, timeZone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS session_timezone = 'Asia/Novosibirsk'
┌───────────────────d─┬─timeZone()───────┐
│ 2000-01-01 00:00:00 │ Asia/Novosibirsk │
└─────────────────────┴──────────────────┘
```

これは、パース処理のパイプラインが異なるために発生します。

* 最初の `SELECT` クエリで、タイムゾーンを明示的に指定せずに使用された `toDateTime()` は、設定 `session_timezone` とグローバルタイムゾーンに従います。
* 2 つ目のクエリでは、DateTime は String からパースされ、既存のカラム`d`の型とタイムゾーンを継承します。そのため、設定 `session_timezone` とグローバルタイムゾーンには従いません。

**関連項目**

* [timezone](https://clickhouse.com/docs/ja/reference/settings/server-settings/settings/other.md#timezone)

## set\_overflow\_mode

型

OverflowMode

デフォルト値

throw

データ量がいずれかの制限値を超えた場合の動作を設定します。

設定可能な値:

* `throw`: 例外を発生させます (デフォルト) 。
* `break`: クエリの実行を停止し、入力データが尽きたかのように
  部分的な結果を返します。

## single\_join\_prefer\_left\_table

型

Bool

デフォルト値

1

単一の JOIN で識別子が曖昧な場合は、左テーブルを優先します

## skip\_redundant\_aliases\_in\_udf

型

Bool

デフォルト値

0

ユーザー定義関数を簡単に利用できるように、冗長な別名は UDF 内では使用されず、置換されます。

設定可能な値:

* 1 — UDF では別名がスキップされます (置換されます) 。
* 0 — UDF では別名はスキップされません (置換されます) 。

**例**

有効時と無効時の違い:

クエリ:

```sql theme={null}
SET skip_redundant_aliases_in_udf = 0;
CREATE FUNCTION IF NOT EXISTS test_03274 AS ( x ) -> ((x + 1 as y, y + 2));

EXPLAIN SYNTAX SELECT test_03274(4 + 2);
```

結果:

```text theme={null}
SELECT ((4 + 2) + 1 AS y, y + 2)
```

クエリ:

```sql theme={null}
SET skip_redundant_aliases_in_udf = 1;
CREATE FUNCTION IF NOT EXISTS test_03274 AS ( x ) -> ((x + 1 as y, y + 2));

EXPLAIN SYNTAX SELECT test_03274(4 + 2);
```

結果:

```text theme={null}
SELECT ((4 + 2) + 1, ((4 + 2) + 1) + 2)
```

## sleep\_after\_receiving\_query\_ms

型

Milliseconds

デフォルト値

0

TCPHandler でクエリを受信した後のスリープ時間

## snappy\_mode

型

SnappyMode

デフォルト値

basic

`file` や `url` などの汎用 file I/O パスで、snappy 圧縮に使用するワイヤ形式を制御します。HTTP `Content-Encoding: snappy` は常に framing フォーマットを使用し、この設定は無視されます。

単一の `snappy::Compress` 呼び出しで生成される生の snappy ブロックフォーマット (たとえば `SnappyBasicReadBuffer` が処理する Prometheus リモートプロトコルのペイロード) は、これとは別のプロトコル固有のワイヤ形式であり、この設定の制御対象ではない点に注意してください。

設定可能な値:

* `basic` — Hadoop snappy ブロックフォーマット。Hadoop が読み書きするファイルと互換性があります。読み取りと書き込みの両方をサポートします。
* `framed` — Snappy framing フォーマット。Google が定義した標準的なストリーミングフォーマットです。読み取りと書き込みの両方をサポートします。

## ソート

クエリを派生テーブルとしてラップするサブクエリに、単純な `ORDER BY` 句を追加します。任意の `+` (ASC) または `-` (DESC) プレフィックスを付けた、識別子または位置カラム参照 (正の整数) のカンマ区切りリストを指定できます。例: `sort=a,-b` は `a` を昇順、`b` を降順でソートします。`sort=1,-2` は 1 番目のカラムを昇順、2 番目のカラムを降順でソートします。`order` とは併用できません。

これは、エンジンがパース済みクエリに適用するクエリ構築設定です (派生テーブルとしてラップされます) 。既存のクエリと組み合わせて使用でき、すべてのプロトコルで機能します。HTTP URL パラメータ、クエリ内の `SETTINGS` 句、またはユーザープロファイルで指定できます。

結果を返す `SELECT` / `UNION` クエリに適用されます。書き込みクエリ (`INSERT … SELECT`、`CREATE … AS SELECT`) では、ソース `SELECT` 自身の `SETTINGS` 句で指定された場合にのみ有効です。プロファイルまたはセッションから継承された値や、`INSERT` / `CREATE` ステートメント自体に設定された値は、ソース `SELECT` には伝播しません。これは、他のすべての設定にも適用される非伝播ルールと同じです。

## sort\_overflow\_mode

型

OverflowMode

デフォルト値

throw

ソート前に受信した行数がいずれかの制限を超えた場合の動作を設定します。

設定可能な値:

* `throw`: 例外をスローします。
* `break`: クエリの実行を停止し、部分的な結果を返します。

## splitby\_max\_substrings\_includes\_remaining\_string

型

Bool

デフォルト値

0

引数 `max_substrings` > 0 が指定された関数 [splitBy\*()](https://clickhouse.com/docs/ja/reference/functions/regular-functions/splitting-merging-functions.md) で、結果配列の最後の要素に残りの文字列を含めるかどうかを制御します。

設定可能な値:

* `0` - 残りの文字列は、結果配列の最後の要素に含まれません。
* `1` - 残りの文字列は、結果配列の最後の要素に含まれます。これは、Spark の [`split()`](https://spark.apache.org/docs/latest/api/python/reference/pyspark.sql/api/pyspark.sql.functions.split.html) 関数および Python の [`string.split()`](https://docs.python.org/3/library/stdtypes.html#str.split) メソッドと同じ動作です。

## sql\_compatible\_division\_for\_integers

型

Bool

デフォルト値

0

両方のオペランドが整数型 (`Int128`、`UInt128`、`Int256`、`UInt256` を含む) の場合、`/` および `divide` が整数を返すようにします。
商はゼロ方向に切り詰められます。結果の幅は第 1 オペランドと同じになり、いずれかのオペランドが符号付きであれば結果も符号付きになります。
ゼロ除算の場合、または商が結果の型の範囲を超える場合は例外をスローします。`Nullable` オペランドの場合は `NULL` が伝播されます。

デフォルトでは、整数同士の除算は `Float64` を返します。この設定は、`Decimal` オペランドや floating-point オペランドを含む除算、
および明示的な関数 `intDiv`、`divideDecimal`、`divideOrNull` には影響しません。

この設定の値は、新たに送信された SQL の式がテーブルのメタデータ、ビュー、SQL関数、またはミューテーションに保存される前に、その式に記録されます。
既存の定義および `ATTACH` クエリは、この設定に関係なく、元の除算のセマンティクスを維持します。

## statistics\_max\_set\_size\_for\_exact\_selectivity\_estimation

型

UInt64

デフォルト値

10000

選択性推定器が集合でカバーされる正確な範囲を導出する対象となる、`IN` 演算子の右辺の集合の最大サイズ。これらの範囲の導出には、要素ごとに `Field` 1 つ、ソート、および統計プローブ 1 回が必要となるため、大きな集合ではクエリプランニングの大半を占めます。この制限を超えると、推定器は代わりに集合のサイズとその境界範囲から選択性を導出します。これはソートや要素ごとの統計プローブを必要とせず、集合を 1 回線形走査するだけで済みます。0 は制限なしを意味します。

## stop\_refreshable\_materialized\_views\_on\_startup

[実験的な機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#experimental-features)

型

Bool

デフォルト値

0

サーバーの起動時に、SYSTEM STOP VIEWS を実行した場合と同様に、リフレッシャブルmaterialized view がスケジュールされないようにします。その後、`SYSTEM START VIEWS` または `SYSTEM START VIEW <name>` を使用して手動で開始できます。新しく作成されたビューにも適用されます。リフレッシャブルでない materialized view には影響しません。

## tcp\_keep\_alive\_timeout

型

Seconds

デフォルト値

290

TCP が keepalive プローブの送信を開始するまでに、接続がアイドル状態のままである時間 (秒)

## temporary\_data\_in\_cache\_reserve\_space\_wait\_lock\_timeout\_milliseconds

型

UInt64

デフォルト値

600000

ファイルシステムキャッシュ内の一時データで領域を予約する際に、cache を lock するまでの待機時間

## throw\_if\_no\_data\_to\_insert

型

Bool

デフォルト値

1

空の INSERT を許可または禁止します。デフォルトで有効になっており、空の INSERT ではエラーが発生します。[`clickhouse-client`](https://clickhouse.com/docs/ja/concepts/features/interfaces/client) を使用する INSERT、または [gRPC インターフェイス](https://clickhouse.com/docs/ja/concepts/features/interfaces/grpc.md) を使用する INSERT にのみ適用されます。

## time\_series\_prefer\_recent\_samples\_table

プライベートプレビュー

型

Bool

デフォルト値

1

要求された時間範囲全体が最近の Samples テーブルの有効期限 (TTL) ウィンドウ内に収まる場合、メインの Samples テーブルではなく、[TimeSeries](https://clickhouse.com/docs/ja/reference/engines/table-engines/integrations/time-series.md) テーブルの最近の Samples テーブルから読み取ります (TimeSeries テーブルエンジンの `recent_samples_ttl_seconds` 設定を参照) 。

## timeout\_before\_checking\_execution\_speed

型

Seconds

デフォルト値

10

指定した秒数の経過後、実行速度が遅すぎないこと (`min_execution_speed` を下回らないこと) を確認します。

## transfer\_overflow\_mode

型

OverflowMode

デフォルト値

throw

データ量がいずれかの制限値を超えたときの動作を設定します。

設定可能な値:

* `throw`: 例外をスローします (デフォルト) 。
* `break`: クエリの実行を停止し、ソースデータが尽きた場合と同様に、
  部分的な結果を返します。

## transform\_null\_in

型

Bool

デフォルト値

0

[IN](https://clickhouse.com/docs/ja/reference/statements/in.md) 演算子において、[NULL](https://clickhouse.com/docs/ja/reference/syntax.md#null) 値同士を等価として扱うようにします。

デフォルトでは、`NULL` は未定義の値を意味するため、`NULL` 値同士は比較できません。したがって、比較 `expr = NULL` は常に `false` を返します。この設定を有効にすると、`IN` 演算子では `NULL = NULL` が `true` を返します。

設定可能な値:

* 0 — `IN` 演算子での `NULL` 値の比較は `false` を返します。
* 1 — `IN` 演算子での `NULL` 値の比較は `true` を返します。

**例**

`null_in` テーブルを考えます。

```text theme={null}
┌──idx─┬─────i─┐
│    1 │     1 │
│    2 │  NULL │
│    3 │     3 │
└──────┴───────┘
```

クエリ:

```sql theme={null}
SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 0;
```

結果:

```text theme={null}
┌──idx─┬────i─┐
│    1 │    1 │
└──────┴──────┘
```

クエリ:

```sql theme={null}
SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1;
```

結果:

```text theme={null}
┌──idx─┬─────i─┐
│    1 │     1 │
│    2 │  NULL │
└──────┴───────┘
```

**関連項目**

* [IN 演算子での NULL 処理](https://clickhouse.com/docs/ja/reference/statements/in.md#null-processing)

## traverse\_shadow\_remote\_data\_paths

型

Bool

デフォルト値

0

system.remote\_data\_paths をクエリする際、実際のテーブルデータに加えて凍結データ (shadow ディレクトリ) も走査します

## union\_default\_mode

`SELECT` クエリ結果を結合するモードを設定します。この設定は、`UNION ALL` または `UNION DISTINCT` を明示的に指定せずに [UNION](https://clickhouse.com/docs/ja/reference/statements/select/union.md) を使用した場合にのみ適用されます。

設定可能な値:

* `'DISTINCT'` — ClickHouse は、重複する行を除去したうえで、クエリを結合した結果の行を出力します。
* `'ALL'` — ClickHouse は、重複する行を含めて、クエリを結合した結果のすべての行を出力します。
* `''` — `UNION` とともに使用すると、ClickHouse は例外を生成します。

例は [UNION](https://clickhouse.com/docs/ja/reference/statements/select/union.md) を参照してください。

## unknown\_packet\_in\_send\_data

型

UInt64

デフォルト値

0

N 番目のデータパケットでは、データの代わりに不明なパケットを送信します

## variant\_throw\_on\_type\_mismatch

型

Bool

デフォルト値

1

デフォルト実装で [Variant](https://clickhouse.com/docs/ja/reference/data-types/variant.md) カラムに関数を適用する際、
実際の型がその関数に対応していない行をどのように扱うかを制御します。

* `true` (デフォルト) — 例外をスローします。
* `false` — 代わりにそれらの行には `NULL` を返します。

## wait\_changes\_become\_visible\_after\_commit\_mode

[実験的な機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#experimental-features)

型

TransactionsWaitCSNMode

デフォルト値

wait\_unknown

コミット済みの変更が最新のスナップショットで実際に見えるようになるまで待機します

## weight

型

Double

デフォルト値

1

ワークロード内におけるクエリの基本スケジューリング重みで、`fair` ワークロードスケジューラで使用されます (`scheduler` ワークロード設定を参照) 。同一ワークロード内でクエリ同士が競合する場合、重みの大きいクエリほど、時間共有リソース (CPU、I/O) を重みに比例して多く割り当てられます。デフォルトの `fifo` スケジューラでは無視されます。正でない値 (`<= 0`) は公平配分において意味を持たないため、デフォルト値の `1.0` として扱われます。

## workload

型

String

デフォルト値

default

リソースへのアクセスに使用するワークロード名

## workload\_admission\_timeout\_ms

型

Milliseconds

デフォルト値

0

クエリが ワークロード scheduling によって受け入れられるまで待機する最大時間で、これを超えるとクエリは開始されずに失敗します。この設定は、query slot (`CREATE RESOURCE ... (QUERY)` リソースから取得され、ワークロード の `max_concurrent_queries` によって制限されます) と memory reservation (`CREATE RESOURCE ... (MEMORY RESERVATION)` リソースおよび `reserve_memory` 設定によるもの) の待機時間の合計を制限します。いずれもクエリの実行開始前に取得されるため、この実行前の待機時間を制限できるのはこの設定だけです。クエリがまだ開始されていないため、`max_execution_time` はこの段階では適用されません。

timeout に達すると、待機していたリソースに応じて、クエリは 2 種類の error のいずれかで失敗します。query slot の場合は `QUERY_SLOT_ACQUISITION_TIMEOUT`、memory reservation の場合は `MEMORY_RESERVATION_ACQUISITION_TIMEOUT` です。

設定可能な値:

* 正の整数 — timeout (ミリ秒単位) 。
* 0 — infinite timeout: クエリは受け入れられるまで無期限に待機します (デフォルト) 。ただし、ワークロード の `max_waiting_queries` の上限に達している場合は、即座に拒否されることがあります。

## workload\_priority

型

Int64

デフォルト値

0

ワークロード内におけるクエリのスケジューリング優先度で、`priority` ワークロードスケジューラで使用されます (`scheduler` ワークロード設定を参照してください) 。値が小さいほど優先度は高くなります。デフォルトの `0` は中立的な基準値で、負の値を指定するとクエリの優先度はデフォルトより高くなり、正の値を指定すると低くなります。同じ優先度のクエリは先着順で処理されます。その他のスケジューラでは、この設定は無視されます。

## write\_full\_path\_in\_iceberg\_metadata

[実験的な機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#experimental-features)

型

Bool

デフォルト値

0

Icebergメタデータファイルに完全なパス (s3:// を含む) を書き込みます。

## zstd\_window\_log\_max

型

Int64

デフォルト値

0

ZSTD の最大ウィンドウログを設定します (MergeTree family では使用されません) 。
