Skip to main content
这些设置用于配置 ClickHouse 服务器,且由 ClickHouse 源代码自动生成。

max_active_parts_loading_thread_pool_size

启动时用于加载活动数据分区片段集合的线程数。

max_authentication_methods_per_user

创建用户时可配置,或修改用户时可更改为的最大身份验证方法数量。 更改此设置不会影响现有用户。如果与身份验证相关的创建/修改查询超出此设置指定的限制,则会失败。 与身份验证无关的创建/修改查询将成功。
值为 0 表示无限制。

max_backup_bandwidth_for_server

server 上所有备份的最大读取速度 (单位:字节/秒) 。0 表示无限制。

max_build_vector_similarity_index_thread_pool_size

用于构建向量索引的最大线程数。
值为 0 表示使用所有 CPU 核心。

max_connections

服务器最大连接数。

max_entries_for_hash_table_stats

聚合期间允许收集的哈希表统计信息的最大条目数

max_fetch_partition_thread_pool_size

用于 ALTER TABLE FETCH PARTITION 的线程数。

max_held_snapshots

可同时持有的轻量级快照的最大数量。零表示无限制。如果快照数量达到此限制,则在尝试创建新快照时会抛出异常。

max_http_index_page_size

通过 HTTP 列出目录时,HTTP 索引页响应的最大大小。 如果响应超过此限制,查询会报错并失败。 默认值:10485760 (10 MiB) 。

max_iceberg_manifest_decode_thread_pool_free_size

在用于解码 Iceberg 数据 manifest 文件的线程池中,可保留的空闲备用线程的最大数量。

max_iceberg_manifest_decode_thread_pool_size

用于解码 Iceberg 数据 manifest 文件的最大线程总数。 该 pool 特意与 IO pool 分开:解码 task 可能会阻塞,直到查询消费掉它已产生的 entries;而 delete manifest 的解码则会在任何 entry 被消费之前,先等待其在 IO pool 上的 tasks 完成——共用同一个 pool 可能导致死锁。

max_keep_alive_requests

单个 keep-alive 连接可处理的最大请求数。超过该数量后,连接将由 ClickHouse 服务器 关闭。 示例

max_materialized_views_count_for_table

限制附加到某个表的 materialized views 数量。
这里只考虑直接依赖的视图,不包括在另一个视图之上再创建视图的情况。

max_merges_bandwidth_for_server

server 上所有 merges 的最大读取速度,单位为每秒字节数。0 表示不受限制。

max_mutations_bandwidth_for_server

服务器上所有变更的最大读取速度,以字节/秒为单位。0 表示无限制。

max_open_files

可打开的最大文件数。
建议在 macOS 上使用此选项,因为 getrlimit() 函数返回的值不正确。

max_os_cpu_wait_time_ratio_to_drop_connection

用于判断是否应断开连接时,OS CPU 等待时间 (OSCPUWaitMicroseconds 指标) 与忙碌时间 (OSCPUVirtualTimeMicroseconds 指标) 之间的最大比率。系统会使用最小比率与最大比率之间的线性插值来计算概率;在该比率下,概率为 1。 更多详情,请参见控制服务器 CPU 过载时的行为。

max_outdated_parts_loading_thread_pool_size

启动时用于加载非活动数据分区片段集合 (即过期的数据分区片段) 的线程数。

max_part_num_to_warn

如果活跃 parts 的数量超过指定值,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

在刷新到 memory tracker 之前,单个 CPU 上运行的所有线程可同时持有的未跟踪内存总量上限 (以字节为单位) 。max_untracked_memory 限制的是单个线程,而此设置限制的是每个 CPU 的总量,因此多个线程无法将各自的线程配额叠加成整个服务器范围内的大量 overcommit。因此,未跟踪内存总量大致受限于 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

启动时用于加载非活动数据分区片段集合 (即异常数据分区片段) 的线程数。

max_waiting_queries

对并发等待状态的查询总数进行限制。 当所需表正在异步加载时,等待中的查询会被阻塞,无法执行 (参见 async_load_databases。
在检查以下设置控制的限制时,处于等待状态的查询不会计入其中:这样调整是为了避免在 server 刚启动后立即触及这些限制。
0 (默认值) 表示不受限制。此设置可在运行时修改,并会立即生效。已在运行中的查询不会受到影响。

max_zookeeper_pooled_connections

共享池中每个 ZooKeeper 集群可按需延迟初始化的 ZooKeeper 会话最大数量。 值为 0 时,将禁用池化连接,并继续使用单个会话。