enable_* セッション設定 - ClickHouse Documentation

これらの設定は system.settings で確認でき、ソースコードから自動生成されています。

enable_adaptive_memory_spill_scheduler

トリガープロセッサが、データを外部ストレージへ適応的にスピルします。現時点でサポートされているのは grace join のみです。

enable_add_distinct_to_in_subqueries

IN サブクエリで DISTINCT を有効にします。これはトレードオフのある設定です。有効にすると、一意の値だけが送信されるようになるため、分散 IN サブクエリで転送される一時テーブルのサイズを大幅に削減でき、分片間のデータ転送を大きく高速化できます。ただし、この設定を有効にすると、重複排除 (DISTINCT) を実行する必要があるため、各ノードで追加のマージ処理負荷が発生します。ネットワーク転送がボトルネックになっており、追加のマージコストを許容できる場合にこの設定を使用してください。

enable_automatic_decision_for_merging_across_partitions_for_final

有効にすると、パーティションキー式が決定論的であり、かつその式で使用されるすべてのカラムが主キーに含まれている場合、ClickHouse はこの最適化を自動的に有効にします。この自動判定により、同じ主キー値を持つ行は常に同じパーティションに属することが保証されるため、パーティションをまたぐマージを回避しても安全です。

enable_early_constant_folding

関数やサブクエリの結果を解析し、定数が含まれている場合にクエリを書き換えるクエリ最適化を有効にします

enable_extended_results_for_datetime_functions

拡張範囲を持つ Date32 型 (Date 型と比較) または拡張範囲を持つ DateTime64 型 (DateTime 型と比較) の結果を返すかどうかを有効または無効にします。設定可能な値:

0 — 関数は、すべての型の引数に対して Date または DateTime を返します。
1 — 関数は、Date32 または DateTime64 型の引数に対しては Date32 または DateTime64 を返し、それ以外の場合は Date または DateTime を返します。

以下のテーブルは、さまざまな日付/時刻関数に対するこの設定の動作を示しています。

関数	`enable_extended_results_for_datetime_functions = 0`	`enable_extended_results_for_datetime_functions = 1`
`toStartOfYear`	戻り値は `Date` または `DateTime`	`Date`/`DateTime` 型の入力には `Date`/`DateTime` を返します `Date32`/`DateTime64` 型の入力には `Date32`/`DateTime64` を返します
`toStartOfISOYear`	戻り値は `Date` または `DateTime`	入力が `Date`/`DateTime` の場合は `Date`/`DateTime` を返します入力が `Date32`/`DateTime64` の場合は `Date32`/`DateTime64` を返します
`toStartOfQuarter`	`Date` または `DateTime` を返す	`Date`/`DateTime` の入力に対しては `Date`/`DateTime` を返します `Date32`/`DateTime64` の入力に対しては `Date32`/`DateTime64` を返します
`toStartOfMonth`	`Date` または `DateTime` を返します	`Date`/`DateTime` 型の入力には `Date`/`DateTime` を返します `Date32`/`DateTime64` 型の入力には `Date32`/`DateTime64` を返します
`toStartOfWeek`	`Date` または `DateTime` を返します	`Date`/`DateTime` 入力の場合は `Date`/`DateTime` を返します `Date32`/`DateTime64` 入力の場合は `Date32`/`DateTime64` を返します
`toLastDayOfWeek`	`Date` または `DateTime` を返します	`Date`/`DateTime` 入力の場合は `Date`/`DateTime` を返します `Date32`/`DateTime64` 入力の場合は `Date32`/`DateTime64` を返します
`toLastDayOfMonth`	`Date` または `DateTime` を返します	`Date`/`DateTime` 入力の場合は `Date`/`DateTime` を返します `Date32`/`DateTime64` 入力の場合は `Date32`/`DateTime64` を返します
`toMonday`	`Date` または `DateTime` を返します	`Date`/`DateTime` 型の入力に対しては `Date`/`DateTime` を返します `Date32`/`DateTime64` 型の入力に対しては `Date32`/`DateTime64` を返します
`toStartOfDay`	`DateTime` を返します注: 1970～2149 の範囲外の値では正しくない結果になる場合があります	`Date`/`DateTime` 入力の場合は `DateTime` を返します `Date32`/`DateTime64` 入力の場合は `DateTime64` を返します
`toStartOfHour`	戻り値は `DateTime` 注: 1970～2149 の範囲外の値では誤った結果を返します	`Date`/`DateTime` 型の入力に対しては `DateTime` を返します `Date32`/`DateTime64` 型の入力に対しては `DateTime64` を返します
`toStartOfFifteenMinutes`	`DateTime` を返します注: 1970～2149 の範囲外の値では誤った結果が返されます	`Date`/`DateTime` 入力の場合は `DateTime` を返します `Date32`/`DateTime64` 入力の場合は `DateTime64` を返します
`toStartOfTenMinutes`	戻り値は `DateTime` 注: 1970〜2149 の範囲外の値では正しい結果が得られません	`Date`/`DateTime` 型の入力には `DateTime` を返します `Date32`/`DateTime64` 型の入力には `DateTime64` を返します
`toStartOfFiveMinutes`	`DateTime` を返します注: 1970～2149 の範囲外の値では正しい結果が得られません	入力が `Date`/`DateTime` の場合は `DateTime` を返します入力が `Date32`/`DateTime64` の場合は `DateTime64` を返します
`toStartOfMinute`	`DateTime` を返します注: 1970～2149 の範囲外の値では正しい結果が得られません	`Date`/`DateTime` 型の入力では `DateTime` を返します `Date32`/`DateTime64` 型の入力では `DateTime64` を返します
`timeSlot`	戻り値は `DateTime` 注: 1970〜2149 の範囲外の値では正しい結果が得られません	`Date`/`DateTime` 型の入力に対しては `DateTime` を返します `Date32`/`DateTime64` 型の入力に対しては `DateTime64` を返します

enable_full_text_index

別名: allow_experimental_full_text_index true に設定すると、テキスト索引を使用できます。

enable_global_with_statement

WITH ステートメントを UNION クエリおよびすべてのサブクエリに伝播します

enable_hdfs_pread

HDFS ファイルでの pread の使用を有効または無効にします。デフォルトでは hdfsPread が使用されます。無効にすると、HDFS ファイルの読み取りには hdfsRead と hdfsSeek が使用されます。

enable_http_compression

HTTPリクエストに対するレスポンスでのデータ圧縮を有効または無効にします。詳細については、HTTPインターフェイスの説明を参照してください。設定可能な値:

0 — 無効。
1 — 有効。

enable_identifier_resolve_cache

クエリアナライザで識別子解決 cache を有効にします。この cache は、同じエイリアスが複数回参照されたときに AST が肥大化するのを防ぐため、解決済みのエイリアスノードを共有します。誤った結果が疑われる場合は、false に設定して cache を無効にします。

enable_job_stack_trace

ジョブの実行結果が例外になった場合に、ジョブ作成元のスタックトレースを出力します。パフォーマンスのオーバーヘッドを避けるため、デフォルトでは無効です。

enable_lazy_columns_replication

JOIN および ARRAY JOIN でのカラムの遅延複製を有効にします。これにより、同じ行をメモリ上で何度も不必要にコピーするのを防げます。

enable_materialized_cte

マテリアライズド共通テーブル式を有効にします。enable_global_with_statement よりも優先されます。

enable_memory_bound_merging_of_aggregation_results

集約に対するメモリ制約付きのマージ戦略を有効にします。

enable_multiple_prewhere_read_steps

AND で結合された複数の条件がある場合、より多くの条件を WHERE から PREWHERE に移し、ディスクからの読み取りとフィルタリングを複数段階で実行します

enable_named_columns_in_function_tuple

すべての名前が一意で、クォートなしの識別子として扱える場合、tuple() 関数で名前付きタプルを生成します。

enable_order_by_all

ORDER BY ALL 構文でのソートを有効または無効にします。詳しくは ORDER BY を参照してください。設定可能な値:

0 — ORDER BY ALL を無効にします。
1 — ORDER BY ALL を有効にします。

例クエリ:

CREATE TABLE TAB(C1 Int, C2 Int, ALL Int) ENGINE=Memory();

INSERT INTO TAB VALUES (10, 20, 30), (20, 20, 10), (30, 10, 20);

SELECT * FROM TAB ORDER BY ALL; -- returns an error that ALL is ambiguous

SELECT * FROM TAB ORDER BY ALL SETTINGS enable_order_by_all = 0;

結果:

┌─C1─┬─C2─┬─ALL─┐
│ 20 │ 20 │  10 │
│ 30 │ 10 │  20 │
│ 10 │ 20 │  30 │
└────┴────┴─────┘

enable_parallel_blocks_marshalling

分散クエリにのみ影響します。有効にすると、ブロックはイニシエーターへの送信前後に、パイプラインスレッド上でシリアライズ／デシリアライズおよび圧縮／展開されます (つまり、デフォルトより高い並列度で処理されます) 。

enable_parsing_to_custom_serialization

true の場合、テーブルから取得したシリアライゼーションのヒントに基づいて、カスタムシリアライゼーション (例: スパース) を使用するカラムにデータを直接パースできます。

enable_producing_buckets_out_of_order_in_aggregation

メモリ効率の高い集約 (distributed_aggregation_memory_efficientを参照) で、バケットを順不同で生成できるようにします。これにより、集約バケットのサイズに偏りがある場合でも、レプリカは id の小さい重いバケットをまだ処理している間に、id の大きいバケットをイニシエーターへ送信できるため、パフォーマンスが向上することがあります。欠点として、メモリ使用量が増える可能性があります。

enable_reads_from_query_cache

有効にすると、SELECT クエリの結果がクエリキャッシュから取得されます。設定可能な値:

0 - 無効
1 - 有効

enable_s3_requests_logging

S3 リクエストの非常に詳細なログを有効にします。デバッグ時にのみ使用するのが適切です。

enable_scalar_subquery_optimization

true に設定すると、スカラーサブクエリで大きなスカラー値のシリアライズ／デシリアライズを防ぎ、同じサブクエリが複数回実行されるのを回避できる可能性があります。

enable_scopes_for_with_statement

無効にすると、親の WITH 句内の宣言は、現在のスコープで宣言された場合と同じスコープとして扱われます。これはアナライザの互換性設定であり、旧アナライザでは実行できた一部の無効なクエリも実行できるようにするものです。

enable_sharding_aggregator

グループ化キーをハッシュ化して行をスレッド間に分散し、各スレッドがマージフェーズなしで重複しないキーの部分集合を集約する、分片化されたGROUP BY最適化を有効にします。これは、データが均等に分散した高カーディナリティのキーに対して効率的ですが、キー分布に大きな偏りがある場合や、異なるキーがごく少ないクエリでは性能が低下することがあります。設定可能な値:

0 — 分片化集約の最適化は無効です。
1 — 分片化集約の最適化は有効です。

enable_shared_storage_snapshot_in_query

有効にすると、1 つのクエリ内のすべてのサブクエリで、各テーブルについて同じ StorageSnapshot が共有されます。これにより、同じテーブルに複数回アクセスする場合でも、クエリ全体を通して一貫したデータビューが保証されます。これは、データパーツの内部整合性が重要となるクエリで必要です。例:

SELECT
    count()
FROM events
WHERE (_part, _part_offset) IN (
    SELECT _part, _part_offset
    FROM events
    WHERE user_id = 42
)

この設定がないと、外側のクエリと内側のクエリが異なるデータスナップショットを参照して実行され、不正確な結果になる可能性があります。

この設定を有効にすると、プランニング段階の完了後にスナップショットから不要なデータパーツを削除する最適化が無効になります。その結果、長時間実行されるクエリでは、実行中ずっと廃止されたパーツを保持し続ける可能性があり、パーツのクリーンアップが遅れ、ストレージへの負荷が増加します。この設定は現在、MergeTree familyのテーブルにのみ適用されます。

設定可能な値:

0 - 無効
1 - 有効

enable_sharing_sets_for_mutations

同じ mutation 内の異なるタスク間で、IN サブクエリ用に構築された set オブジェクトの共有を許可します。これにより、メモリ使用量と CPU 使用量を削減できます

enable_streaming_queries

SELECT ... FROM t STREAM [CURSOR '{...}'] の継続クエリを許可します。オフの場合、STREAM 修飾子を使用するテーブル式はすべてプラン構築時に拒否されます。これは streaming-queries 機能全体を制御するゲートであり、追加の機能はそれぞれ独自の設定で制御される場合があります。

enable_time_time64_type

別名: allow_experimental_time_time64_type Time および Time64 データ型を作成できるようにします。

enable_unaligned_array_join

サイズの異なる複数の配列に対する ARRAY JOIN を許可します。この設定を有効にすると、配列は最も長いものに合わせてリサイズされます。

enable_url_encoding

URL エンジンテーブルで、URI 内のパスのデコード/エンコードを有効または無効にします。デフォルトでは無効です。

enable_vertical_final

有効にすると、FINAL 時の重複した行は、行をマージする代わりに削除済みとしてマークし、後でフィルタリングして除外します

enable_writes_to_query_cache

有効にすると、SELECT クエリの結果がクエリキャッシュに保存されます。設定可能な値:

0 - 無効
1 - 有効

​enable_adaptive_memory_spill_scheduler

​enable_add_distinct_to_in_subqueries

​enable_automatic_decision_for_merging_across_partitions_for_final

​enable_early_constant_folding

​enable_extended_results_for_datetime_functions

​enable_full_text_index

​enable_global_with_statement

​enable_hdfs_pread

​enable_http_compression

​enable_identifier_resolve_cache

​enable_job_stack_trace

​enable_lazy_columns_replication

​enable_materialized_cte

​enable_memory_bound_merging_of_aggregation_results

​enable_multiple_prewhere_read_steps

​enable_named_columns_in_function_tuple

​enable_order_by_all

​enable_parallel_blocks_marshalling

​enable_parsing_to_custom_serialization

​enable_producing_buckets_out_of_order_in_aggregation

​enable_reads_from_query_cache

​enable_s3_requests_logging

​enable_scalar_subquery_optimization

​enable_scopes_for_with_statement

​enable_sharding_aggregator

​enable_shared_storage_snapshot_in_query

​enable_sharing_sets_for_mutations

​enable_streaming_queries

​enable_time_time64_type

​enable_unaligned_array_join

​enable_url_encoding

​enable_vertical_final

​enable_writes_to_query_cache