首页/数据/NoSQL 速查/BACKUP / RESTORE 备份命令
ClickHouse56 条

BACKUP / RESTORE 备份命令

ClickHouse 提供 SQL 级 BACKUP/RESTORE:目标可以是本地磁盘、文件或对象存储;支持整库、单表与增量(append 到同一备份路径),执行进度记录在 system.backups。

NoSQL 速查数据更新于 2026-10-12
语法BACKUP TABLE db.t TO Disk('backups', 't.zip');RESTORE TABLE … FROM …
范围TABLE / DICTIONARY / DATABASE,可按分区 PARTITION 备份
进度system.backups 的 status、num_files、total_size、error

示例

示例
BACKUP TABLE analytics.events
TO Disk('backups', 'events-2024-07.zip');

RESTORE TABLE analytics.events
FROM Disk('backups', 'events-2024-07.zip');

SELECT status, num_files, formatReadableSize(total_size) AS size
FROM system.backups
ORDER BY start_time DESC LIMIT 5;
备份目标要先在 storage_configuration 里定义好磁盘;对象存储备份依赖对应集成配置。

易错点

  • 备份与恢复都占用 IO,大库备份放在低峰并监控磁盘水位
  • 恢复目标表存在时默认报错,需要重建命名空间或先删除目标表

数据来源与参考

  • ClickHouse Docs: BACKUP and RESTORE
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌