Clickhouse备份与恢复+异机远程备份脚本

网友投稿 2026 2023-06-03

Clickhouse备份与恢复+异机远程备份脚本

Clickhouse备份与恢复+异机远程备份脚本

Clickhouse 的数据备份有多种方式，其官方网站上就提供了多种备份方式可以参考，但是不同公司有不同的可用资源和业务需求，因此不存在一个通用的解决方案可以应对各种情况下的***备份和恢复。 适用于 1GB 数据的方案可能并不适用于几十 PB 数据的情况。 有多种具备各自优缺点的可能方法，将在下面对其进行讨论。最好使用几种方法而不是仅仅使用一种方法来弥补它们的各种缺点。

背景：

某项目clickhouse 数据库迁移，数据量大约9亿条单表，版本为clickhouse20，迁移前我先在本地做了一些列的备份测试，下面我把我在生产中选用的备份方法和遇到的种种小插曲和大家分享下

实验环境：

官网下载的demo数据，大约有8G的测试数据

clickhouse 20.4.6

一、 文本文件导入导出

#说白了就是手动的把数据库里的数据导出成特定的格式，再导入;这种方式!!不推荐!!!!除非你的数据库真的很少，我当时从官网下载了一个demo 数据，手动导入导出，差点把我累死

导出：

clickhouse-client --password helloword --query="select * from iot_dev.t_indicator_record FORMAT CSV" > iot_dev.t_indicator_record.csv

导入: 注意FORMAT后面大写

cat iot_dev.t_indicator_record.csv | clickhouse-client --port 9008 --password helloword --query="INSERT INTO iot_dev.t_indicator_record FORMAT CSV"

二、 拷贝数据目录

#此方案和mysql 的冷数据恢复是一个方案，直接拷贝走clickhouse 的数据到另一台机器上，修改下相关配置就可以直接启动了，仔细的观察一下 *** 在文件系统上的目录结构(配置文件

/ect/clickhouse-server/config.xml 里面配置的)，为了便于查看，只保留了 data 和 metadata 目录。

. ├── data │   ├── default │   ├── system │   │   ├── asynchronous_metric_log │   │   ├── metric_log │   │   ├── query_log │   │   ├── query_thread_log │   │   └── trace_log ├── metadata │   ├── default │   │   └── v_table_size.sql │   ├── default.sql │   ├── system │   │   ├── asynchronous_metric_log.sql │   │   ├── metric_log.sql │   │   ├── query_log.sql │   │   ├── query_thread_log.sql │   │   └── trace_log.sql

data 目录里保存的是数据，每个数据库一个目录，内部每个表一个子目录。 metadata 目录里保存的是元数据，即数据库和表结构。其中         .sql 是 创建数据库的 DDL（ATTACH DATABASE default ENGINE = Ordinary）         /

.sql 是建表的 DDL (ATTACH TABLE ...)

基于这个信息，直接把data和metadata目录(要排除 system 库)复制到新集群，即可实现数据迁移

实操步骤：

1、停止原先的clickhouse数据库，并打包好 对应数据库或表的 data 和 metadata 数据 2、拷贝到目标clickhouse数据库对应的目录，比如/var/lib/clickhouse 目录下 3、给clickhouse 赋予权限, chown -Rf clickhouse:clickhouse /var/lib/clickhouse/*                                                       chown -Rf clickhouse:clickhouse /var/lib/clickhouse 4、重启目标clickhouse数据库 5、验证数据         select count(1) form iot_dev.t_indicator_record;

三、 使用第三方工具，clickhouse-backup

此方案，是我在测试的过程中使用最方便的备份与恢复工具，因此我会详细的说下此工具的使用方法及需要注意的地方。

clickhouse-backup 是社区开源的一个 *** 备份工具，可用于实现数据迁移。其原理是先创建一个备份，然后从备份导入数据，类似 MySQL 的 mysqldump + SOURCE。这个工具可以作为常规的异地冷备方案

# 使用限制：

支持1.1.54390以上的***仅MergeTree系列表引擎不支持备份Tiered storage或storage_policy云存储上的最大备份大小为5TBAWS S3上的parts数最大为10,000

(1)、下载clickhouse-backup 软件包

官方提供了二进制版本和rpm包的方式，我这里采用了二进制安装

#解压软件包 tar -xf clickhouse-backup.tar.gz -C /root  #复制二进制文件到系统中 cp /root/clickhouse-backup /usr/bin  #创建clickhouse-backup 配置文件目录 mkdir -p /etc/clickhouse-backup  #拷贝模板配置文件到clickhouse-backup 配置文件目录下 cp /root/config.yml /etc/clickhouse-backup/

(2)、修改clickhouse-backup 配置文件config.yml

# 根据clickhouse自身的配置来修改 此配置文件，比如 clickhouse的数据目录，数据库密码，监控地址及端口

官方的配置说明：

clickhouse-backup 除了备份到本机，此外还支持远程备份的方式，备份到s3 上【对象存储】，ftp，sftp 上，还支持 使用 api 接口 访问

我本次使用的配置文件，就是最简单的配置，直接本地备份，然后通过执行脚本的方式去推送备份文件到备份主机上

[root@localhost clickhouse-backup]# cat config.yml   general:   max_file_size: 1099511627776   disable_progress_bar: false   backups_to_keep_local: 0   backups_to_keep_remote: 0   log_level: info   allow_empty_backups: false clickhouse:   username: default   password: ""   host: localhost   port: 9000   disk_mapping: {}   skip_tables:   - system.*   - default.*   timeout: 5m   freeze_by_part: false   secure: false   skip_verify: false   sync_replicated_tables: true   skip_sync_replica_timeouts: true   log_sql_queries: false

(3)、查看clickhouse-backup 相关命令

1、 查看全部默认的配置项

clickhouse-backup default-config

2、 查看可备份的表【已在配置文件中过滤掉system和default 库下面的所有表】

[root@localhost clickhouse-backup]# clickhouse-backup tablesbrdatasets.hits_v1  1.50GiB  default

3、 创建备份

#全库备份

clickhouse-backup create 2021/09/06 10:03:23  info done                      backup=2021-09-06T14-03-23 operation=create table=datasets.hits_v1 2021/09/06 10:03:23  info done                      backup=2021-09-06T14-03-23 operation=create

备份存储在中 $data_path/backup 下，备份名称默认为时间戳，可手动指定备份名称

clickhouse-backup create fxkjnj_0906

备份包含两个目录：

metadata目录: 包含重新创建所需的DDL SQLshadow目录: 包含作为ALTER TABLE ... FREEZE操作结果的数据

[root@localhost backup]# ll /var/lib/clickhouse/backup/2021-09-06T14-03-23/ total 4 drwxr-x--- 3 clickhouse clickhouse  22 Sep  6 10:03 metadata -rw-r----- 1 clickhouse clickhouse 865 Sep  6 10:03 metadata.json drwxr-x--- 3 clickhouse clickhouse  22 Sep  6 10:03 shadow

#单表备份

clickhouse-backup create [-t, --tables=.

] 

备份表datasets.hits_v1

clickhouse-backup create  -t datasets.hits_v1

备份多个表datasets.hits_v1， datasets.hits_v2

clickhouse-backup create  -t datasets.hits_v1,datasets.hits_v2

4、查看备份记录

[root@localhost datasets]# clickhouse-backup list 2021-09-06T14-03-23   1.50GiB   06/09/2021 14:03:23   local       2021/09/06 10:10:50 error InvalidParameter: 1 validation error(s) found. - minimum field size of 1, ListObjectsV2Input.Bucket.

5、删除备份文件

[root@localhost datasets]# clickhouse-backup delete local 2021-09-06T14-03-23

(4)、数据恢复

语法：

clickhouse-backup restore 备份名

[root@localhost shadow]# clickhouse-backup restore --help NAME:    clickhouse-backup restore - Create schema and restore data from backup  USAGE:    clickhouse-backup restore  [-t, --tables=.

] [-s, --schema] [-d, --data] [--rm, --drop]   OPTIONS:    --config FILE, -c FILE                   Config FILE name. (default: "/etc/clickhouse-backup/config.yml") [$CLICKHOUSE_BACKUP_CONFIG]    --table value, --tables value, -t value      --schema, -s                             Restore schema only    --data, -d                               Restore data only    --rm, --drop                             Drop table before restore

参数：

--table 只恢复特定表，可使用正则。如针对特定的数据库：--table=dbname.*--schema 只还原表结构--data 只还原数据--rm 数据恢复之前，先删除需要恢复的表

四、使用clickhouse-backup备份与恢复数据-实战

4.1 、本机备份与恢复

1、备份前，先查看数据库里的数据量，一共是17747796条数据

1、备份前，先查看数据库里的数据量，一共是17747796条数据 [root@localhost ~]# clickhouse-client *** client version 20.4.6.53 (official build). Connecting to localhost:9000 as user default. Connected to *** server version 20.4.6 revision 54434. localhost :)  localhost :) select count(1) from datasets.hits_v1;  SELECT count(1) FROM datasets.hits_v1  ┌─count(1)─┐ │ 17747796 │ └──────────┘  1 rows in set. Elapsed: 0.016 sec.   localhost :) exit    2、创建clickhouse-backup配置文件，本地备份文件最多保留7个  [root@localhost ~]# vim /etc/clickhouse-backup/config.yml  general:   max_file_size: 1099511627776   disable_progress_bar: false   backups_to_keep_local: 7   log_level: info   allow_empty_backups: false clickhouse:   username: default   password: "helloword"   host: localhost   port: 9000   disk_mapping: {}   skip_tables:   - system.*   - default.*   timeout: 5m   freeze_by_part: false   secure: false   skip_verify: false   sync_replicated_tables: true   skip_sync_replica_timeouts: true   log_sql_queries: false   3、查看可备份的表 [root@localhost backup]# clickhouse-backup tables datasets.hits_v1  1.50GiB  default     4、使用clickhouse-backup 做个备份 [root@localhost clickhouse]# clickhouse-backup create 2021/09/06 10:50:42  info done                      backup=2021-09-06T14-50-42 operation=create table=datasets.hits_v1 2021/09/06 10:50:42  info done                      backup=2021-09-06T14-50-42 operation=create    5、模拟进行数据破坏，！！！生产环境勿用！！！此处为测试 [root@localhost clickhouse]# clickhouse-client  *** client version 20.4.6.53 (official build). Connecting to localhost:9000 as user default. Connected to *** server version 20.4.6 revision 54434.  localhost :) drop database datasets; DROP DATABASE datasets Ok. 0 rows in set. Elapsed: 0.002 sec.   SHOW DATABASES ┌─name───────────────────────────┐ │ _temporary_and_external_tables │ │ default                        │ │ system   │ test └────────────────────────────────┘ 3 rows in set. Elapsed: 0.002 sec.      6、恢复数据库 [root@localhost backup]# clickhouse-backup restore 2021-09-06T14-50-42 -s -d --rm 2021/09/06 10:57:04  info done                      backup=2021-09-06T14-50-42 operation=restore table=datasets.hits_v1 2021/09/06 10:57:04  info done                      backup=2021-09-06T14-50-42 operation=restore   7、验证数据库，查看数据是否复原，数据量是否匹配  [root@localhost backup]# clickhouse-client  *** client version 20.4.6.53 (official build). Connecting to localhost:9000 as user default. Connected to *** server version 20.4.6 revision 54434.  localhost :) show databases;  SHOW DATABASES ┌─name───────────────────────────┐ │ _temporary_and_external_tables │ │ datasets                       │ │ default                        │ │ system                         │ │ test                           │ └────────────────────────────────┘ 5 rows in set. Elapsed: 0.002 sec.   localhost :) select count(1) from datasets.hits_v1;  SELECT count(1) FROM datasets.hits_v1  ┌─count(1)─┐ │ 17747796 │ └──────────┘  1 rows in set. Elapsed: 0.020 sec.   localhost :)

4.2、异机远程备份与恢复

所谓异机远程备份，就是指将备份好的文件，同步传输到远程 专业的存储服务器，往往这些存储服务器都是大存储，可以备份存储1年甚至几年的数据库备份都没问题

环境：

clickhouse 数据库 192.168.99.102

存储服务器 192.168.99.101

1、备份前，先查看数据库里的数据量，一共是17747796条数据 [root@localhost ~]# clickhouse-client *** client version 20.4.6.53 (official build). Connecting to localhost:9000 as user default. Connected to *** server version 20.4.6 revision 54434. localhost :)  localhost :) select count(1) from datasets.hits_v1;  SELECT count(1) FROM datasets.hits_v1  ┌─count(1)─┐ │ 17747796 │ └──────────┘  1 rows in set. Elapsed: 0.016 sec.   localhost :) exit    2、创建clickhouse-backup配置文件，本地备份文件最多保留7个  [root@localhost ~]# vim /etc/clickhouse-backup/config.yml  general:   max_file_size: 1099511627776   disable_progress_bar: false   backups_to_keep_local: 7   log_level: info   allow_empty_backups: false clickhouse:   username: default   password: "helloword"   host: localhost   port: 9000   disk_mapping: {}   skip_tables:   - system.*   - default.*   timeout: 5m   freeze_by_part: false   secure: false   skip_verify: false   sync_replicated_tables: true   skip_sync_replica_timeouts: true   log_sql_queries: false   3、查看可备份的表 [root@localhost backup]# clickhouse-backup tables datasets.hits_v1  1.50GiB  default     4、使用clickhouse-backup 做个备份 [root@localhost clickhouse]# clickhouse-backup create 2021/09/06 10:50:42  info done                      backup=2021-09-06T14-50-42 operation=create table=datasets.hits_v1 2021/09/06 10:50:42  info done                      backup=2021-09-06T14-50-42 operation=create    5、使用SCP 将备份文件，传输到存储服务器上 [root@localhost clickhouse]#  scp -rp /var/lib/clickhouse/backup/2021-09-06T14-50-42 fxkjnj@192.168.99.101:/data/clickhouse-backup/  6、登录到存储服务器 ，查看备份数据是否存在 [root@localhost clickhouse]# ll /data/clickhouse-backup/2021-09-06T14-50-42 total 4 drwxr-x--- 3 clickhouse clickhouse  22 Sep  6 10:50 metadata -rw-r----- 1 clickhouse clickhouse 865 Sep  6 10:50 metadata.json drwxr-x--- 3 clickhouse clickhouse  22 Sep  6 10:50 shadow

五、使用脚本定期异机远程备份

环境： clickhouse 数据库 192.168.99.102 存储服务器 192.168.99.101

条件：

存储服务器 建立备份目录，/data/clickhouse-backclickhouse 数据库 可以免密到 存储服务器 上，免密传输备份文件

六、常见问题

1、问题现象：使用clickhouse-backup 恢复数据时，提示UUID 问题

clickhouse-backup restore 2021-08-21T06-35-10 -s -d --rm 2021/08/21 14:40:51 error can't create table `default`.`t`: code: 57, message:  Directory for table data store/c57/c5780d8a-7d5a-47a3-8578-0d8a7d5a37a3/ already exists after 1 times, please check your schema depencncies

解决方法：

去掉  备份文件中  ${backup_path}/2021-08-21T06-35-10/metadata/default/t.json 中的UUID UUID '80ea6411-9c37-4d47-80ea-64119c374d47'   再次执行恢复 clickhouse-backup restore 2021-08-21T06-35-10 -s -d --rm  SELECT count(1) FROM datasets.hits_v1  ┌─count(1)─┐ │ 17747796 │ └──────────┘  1 rows in set. Elapsed: 0.016 sec.   localhost :) exit

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。

标签：数据迁移 数据库 数据库迁移
上一篇:聊聊MySQL连接控制插件
下一篇:亚马逊推出高性能 PyTorch 数据集库 —— S3 Plugin
相关文章