Skip to main content
这些设置可在 system.settings 中找到,并由 源代码 自动生成。

distributed_cache_alignment

仅在 ClickHouse Cloud 中生效。此设置仅用于测试,请勿更改

distributed_cache_bypass_connection_pool

仅在 ClickHouse Cloud 中生效。允许绕过分布式缓存连接池。

distributed_cache_connect_backoff_max_ms

仅在 ClickHouse Cloud 中生效。分布式缓存创建连接时的最大退避毫秒数。

distributed_cache_connect_backoff_min_ms

仅在 ClickHouse Cloud 中生效。分布式缓存创建连接时的最小退避毫秒数。

distributed_cache_connect_max_tries

仅在 ClickHouse Cloud 中生效。连接分布式缓存失败时的重试次数

distributed_cache_connect_timeout_ms

仅在 ClickHouse Cloud 中生效。连接到 Distributed Cache 服务器时的连接超时。

distributed_cache_credentials_refresh_period_seconds

仅在 ClickHouse Cloud 中生效。凭证刷新周期。

distributed_cache_data_packet_ack_window

仅在 ClickHouse Cloud 中生效。用于在单个分布式缓存读取请求中为 DataPacket 序列发送 ACK 的窗口大小

distributed_cache_discard_connection_if_unread_data

仅在 ClickHouse Cloud 中生效。如果存在未读取的数据,则断开连接。

distributed_cache_fetch_metrics_only_from_current_az

仅在 ClickHouse Cloud 中生效。在 system.distributed_cache_metrics 和 system.distributed_cache_events 中,仅从当前可用区拉取指标。

distributed_cache_file_cache_name

仅在 ClickHouse Cloud 中生效。此设置仅用于 CI 测试,用于指定分布式缓存使用的文件系统缓存名称。

distributed_cache_log_mode

仅在 ClickHouse Cloud 中生效。用于写入 system.distributed_cache_log 的模式

distributed_cache_max_unacked_inflight_packets

仅在 ClickHouse Cloud 中生效。单个分布式缓存读取请求中处于传输中的未确认数据包的最大数量

distributed_cache_min_bytes_for_seek

仅在 ClickHouse Cloud 中生效。分布式缓存中执行寻道的最小字节数。

distributed_cache_pool_behaviour_on_limit

仅在 ClickHouse Cloud 中生效。用于指定分布式缓存连接在达到连接池限制时的行为

distributed_cache_prefer_bigger_buffer_size

仅在 ClickHouse Cloud 中有效。与 filesystem_cache_prefer_bigger_buffer_size 相同,但适用于分布式缓存。

distributed_cache_read_only_from_current_az

仅在 ClickHouse Cloud 中生效。允许只从当前可用区读取数据。若禁用,则会从所有可用区中的所有缓存服务器读取。

distributed_cache_read_request_max_tries

仅在 ClickHouse Cloud 中生效。分布式缓存读取请求失败时的最大重试次数

distributed_cache_receive_response_wait_milliseconds

仅在 ClickHouse Cloud 中生效。从分布式缓存接收请求数据的等待时间 (毫秒) 。

distributed_cache_receive_timeout_milliseconds

仅在 ClickHouse Cloud 中生效。以毫秒为单位,表示从分布式缓存接收任意类型响应的等待时间。 Cloud 默认值:20000

distributed_cache_receive_timeout_ms

仅在 ClickHouse Cloud 中生效。该设置表示从 Distributed Cache 服务器接收数据的超时时间,单位为毫秒。如果在此时间间隔内未接收到任何字节,则会抛出异常。

distributed_cache_registry_show_certificate_and_signature

仅在 ClickHouse Cloud 中生效。显示 system.distributed_cache_registry 表中的 certificatesignature 列。默认情况下,这些列为空,以保持输出简洁;启用此设置可查看其内容。

distributed_cache_send_timeout_ms

仅在 ClickHouse Cloud 中生效。向 Distributed Cache 服务器发送数据的超时时间,单位为毫秒。如果客户端需要发送数据,但在此时间间隔内无法发送任何字节,则会抛出异常。

distributed_cache_tcp_keep_alive_timeout_ms

仅在 ClickHouse Cloud 中生效。该值表示在 TCP 开始发送 keepalive 探测之前,与 Distributed Cache 服务器的连接需保持空闲的时间 (毫秒) 。

distributed_cache_throw_on_error

仅在 ClickHouse Cloud 中生效。若在与分布式缓存通信期间发生异常,或收到来自分布式缓存的异常,则重新抛出该异常。否则,出错时回退为跳过分布式缓存。

distributed_cache_use_clients_cache_for_read

仅在 ClickHouse Cloud 中生效。对读取请求使用 clients cache。

distributed_cache_wait_connection_from_pool_milliseconds

仅在 ClickHouse Cloud 中生效。当 distributed_cache_pool_behaviour_on_limit 为 wait 时,表示从连接池中获取连接的等待时间,单位为毫秒。

distributed_cache_write_request_max_tries

仅在 ClickHouse Cloud 中生效。分布式缓存写入请求失败时的重试次数
最后修改于 2026年7月24日