> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# force_* セッション設定
> force_* グループに含まれる ClickHouse のセッション設定。
export const CloudOnlyBadge = () => {
return ;
};
export const VersionHistory = ({rows = []}) => {
if (rows.length === 0) {
return null;
}
const headers = ["バージョン", "デフォルト値", "コメント"];
const border = "1px solid rgba(128, 128, 128, 0.3)";
const cell = {
border,
padding: "0.25rem 0.5rem",
textAlign: "start",
verticalAlign: "top"
};
return
バージョン履歴
{headers.map(header => |
{header}
| )}
{rows.map((row, row_index) =>
{(row.items ?? []).map((item, item_index) => |
{item?.label}
| )}
)}
;
};
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
型
{type}
デフォルト値
{default_value}
{changeable_without_restart &&
再起動せずに変更可能
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
これらの設定は [system.settings](/ja/reference/system-tables/settings) で利用でき、[ソースコード](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) から自動生成されています。
## force\_aggregate\_partitions\_independently
この最適化を適用可能でありながら、ヒューリスティックによって使用しないと判断された場合でも、使用を強制します
## force\_aggregation\_in\_order
この設定は、分散クエリをサポートするためにサーバー自体で使用されます。通常の動作に支障をきたすため、手動で変更しないでください。 (分散集約時に、リモートノードで順序付き集約を使用するよう強制します) 。
## force\_creating\_set\_partitions\_independently
適用可能であるにもかかわらず、パーティションの偏りチェック (最大のパーティションが平均の2倍を超える場合) により使用しないと判断された場合でも、`IN (subquery)` のセット構築時にパーティションごとの事前重複排除を強制します。[allow\_creating\_set\_partitions\_independently](/ja/reference/settings/session-settings/allow#allow_creating_set_partitions_independently) の偏りチェックのみをバイパスし、その他の条件は引き続き適用されます。
## force\_data\_skipping\_indices
指定したデータスキッピングインデックスが使用されなかった場合、クエリ実行を無効化します。
次の例を見てみましょう。
```sql theme={null}
CREATE TABLE data
(
key Int,
d1 Int,
d1_null Nullable(Int),
INDEX d1_idx d1 TYPE minmax GRANULARITY 1,
INDEX d1_null_idx assumeNotNull(d1_null) TYPE minmax GRANULARITY 1
)
Engine=MergeTree()
ORDER BY key;
SELECT * FROM data_01515;
SELECT * FROM data_01515 SETTINGS force_data_skipping_indices=''; -- query will produce CANNOT_PARSE_TEXT error.
SELECT * FROM data_01515 SETTINGS force_data_skipping_indices='d1_idx'; -- query will produce INDEX_NOT_USED error.
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='d1_idx'; -- Ok.
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='`d1_idx`'; -- Ok (example of full featured parser).
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='`d1_idx`, d1_null_idx'; -- query will produce INDEX_NOT_USED error, since d1_null_idx is not used.
SELECT * FROM data_01515 WHERE d1 = 0 AND assumeNotNull(d1_null) = 0 SETTINGS force_data_skipping_indices='`d1_idx`, d1_null_idx'; -- Ok.
```
## force\_distinct\_partitions\_independently
適用可能であるにもかかわらずコストヒューリスティックが使用しないと判断した場合でも、パーティションごとに独立して `DISTINCT` を評価するよう強制します。[allow\_distinct\_partitions\_independently](/ja/reference/settings/session-settings/allow#allow_distinct_partitions_independently) のコストヒューリスティックのみをバイパスし、それ以外の条件は引き続き適用されます。
## force\_grouping\_standard\_compatibility
引数が集約キーとして使用されていない場合、GROUPING関数は1を返します
## force\_index\_by\_date
日付条件で索引を利用できない場合、クエリ実行を無効にします。
MergeTree family に属するテーブルで動作します。
`force_index_by_date=1` の場合、ClickHouse は、データ範囲の絞り込みに使用できる日付キー条件がクエリに含まれているかどうかを確認します。適切な条件がない場合は、例外をスローします。ただし、その条件によって読み取るデータ量が実際に減るかどうかまでは確認しません。たとえば、条件 `Date != ' 2000-01-01 '` は、テーブル内のすべてのデータに一致する場合でも許容されます (つまり、クエリの実行にはフルスキャンが必要です) 。MergeTree テーブルにおけるデータ範囲の詳細については、[MergeTree](/ja/reference/engines/table-engines/mergetree-family/mergetree) を参照してください。
## force\_primary\_key
主キー索引を使用できない場合、クエリ実行を無効にします。
MergeTree family のテーブルで動作します。
`force_primary_key=1` の場合、ClickHouse はクエリに、データの範囲を絞り込むために使用できる主キー条件があるかどうかを確認します。適切な条件がない場合は、例外をスローします。ただし、その条件によって読み取るデータ量が減るかどうかまでは確認しません。MergeTree テーブルにおけるデータ範囲の詳細については、[MergeTree](/ja/reference/engines/table-engines/mergetree-family/mergetree) を参照してください。
## force\_read\_through\_distributed\_cache
ClickHouse Cloud でのみ有効です。単一のクエリに対してサーバー設定 `enable_read_through_distributed_cache` を上書きします。デフォルトの `auto` は、サーバー設定に従います。
## force\_remove\_data\_recursively\_on\_drop
DROP クエリ時にデータを再帰的に削除します。これにより 'Directory not empty' エラーは回避されますが、デタッチされたデータも気付かないうちに削除される可能性があります
## force\_window\_partitions\_independently
適用可能であってもコストヒューリスティックによって使用しないと判断された場合に、パーティションごとのウィンドウ関数の独立した評価を強制します。[allow\_window\_partitions\_independently](/ja/reference/settings/session-settings/allow#allow_window_partitions_independently) のコストヒューリスティックのみをバイパスし、他の条件は引き続き適用されます。
## force\_write\_through\_distributed\_cache
ClickHouse Cloud でのみ有効です。単一のクエリに対してサーバー設定 `enable_write_through_distributed_cache` を上書きします。デフォルトの `auto` は、サーバー設定に従います。