clickhouse-backup

ClickHouse 备份与恢复工具

补充说明

clickhouse-backup 是第三方工具，通过 ClickHouse 的备份接口或文件复制创建、上传和恢复备份。它支持本地目录和 S3 等远端存储。

常用示例

clickhouse-backup create
clickhouse-backup create my_backup
clickhouse-backup list
clickhouse-backup upload my_backup
clickhouse-backup download my_backup
clickhouse-backup restore my_backup
clickhouse-backup restore_remote my_backup
clickhouse-backup delete local my_backup
clickhouse-backup create_remote my_backup

配置通常在 /etc/clickhouse-backup/config.yml：

general:
  remote_storage: s3
clickhouse:
  host: localhost
  port: 9000
s3:
  bucket: my-clickhouse-backups
  region: ap-southeast-1

易错点与排错

• 它是第三方工具，版本要和 ClickHouse 版本匹配；升级前先验证。
• 恢复通常要求表结构和版本兼容；跨大版本恢复可能失败。
• 备份和恢复需要足够磁盘空间；本地备份也会占用数据目录附近空间。
• S3 凭据、权限和端点配置错误会导致上传/下载失败。
• 复制表要确认备份范围和副本协调，避免恢复后数据不一致。
• 大表备份可能影响 I/O 和查询；安排在低峰并限速。
• 恢复前停止写入或切流量；恢复后校验行数和关键查询。
• 定期做恢复演练，不要只看备份文件生成成功。

相关命令

• clickhouse-server — 服务端
• clickhouse-client — 验证数据
• aws — S3 权限排查