手动实现备份及恢复

ClickHouse 允许使用 ALTER TABLE … FREEZE PARTITION … 查询以创建表分区的本地副本。这是利用硬链接(hardlink)到 /var/lib/clickhouse/shadow/ 文件夹中实现的,所以它通常不会

因为旧数据而占用额外的磁盘空间。 创建的文件副本不由 ClickHouse 服务器处理,所以不需要任何额外的外部系统就有一个简单的备份。防止硬件问题,最好将它们远程复制到另一个位置,然后删除本地副本。

创建备份路径

(1)创建用于存放备份数据的目录 shadow

  1. sudo mkdir -p /var/lib/clickhouse/shadow/
  2. chown clickhouse:clickhouse /var/lib/clickhouse/shadow/

如果目录存在,先清空目录下的数据

执行备份命令

  1. echo -n 'alter table t_order_mt freeze' | clickhouse-client

将备份数据保存到其他路径

  1. #创建备份存储路径
  2. sudo mkdir -p /var/lib/clickhouse/backup/
  3. #拷贝数据到备份路径
  4. sudo cp -r /var/lib/clickhouse/shadow/ /var/lib/clickhouse/backup/my-backup-name
  5. #为下次备份准备,删除 shadow 下的数据
  6. sudo rm -rf /var/lib/clickhouse/shadow/*

恢复数据

(1)模拟删除备份过的表

  1. echo ' drop table t_order_mt ' | clickhouse-client

(2)重新创建表

  1. create table t_order_mt(
  2. id UInt32,
  3. sku_id String,
  4. total_amount Decimal(16,2),
  5. create_time Datetime
  6. ) engine = MergeTree
  7. partition by toYYYYMMDD(create_time)
  8. primary key (id)
  9. order by (id,sku_id);

(3)将备份复制到 detached 目录

  1. sudo cp -rl /var/lib/clickhouse/backup/my-backup-name/1/store/ef9/ef9ccf81-dab6-4d66-8b04-f850b56f6ecf/* /var/lib/clickhouse/data/default/t_order_mt/detached/
  2. chown -R clickhouse:clickhouse /var/lib/clickhouse/

ClickHouse 使用文件系统硬链接来实现即时备份,而不会导致 ClickHouse 服务停机(或锁定)。这些硬链接可以进一步用于有效的备份存储。在支持硬链接的文件系统(例如本地文件系统或 NFS)上,将 cp 与-l 标志一起使用(或将 rsync 与–hard-links 和–numeric-ids 标志一起使用)以避免复制数据。

注意:仅拷贝分区目录,注意目录所属的用户要是 clickhouse

(4)执行 attach

分区编号在 /var/lib/clickhouse/backup/my-backup-name/ 里面一层层进去查

  1. echo ' alter table t_order_mt attach partition 20200601 ' | clickhouse-client

(5)查看数据

  1. echo 'select count() from t_order_mt' | clickhouse-client

使用 clickhouse-backup

上面的过程,我们可以使用 Clickhouse 的备份工具 clickhouse-backup 帮我们自动化实现。

工具地址:https://github.com/AlexAkulov/clickhouse-backup/

上传并安装

将 clickhouse-backup-1.0.0-1.x86_64.rpm 上传至/opt/software/目录下,安装:

  1. $ sudo rpm -ivh clickhouse-backup-1.0.0-1.x86_64.rpm

配置文件

  1. $ cat /etc/clickhouse-backup/config.yml

创建备份

(1)查看可用命令

  1. $ clickhouse-backup help

(2)显示要备份的表

  1. $ clickhouse-backup tables

(3)创建备份

  1. $ sudo clickhouse-backup create

(4)查看现有的本地备份

  1. $ sudo clickhouse-backup list

备份存储在中/var/lib/clickhouse/backup/BACKUPNAME。备份名称默认为时间戳,但是可以选择使用–name 标志指定备份名称。备份包含两个目录:一个“metadata”目录,其中包

含重新创建架构所需的 DDL SQL 语句;以及一个“shadow”目录,其中包含作为 ALTER TABLE …FREEZE 操作结果的数据。

从备份恢复数据

(1)模拟删除备份过的表

  1. echo 'drop table t_order_rmt' | clickhouse-client

(2)从备份还原

  1. sudo clickhouse-backup restore 2021-07-25T23-14-50
  2. --schema 参数:只还原表结构。
  3. --data 参数:只还原数据。
  4. --table 参数:备份(或还原)特定表。也可以使用一个正则表达式,例如,针对特定的数据库:--table=dbname.*。

其他说明

(1)API 文档:https : //github.com/AlexAkulov/clickhouse-backup#api

(2)注意事项:切勿更改文件夹/var/lib/clickhouse/backup 的权限,可能会导致数据损

坏。

(3)远程备份

➢较新版本才支持,需要设置 config 里的 s3 相关配置

➢上传到远程存储:sudo clickhouse-backup upload xxxx

➢从远程存储下载:sudo clickhouse-backup download xxxx

➢保存周期: backups_to_keep_local,本地保存周期,单位天

backups_to_keep_remote,远程存储保存周期,单位天

  1. 0 均表示不删除