> ## 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. # use_* セッション設定 > use_* で生成されるグループ内の ClickHouse セッション設定。 export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => { return
型
{type}
デフォルト値
{default_value}
{changeable_without_restart &&
再起動せずに変更可能
} {changeable_without_restart &&
{changeable_without_restart}
}
; }; export const ExperimentalBadge = () => { return
実験的な機能です。 詳細を見る。
; }; これらの設定は [system.settings](/docs/ja/reference/system-tables/settings) で参照でき、[ソースコード](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) から自動生成されています。
## use\_async\_executor\_for\_materialized\_views
materialized view のクエリ実行に async、場合によってはマルチスレッド実行を使用します。これにより、INSERT 時の view の処理を高速化できますが、メモリ消費量が増える可能性があります。
## use\_cache\_for\_count\_from\_files
table function `file`/`s3`/`url`/`hdfs`/`azureBlobStorage` で、ファイルから件数をカウントする際の行数のキャッシュを有効にします。 デフォルトで有効です。
## use\_client\_time\_zone
DateTime 文字列の値を解釈する際に、server timezone ではなくクライアントのタイムゾーンを使用します。
## use\_compact\_format\_in\_distributed\_parts\_names
`Distributed` エンジンのテーブルに対するバックグラウンド (`distributed_foreground_insert`) INSERT で、ブロックの保存に compact フォーマットを使用します。 設定可能な値: * 0 — `user[:password]@host:port#default_database` ディレクトリ形式を使用します。 * 1 — `[shard{shard_index}[_replica{replica_index}]]` ディレクトリ形式を使用します。 - `use_compact_format_in_distributed_parts_names=0` の場合、クラスター定義の変更はバックグラウンド INSERT には反映されません。 - `use_compact_format_in_distributed_parts_names=1` の場合、クラスター定義内のノードの順序を変更すると `shard_index`/`replica_index` も変わるため、注意してください。
## use\_concurrency\_control
サーバーの同時実行制御 (グローバルなサーバー設定 `concurrent_threads_soft_limit_num` および `concurrent_threads_soft_limit_ratio_to_cores` を参照) を適用します。無効にすると、サーバーが過負荷状態でもより多くのスレッドを使用できるようになります (通常の用途では推奨されず、主にテストで必要になります) 。
## use\_constant\_folding\_in\_index\_analysis
パーツごとの主キーおよびスキップ索引の解析時に、パーティション単位の定数をフィルタ条件に代入します。 パーティションキーが、主キーカラムまたはスキップ索引のカラムと一緒にフィルタに現れる場合、この設定により、索引解析時に各パーツ内でパーティション値を個別に畳み込めるようになります。特に、異なるパーティションを対象とする分岐を含む OR 条件のフィルタで有効です。たとえば、`PARTITION BY a` と `ORDER BY b` の場合: ```sql theme={null} SELECT * FROM t WHERE (a = 1 AND b >= 1) OR (a = 2 AND b > 10) OR (a = 3 AND b > 10) ``` パーティション `a = 1` のパートでは、この条件は `b >= 1` に畳み込まれます。一方、パーティション `a = 2` と `a = 3` では `b > 10` に畳み込まれるため、各パートは実際に適用される述語に基づいて解析されます。 設定可能な値: * 0 — 無効。 * 1 — 有効。
## use\_hash\_table\_stats\_for\_join\_reordering
join の並べ替え時に、カーディナリティ推定のために収集した hash table 統計を使用することを有効にします
## use\_hedged\_requests
リモートクエリに対する hedged requests のロジックを有効にします。これにより、クエリのために異なるレプリカへの複数の接続を確立できます。 既存の接続が `hedged_connection_timeout` 以内にレプリカに確立されなかった場合、または `receive_data_timeout` 以内にデータを受信しなかった場合は、新しい接続が有効になります。クエリは、空でない Progress パケット (`allow_changing_replica_until_first_data_packet` が有効な場合は Data パケット) を最初に送信した接続を使用し、他の接続はキャンセルされます。`max_parallel_replicas > 1` のクエリもサポートされます。 デフォルトで有効です。 Cloud でのデフォルト値: `0`.
## use\_hive\_partitioning
有効にすると、ClickHouse はファイル系のテーブルエンジン [File](/docs/ja/reference/functions/table-functions/file#hive-style-partitioning)/[S3](/docs/ja/reference/functions/table-functions/s3#hive-style-partitioning)/[URL](/docs/ja/reference/functions/table-functions/url#hive-style-partitioning)/[HDFS](/docs/ja/reference/functions/table-functions/hdfs#hive-style-partitioning)/[AzureBlobStorage](/docs/ja/reference/functions/table-functions/azureBlobStorage#hive-style-partitioning) のパス (`/name=value/`) にある Hive スタイルのパーティション化を検出し、パーティションカラムをクエリ内で仮想カラムとして使用できるようにします。これらの仮想カラムの名前は、パーティション化されたパス内の名前と同じですが、先頭に `_` が付きます。
## use\_join\_disjunctions\_push\_down
JOIN 条件のうち OR で結合された部分を、対応する入力側にプッシュダウン (「部分的なプッシュダウン」) できるようにします。 これにより、ストレージエンジンがより早い段階でフィルタリングできるため、読み取るデータ量を削減できます。 この最適化は意味を変えず、各最上位の OR 分岐が対象側に対して少なくとも 1 つの決定論的な述語を含む場合にのみ適用されます。
## use\_legacy\_to\_time
有効にすると、従来の toTime 関数を使用できます。この関数は、日時の時刻部分を保持したまま、特定の固定日付に変換します。 無効の場合は、新しい toTime 関数が使用され、さまざまな型のデータを Time 型に変換します。 従来の関数は、常に toTimeWithFixedDate としても利用できます。
## use\_lightweight\_primary\_key\_index\_analysis
長い主キーを持つ `MergeTree` テーブルの主キー索引解析を最適化します。 有効にすると、索引解析の実行時間は主キーの長さではなく、主にクエリのフィルタの複雑さ (実際に使用されるキーカラム) に依存します。そのため、一部のカラムだけでフィルタするクエリでは、ソートキーを拡張しても索引解析に対する追加のオーバーヘッドはごくわずかです。 設定可能な値: * 0 — 無効。索引解析時にすべての主キーカラムが処理されます。 * 1 — 有効。
## use\_parquet\_metadata\_cache
有効にすると、Parquet フォーマットで Parquet メタデータキャッシュを利用できます。 設定可能な値: * 0 - 無効 * 1 - 有効
## use\_primary\_key
MergeTree テーブルのクエリ実行時に、グラニュールのプルーニングに主キーを使用します。 設定可能な値: * 0 — 無効。 * 1 — 有効。
## use\_reader\_executor
実験的機能です。従来の読み取りバッファの入れ子構造ではなく、新しいパイプライン `ReaderExecutor` を介して読み取りをルーティングします。executor がまだサポートしていない構成では、従来のパスにフォールバックします。
## use\_roaring\_bitmap\_iceberg\_positional\_deletes
Iceberg の positional deletes に対して roaring bitmap を使用します。
## use\_streaming\_marks\_compression
MergeTree パーツの marks を読み込む際、最初に完全な生の marks 配列としてマテリアライズするのではなく、1 block ずつメモリ内表現に圧縮 (streaming) します。これにより、多数の substreams を持つ compact パーツ (たとえば、JSON カラムを持ち、write\_marks\_for\_substreams\_in\_compact\_parts が有効なテーブル) での marks 読み込み時のピークメモリ使用量を大幅に削減できます。
## use\_strict\_insert\_block\_limits
有効にすると、最小および最大の挿入ブロックサイズ制限の両方が厳密に適用されます。 ブロックは次の場合に生成されます: * 最小しきい値 (AND): min\_insert\_block\_size\_rows と min\_insert\_block\_size\_bytes の両方に達した場合。 * 最大しきい値 (OR): max\_insert\_block\_size\_rows または max\_insert\_block\_size\_bytes のいずれかに達した場合。 無効な場合、ブロックは次の場合に生成されます: * 最小しきい値 (OR): min\_insert\_block\_size\_rows または min\_insert\_block\_size\_bytes のいずれかに達した場合。 **注**: max の設定が min の設定より小さい場合は、max の制限が優先され、最小しきい値に達する前にブロックが生成されます。 **注**: この設定は非同期 INSERT では自動的に無効になります。これは、非同期 INSERT ではエントリごとの重複排除トークンが付加され、これが厳密な制限の適用に必要なブロックの分割と両立しないためです。 デフォルトでは無効です。
## use\_structure\_from\_insertion\_table\_in\_table\_functions
データからスキーマを推論する代わりに、挿入先テーブルの構造を使用します。設定可能な値: 0 - 無効、1 - 有効、2 - 自動
## use\_uncompressed\_cache
非圧縮ブロックのキャッシュを使用するかどうかを指定します。`0` または `1` を受け付けます。既定値は `0` (無効) です。 非圧縮キャッシュ (MergeTree family のテーブルでのみ有効) を使用すると、多数の短いクエリを扱う際のレイテンシを大幅に低減し、スループットを向上させることができます。短いリクエストを頻繁に送信するユーザーには、この設定を有効にしてください。また、[uncompressed\_cache\_size](/docs/ja/reference/settings/server-settings/settings#uncompressed_cache_size) 設定パラメータ (設定ファイルでのみ設定可能) にも注意してください。これは非圧縮キャッシュブロックのサイズです。既定では 8 GiB です。非圧縮キャッシュは必要に応じて格納され、使用頻度の低いデータは自動的に削除されます。 ある程度大きな量のデータ (100 万行以上) を読み取るクエリでは、本当に小さなクエリのための領域を確保するために、非圧縮キャッシュは自動的に無効になります。つまり、`use_uncompressed_cache` 設定は常に `1` のままにしておくことができます。
## use\_with\_fill\_by\_sorting\_prefix
ORDER BY 句で WITH FILL カラムより前にあるカラムは、ソートプレフィックスとなります。ソートプレフィックスの値が異なる行は、それぞれ独立して補完されます