max_analyze_depth
インタープリターが実行する解析の最大数。max_autoincrement_series
generateSerialID 関数によって作成される系列の数の上限です。
各系列は Keeper 内のノードを表すため、その数は多くても数百万個までに抑えることを推奨します。
max_backup_bandwidth
サーバー上の特定のバックアップに対する、1 秒あたりの最大読み取り速度 (バイト数) です。0 は無制限を意味します。max_block_size
ClickHouse では、データはブロック単位で処理されます。ブロックはカラムのパーツの集合です。単一のブロックに対する内部処理サイクル自体は効率的ですが、各ブロックの処理には無視できないコストがかかります。max_block_size 設定は、テーブルからデータを読み込む際に、1 つのブロックに含める行数の推奨最大値を示します。常に max_block_size サイズのブロックがテーブルから読み込まれるわけではありません。ClickHouse が取得するデータ量はそれより少なくてよいと判断した場合は、より小さいブロックが処理されます。
各ブロックの処理コストが目立つものになるのを避けるため、ブロックサイズは小さすぎてはいけません。また、LIMIT 句を含むクエリが最初のブロックの処理後すぐに実行できるようにするため、大きすぎてもいけません。max_block_size を設定する際は、多数のカラムを複数のスレッドで抽出するときにメモリを過剰に消費しないこと、そして少なくともある程度のキャッシュ局所性を維持することを目指すべきです。
max_columns_to_read
1 回のクエリで テーブル から読み取れるカラム数の上限です。 クエリで指定された数を超えるカラムを読み取る必要がある場合、例外 がスローされます。0 は無制限を意味します。
max_compress_block_size
テーブルへの書き込み時に圧縮する前の、非圧縮データのブロックの最大サイズです。デフォルトは 1,048,576 (1 MiB) です。より小さいブロックサイズを指定すると、一般に圧縮率はわずかに低下しますが、キャッシュ局所性 により圧縮および展開の速度はわずかに向上し、メモリ使用量は削減されます。これは expert-level setting です。ClickHouse を使い始めたばかりの場合は、変更しないでください。
max_consume_snapshots
1 回のインクリメンタル読み取りで消費する Paimon スナップショットの最大数。0 は無制限を意味します。max_estimated_execution_time
秒単位で指定する、クエリの推定実行時間の上限です。各データブロックごとに、timeout_before_checking_execution_speed
が経過した時点でチェックされます。
max_expanded_ast_elements
別名とアスタリスクを展開した後のクエリ構文木の最大サイズ (ノード数) 。 この上限は、WITH 要素 (共通テーブル式およびエイリアス付きの式) をクエリ内に置換することで生成されるノード数にも適用されます。これは WITH 要素が置換されるすべての箇所が対象で、SELECT クエリ、CREATE VIEW および CREATE MATERIALIZED VIEW、完全な定義を伴う ATTACH、ALTER TABLE ... MODIFY QUERY、ALTER TABLE ... UPDATE/DELETE および論理更新 UPDATE におけるミューテーションの式、分散 INSERT ... SELECT、さらに UNION を構成するすべてのクエリへの WITH 要素の伝播が含まれます。上限を超えた場合、クエリは TOO_BIG_AST エラーで失敗します。
max_fetch_partition_retries_count
別のホストからパーティションをフェッチする際の再試行回数。max_final_threads
FINAL 修飾子を使用するSELECTクエリのデータ読み取りフェーズにおける、並列スレッドの最大数を設定します。
設定可能な値:
- 正の整数。
- 0 または 1 — 無効。
SELECTクエリは単一スレッドで実行されます。
max_http_get_redirects
許可される HTTP GET リダイレクトの最大ホップ数です。悪意のあるサーバーによって、リクエストが想定外のサービスへリダイレクトされるのを防ぐための追加のセキュリティ対策です。\n\nこれは、外部サーバーが別のアドレスにリダイレクトし、そのアドレスが社内のインフラストラクチャ内にあるように見える場合に起こりえます。このとき、内部サーバーに HTTP リクエストを送ることで、認証を回避して内部ネットワーク上の内部 API にアクセスしたり、Redis や Memcached などの別のサービスに問い合わせたりできてしまう可能性があります。内部インフラストラクチャ (localhost 上で動作しているものを含む) が存在しない場合、またはそのサーバーを信頼している場合は、リダイレクトを許可しても安全です。ただし、URL が HTTPS ではなく HTTP を使用している場合は、リモートサーバーだけでなく、ISP や通信経路上にあるすべてのネットワークも信頼する必要がある点に注意してください。 Cloud でのデフォルト値:10.
max_limit_for_vector_search_queries
LIMIT がこの設定値を超える SELECT クエリでは、ベクトル類似度索引を使用できません。ベクトル類似度索引でのメモリオーバーフローの防止に役立ちます。max_os_cpu_wait_time_ratio_to_throw
クエリを拒否するかどうかを判断するための、OS CPU の待機時間 (OSCPUWaitMicroseconds メトリクス) とビジー時間 (OSCPUVirtualTimeMicroseconds メトリクス) の最大比率。確率の計算には最小比率と最大比率の間で線形補間が使用され、この値では確率は 1 になります。max_parallel_replicas
クエリの実行時に、各分片で使用するレプリカの最大数です。 設定可能な値:- 正の整数。
SAMPLE キーを使用した並列処理
クエリは、複数のサーバーで並列に実行することで、より高速に処理できる場合があります。ただし、次のような場合はクエリパフォーマンスが低下する可能性があります。
- パーティション化キー内でのサンプリングキーの位置によっては、効率的な範囲スキャンができません。
- テーブルにサンプリングキーを追加すると、他のカラムでのフィルタリング効率が低下します。
- サンプリングキーが、計算コストの高い式である場合。
- クラスターのレイテンシ分布にロングテールがあると、より多くのサーバーにクエリすることで、クエリ全体のレイテンシが増加します。
parallel_replicas_custom_keyを使用した並列処理
この設定は、あらゆるレプリケートテーブルで有用です。max_parsing_threads
並列パースに対応した入力フォーマットでデータをパースする際の最大スレッド数です。デフォルトでは自動的に決定されます。max_partition_size_to_drop
クエリ時にパーティションを削除する際の制限です。値0 は、パーティションを制限なく削除できることを意味します。
Cloud でのデフォルト値: 1 TB。
このクエリ設定は、対応するサーバー設定を上書きします。詳しくは max_partition_size_to_drop を参照してください
max_parts_to_move
1回のクエリで移動できるパーツ数を制限します。0 は無制限を意味します。max_projection_rows_to_use_projection_index
プロジェクション索引から読み取る行数がこのしきい値以下の場合、ClickHouse はクエリ実行時にプロジェクション索引の適用を試みます。max_query_size
SQL パーサーが解析するクエリ文字列の最大バイト数です。 INSERT クエリの VALUES 句内のデータは、別個のストリームパーサー (O(1) の RAM を使用) によって処理されるため、この制限の影響を受けません。max_query_size は SQL クエリ内 (例: SELECT now() SETTINGS max_query_size=10000) では設定できません。これは、ClickHouse がクエリを解析するためのバッファを確保する必要があり、そのバッファサイズは max_query_size 設定によって決まるためです。そのため、この設定はクエリの実行前に行っておく必要があります。max_recursive_cte_evaluation_depth
再帰CTEの評価深さの上限値max_replica_delay_for_distributed_queries
分散クエリで、遅延しているレプリカを使用しないようにします。レプリケーション を参照してください。 時間を秒単位で設定します。レプリカの遅延が設定した値以上の場合、そのレプリカは使用されません。 設定可能な値:- 正の整数。
- 0 — レプリカの遅延はチェックされません。
SELECT を実行する際に使用されます。
max_reverse_dictionary_lookup_cache_size_bytes
関数dictGetKeys が使用する、クエリごとの逆引き Dictionary ルックアップキャッシュの最大サイズ (バイト単位) 。このキャッシュには、同じクエリ内で Dictionary を再スキャンしないよう、属性値ごとにシリアライズされたキー Tuple が保存されます。上限に達すると、エントリは LRU 方式で追い出されます。キャッシュを無効にするには 0 に設定します。
max_sessions_for_user
ClickHouse server で、認証済みユーザーごとに同時に使用できるセッションの最大数です。 例:- 正の整数
0- 同時セッション数は無制限 (デフォルト)
max_subquery_depth
クエリ内でネストされたサブクエリの数が指定した値を超えると、 例外をスローします。max_table_size_to_drop
クエリ実行時にテーブルを削除する際の制限です。値0 は、すべてのテーブルを制限なく削除できることを意味します。
Cloud でのデフォルト値: 1 TB。
このクエリ設定は、対応するサーバー設定を上書きします。詳細は max_table_size_to_drop を参照してください。
max_untracked_memory
小さな割り当てと解放はスレッドローカル変数にまとめて保持され、量 (絶対値) が指定した値を超えた場合にのみ追跡またはプロファイリングされます。値がmemory_profiler_step より大きい場合は、実質的に memory_profiler_step に引き下げられます。
max_wkb_geometry_elements
readWKB および関連関数でパースする際、単一の WKB ジオメトリ要素内で許可される Point、Ring、または Polygon の最大数です。これにより、不正な WKB データによる過剰なメモリ割り当てを防ぎます。ハードコードされた上限 (1 億) を使用するには、0 に設定します。