跳转到主要内容
本文介绍如何通过 S3 端点将备份保存到 S3 存储桶, 或从 S3 存储桶恢复备份。

语法

有关各命令的详细信息,请参见”命令摘要”

使用示例

备份到 S3 端点的增量备份

在本示例中,我们将先把备份创建到 S3 端点,然后再从中恢复。
有关全量备份与增量备份之间差异的说明,请参见”备份类型”
使用此方法时,你需要以下信息:
有关创建 S3 存储桶的说明,请参见”将 S3 对象存储用作 ClickHouse 磁盘”
备份的目标端指定如下:

1

准备

创建以下数据库和表,并向其中插入一些随机数据:
2

创建基础备份

增量备份需要先有一个基础备份作为起点。S3 目标端的第一个参数是 S3 端点,后面是 bucket 中 用于存放此次备份的目录。在这个示例中,该目录名为 my_backup运行以下命令以创建基础备份:
3

添加更多数据

增量备份记录的是基础备份与正在备份的表当前内容之间的差异。在执行 增量备份之前,请先添加更多数据:
4

执行增量备份

此备份命令与基准备份类似,但增加了 SETTINGS base_backup 和基准备份的位置。请注意,增量备份的目标端与基准备份不在同一目录中,而是位于同一端点下、bucket 内的另一个目标目录。基准备份位于 my_backup,增量备份将写入 my_incremental
5

从增量备份中恢复

此命令会将增量备份恢复到新表 test_table_restored 中。 请注意,恢复增量备份时,也会一并包含基准备份。 恢复时只需指定增量备份
6

验证行数

原始表 data 中进行了两次插入:一次插入了 1,000 行,另一次插入了 100 行,共计 1,100 行。 请验证恢复后的表有 1,100 行:
7

验证内容

这里会比较原始表 test_table 与已恢复表 test_table_restored 的内容:
最后修改于 2026年6月19日