backups_* 服务器设置 - ClickHouse Documentation

这些设置用于配置 ClickHouse 服务器，由 ClickHouse 源代码自动生成。

备份

备份相关设置，用于执行 BACKUP 和 RESTORE 语句时。以下设置可通过子标签进行配置：

设置	类型	描述	默认值
`allow_concurrent_backups`	Bool	决定同一主机上是否允许多个备份操作并发运行。	`true`
`allow_concurrent_restores`	Bool	决定同一主机上是否允许多个恢复操作并发运行。	`true`
`allowed_disk`	String	使用 `File()` 时备份写入的磁盘。必须设置此项才能使用 `File`。	“
`allowed_path`	String	使用 `File()` 时备份写入的路径。必须设置此项才能使用 `File`。	“
`attempts_to_collect_metadata_before_sleep`	UInt	比较已收集的元数据后，如果发现存在不一致，在进入休眠前再次收集元数据的尝试次数。	`2`
`collect_metadata_timeout`	UInt64	备份期间收集元数据的超时时间 (毫秒) 。	`600000`
`compare_collected_metadata`	Bool	如果为 true，则会将收集到的元数据与现有元数据进行比较，以确保它们在备份期间未发生变化。	`true`
`create_table_timeout`	UInt64	恢复期间创建表的超时时间 (毫秒) 。	`300000`
`max_attempts_after_bad_version`	UInt64	在协调备份/恢复过程中遇到 bad version 错误后，允许重试的最大次数。	`3`
`max_sleep_before_next_attempt_to_collect_metadata`	UInt64	下次尝试收集元数据前的最长休眠时间 (毫秒) 。	`100`
`min_sleep_before_next_attempt_to_collect_metadata`	UInt64	下次尝试收集元数据前的最短休眠时间 (毫秒) 。	`5000`
`remove_backup_files_after_failure`	Bool	如果 `BACKUP` 命令失败，ClickHouse 会尝试删除失败前已复制到备份中的文件；否则会保留这些已复制的文件。	`true`
`sync_period_ms`	UInt64	协调备份/恢复的同步周期 (毫秒) 。	`5000`
`test_inject_sleep`	Bool	用于测试的休眠设置	`false`
`test_randomize_order`	Bool	如果为 true，则会出于测试目的随机调整某些操作的顺序。	`false`
`zookeeper_path`	String	使用 `ON CLUSTER` 子句时，在 ZooKeeper 中存储备份和恢复元数据的路径。	`/clickhouse/backups`

此设置默认配置为：

<backups>
    ....
</backups>

backups_io_thread_pool_queue_size

可在备份 IO 线程池中调度的最大作业数。鉴于当前的 S3 备份逻辑，建议将此队列保持为不限制大小。

值为 0 (默认值) 表示不限制。

最后修改于 2026年7月23日