Skip to main content
これらの設定は ClickHouseサーバーを構成するもので、ClickHouse のソースコードから自動生成されています。

max_active_parts_loading_thread_pool_size

起動時にアクティブなデータパーツ群 (Active なもの) を読み込むためのスレッド数。

max_authentication_methods_per_user

ユーザーの作成時または変更時に設定できる認証方式の最大数です。 この設定を変更しても、既存のユーザーには影響しません。認証関連の CREATE/ALTER クエリは、この設定で指定された上限を超えると失敗します。 認証に関係しない CREATE/ALTER クエリは成功します。
0 は無制限を意味します。

max_backup_bandwidth_for_server

server 上のすべてのバックアップに対する、1 秒あたりの最大読み取り速度 (バイト/秒) です。0 は無制限を意味します。

max_build_vector_similarity_index_thread_pool_size

ベクトル索引の構築に使用するスレッドの最大数です。
値 0 は、すべてのコアを意味します。

max_connections

サーバーの最大接続数。

max_entries_for_hash_table_stats

集約中に収集されるハッシュテーブル統計で保持できるエントリ数

max_fetch_partition_thread_pool_size

ALTER TABLE FETCH PARTITION に使用するスレッド数。

max_held_snapshots

同時に保持できる軽量スナップショットの最大数。0 は無制限を意味します。スナップショット数がこの上限に達すると、新しいスナップショットを作成しようとした際に例外がスローされます。

max_http_index_page_size

HTTP 経由でディレクトリ一覧を表示する際に使用される、HTTP インデックスページのレスポンスの最大サイズです。 レスポンスがこの上限を超えると、クエリはエラーで失敗します。 デフォルト: 10485760 (10 MiB)。

max_iceberg_manifest_decode_thread_pool_free_size

Iceberg のデータマニフェストファイルをデコードするスレッドプールに保持しておく、アイドル状態の待機スレッドの最大数。

max_iceberg_manifest_decode_thread_pool_size

Iceberg のデータマニフェストファイル のデコードに使用するスレッドの合計最大数。 このスレッドプールは意図的に I/O スレッドプールとは分離されています。デコードタスクは、生成したエントリがクエリによって消費されるまでブロックされることがある一方で、削除マニフェストのデコードはエントリが消費される前に I/O スレッドプール上のタスクの完了を待機します。1 つのスレッドプールを共有すると、デッドロックが発生する可能性があります。

max_keep_alive_requests

ClickHouseサーバー によって接続が閉じられるまでに、単一の keep-alive 接続を介して処理されるリクエストの最大数です。 例

max_materialized_views_count_for_table

テーブルに関連付けられる materialized view の数の上限です。
ここでは直接依存するビューのみが対象であり、あるビューの上に別のビューを作成する場合は考慮されません。

max_merges_bandwidth_for_server

server上のすべてのマージにおける最大読み取り速度 (1秒あたりのバイト数) です。0は無制限を意味します。

max_mutations_bandwidth_for_server

サーバー上のすべてのミューテーションに対する読み取り速度の上限を、1 秒あたりのバイト数で指定します。0 は無制限を意味します。

max_open_files

開くことのできるファイルの最大数です。
macOS では getrlimit() 関数が正しくない値を返すため、このオプションの使用を推奨します。

max_os_cpu_wait_time_ratio_to_drop_connection

接続を切断するかどうかを判断する際に考慮する、OS の CPU 待機時間 (OSCPUWaitMicroseconds メトリクス) とビジー時間 (OSCPUVirtualTimeMicroseconds メトリクス) の最大比率です。確率の計算には最小比率と最大比率の間の線形補間が使用され、この時点で確率は 1 になります。 詳細については、server の CPU 過負荷時の動作制御を参照してください。

max_outdated_parts_loading_thread_pool_size

起動時に非アクティブなデータパーツ (outdated なもの) のセットを読み込むためのスレッド数。

max_part_num_to_warn

アクティブなパーツの数が指定した値を超えると、ClickHouse server は system.warnings テーブルに警告メッセージを追加します。 例

max_partition_size_to_drop

パーティションの削除に関する制限です。 MergeTree テーブルのサイズが max_partition_size_to_drop (バイト単位) を超える場合、DROP PARTITION クエリを使ってパーティションを削除することはできません。 この設定は、適用のために ClickHouseサーバー を再起動する必要はありません。制限を無効にする別の方法として、<clickhouse-path>/flags/force_drop_table ファイルを作成することもできます。
値 0 は、パーティションを制限なく削除できることを意味します。この制限は drop table や truncate table には適用されません。max_table_size_to_drop を参照してください。
例

max_parts_cleaning_thread_pool_size

非アクティブなデータパーツを同時に削除するためのスレッド数。

max_per_cpu_untracked_memory

1 つの CPU 上で実行中のすべてのスレッドが、memory tracker にフラッシュされる前に一度に保持できる未追跡メモリ量の上限を、バイト単位で指定します。max_untracked_memory は単一スレッドを制限するのに対し、これは CPU ごとの合計を制限するため、多数のスレッドが各スレッドの許容量を積み上げてサーバー全体で大きなオーバーコミットを引き起こすことを防ぎます。したがって、未追跡メモリの合計はおおむね number_of_cpus * max_per_cpu_untracked_memory によって制限されます。値 0 は CPU ごとの上限を無効にします (スレッドごとの max_untracked_memory のみが適用されます) 。Linux のみ。

max_session_timeout

セッションの最大タイムアウト時間 (秒) 。 例:

max_temporary_data_on_disk_size

外部集約、JOIN、またはソートで使用できるディスク容量の上限です。 この上限を超えるクエリは、例外が発生して失敗します。
0 は無制限を意味します。
関連項目:

max_unexpected_parts_loading_thread_pool_size

起動時に、非アクティブなデータパーツ群 (Unexpected なもの) を読み込むためのスレッド数です。

max_waiting_queries

同時に待機できるクエリの総数の上限です。 必要なテーブルが非同期に読み込まれている間は、待機中のクエリの実行はブロックされます (async_load_databases を参照) 。
以下の設定で制御される上限を確認する際、待機中のクエリはカウントされません。これは、server の起動直後にこれらの上限に達するのを防ぐための補正です。
0 (デフォルト) は無制限を意味します。この設定は実行時に変更でき、変更は即座に反映されます。すでに実行中のクエリには影響しません。

max_zookeeper_pooled_connections

共有プール内で、ZooKeeper クラスターごとに遅延初期化される ZooKeeper セッションの最大数。 0 を指定すると、プールされた接続は無効になり、単一のセッションを使用し続けます。
最終更新日 2026年9月26日