backup_* 服务器设置 - ClickHouse Documentation

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

backup_log

用于配置 backup_log 系统表，以记录 BACKUP 和 RESTORE 操作的日志。以下设置可通过子标签配置：

Setting	Description	Default	Note
`database`	数据库名称。
`table`	系统表名称。
`engine`	系统表的 MergeTree 引擎定义。		如果已定义 `partition_by` 或 `order_by`，则不能使用。如果未指定，默认使用 `MergeTree`
`partition_by`	系统表的自定义分区键。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `partition_by` 参数
`ttl`	指定表的生存时间 (TTL)。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `ttl` 参数
`order_by`	系统表的自定义排序键。如果定义了 `engine`，则不能使用。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `order_by` 参数
`storage_policy`	该表使用的存储策略名称 (可选) 。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `storage_policy` 参数
`settings`	控制 MergeTree 行为的附加参数 (可选) 。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `settings` 参数
`flush_interval_milliseconds`	将数据从内存缓冲区刷写到表的时间间隔。	`7500`
`max_size_rows`	日志的最大行数。当未刷写的日志数量达到 max_size 时，日志会被转储到磁盘。	`1048576`
`reserved_size_rows`	为日志预分配的内存行数。	`8192`
`buffer_size_rows_flush_threshold`	行数阈值。达到该阈值后，会在后台启动将日志刷写到磁盘的操作。	`max_size_rows / 2`
`flush_on_crash`	设置在发生崩溃时是否将日志转储到磁盘。	`false`

此外，以下服务器级设置控制所有系统日志表的默认刷写策略：

<default_system_log_flush_policy>
    <skip_alias_columns>true</skip_alias_columns>
</default_system_log_flush_policy>

设置	描述	默认值
`skip_alias_columns`	为 `true` 时，系统日志表的 schema 中会省略 ALIAS 列。S3 支持的系统日志需要启用此项。	`false`

示例

<clickhouse>
    <backup_log>
        <database>system</database>
        <table>backup_log</table>
        <flush_interval_milliseconds>1000</flush_interval_milliseconds>
        <partition_by>toYYYYMM(event_date)</partition_by>
        <max_size_rows>1048576</max_size_rows>
        <reserved_size_rows>8192</reserved_size_rows>
        <buffer_size_rows_flush_threshold>524288</buffer_size_rows_flush_threshold>
        <flush_on_crash>false</flush_on_crash>
        <!-- <engine>Engine = MergeTree PARTITION BY event_date ORDER BY event_time TTL event_date + INTERVAL 30 day</engine> -->
    </backup_log>
</clickhouse>

backup_threads

用于执行 BACKUP 请求的最大线程数。

最后修改于 2026年7月23日