备份恢复
备份
备份是指将数据库中的用户数据和元数据复制到指定位置的过程,用于在数据丢失、损坏或系统故障时恢复数据。
KaiwuDB 开发者中心支持对时序数据和关系数据进行不同粒度的备份,具体包括:
- 引擎级备份: 备份整个时序引擎或关系引擎下的所有数据库
- 数据库级备份: 备份指定数据库下的所有表
- 表级备份: 备份指定的单个表
KaiwuDB 开发者中心支持全量备份和增量备份两种备份策略:
- 全量备份: 备份指定对象的完整数据,适用于首次备份或需要完整数据副本的场景
- 增量备份: 仅备份自上次备份后新增或修改的数据,有效减少备份时间和存储空间占用。
时序数据备份说明:
- 历史数据处理: 首次备份后写入的历史数据(时间戳早于备份时间)不会被后续增量备份捕获,历史数据的删除操作也无法被增量备份记录
- 备份时间窗口: 备份任务开始后,时间戳晚于备份开始时间的新写入数据不会包含在本次备份中
增量备份说明: 执行增量备份时,必须按时间顺序指定所有相关的备份路径(包括全量备份和之前的所有增量备份),以确保备份链的完整性。
版本兼容性说明:备份文件不支持跨大版本恢复(如 3.0.x ↔ 3.1),同一大版本内的小版本支持互相恢复
备份引擎
前提条件
- 非三权分立模式下,用户是
admin角色的成员。默认情况下,root用户属于admin角色。 - 三权分立模式下,用户是
sysadmin角色的成员。默认情况下,sysroot用户属于sysadmin角色。
步骤
在数据库导航区,右键单击需要备份的数据源连接,然后选择工具 > 备份时序引擎或备份关系引擎。

在备份窗口,选择是否进行增量备份(未选择表示进行全量备份),根据提示设置备份文件路径,然后单击开始。设置完成后即可在备份进度页查看备份进度。
说明
选择增量备份后,需要同时设置
备份文件路径(全量备份路径)和增量备份文件路径。
备份数据库
前提条件
- 非三权分立模式下,用户是
admin角色的成员。默认情况下,root用户属于admin角色。 - 三权分立模式下,用户是
sysadmin角色的成员。默认情况下,sysroot用户属于sysadmin角色。
步骤
如需备份数据库,遵循以下步骤:
在数据库导航区,右键单击需要备份的时序数据库或关系数据库,然后选择工具 > 备份。

在备份窗口,选择是否进行增量备份(未选择表示进行全量备份),根据提示设置备份文件路径,然后单击开始。设置完成后即可在备份进度页查看备份进度。
说明
选择增量备份后,需要同时设置
备份文件路径(全量备份路径)和增量备份文件路径。
备份表
前提条件
- 非三权分立模式下,用户是
admin角色的成员。默认情况下,root用户属于admin角色。 - 三权分立模式下,用户是
sysadmin角色的成员。默认情况下,sysroot用户属于sysadmin角色。
步骤
如需备份指定表,遵循以下步骤:
在数据库导航区,右键单击需要备份的时序表或关系表,然后选择工具 > 备份。

在备份窗口,选择是否进行增量备份(未选择表示进行全量备份),根据提示设置备份文件路径,然后单击开始。设置完成后即可在备份进度页查看备份进度。
说明
选择增量备份后,需要同时设置
备份文件路径(全量备份路径)和增量备份文件路径。
恢复
恢复指将备份文件中的数据和元数据恢复到数据库系统中的过程,使目标对象恢复到备份时的状态。
KaiwuDB 开发者中心支持对时序数据和关系数据进行不同粒度的恢复,具体包括:
- 引擎级恢复: 恢复整个时序引擎或关系引擎下的所有数据库
- 数据库级恢复: 恢复指定数据库下的所有表
- 表级恢复: 恢复指定的单个表
KaiwuDB 开发者中心支持全量恢复和增量恢复两种恢复策略:
- 全量恢复: 从单个全量备份文件夹完全恢复目标对象到该备份时间点的状态
- 增量恢复: 按时间顺序依次应用多个备份文件夹(全量备份 + 增量备份),恢复到最后一个增量备份的时间点状态
功能说明:
- 任务中断处理: 暂停全量恢复任务后,如需恢复执行,必须先手动清理目标文件夹中已生成的临时文件,否则恢复操作将失败
- 备份链完整性要求:增量恢复依赖完整的备份链,缺少任何一个备份文件都会导致恢复失败
- 关系数据恢复要求:执行增量恢复时,需要先删除目标对象,然后按备份顺序列举所有备份文件路径
- 版本兼容性说明:备份文件不支持跨大版本恢复(如 3.0.x ↔ 3.1),同一大版本内的小版本支持互相恢复
恢复引擎
前提条件
- 非三权分立模式下,用户是
admin角色的成员。默认情况下,root用户属于admin角色。 - 三权分立模式下,用户是
sysadmin角色的成员。默认情况下,sysroot用户属于sysadmin角色。
步骤
在数据库导航区,右键单击需要恢复的数据源连接,然后选择工具 > 恢复时序引擎或恢复关系引擎。

在恢复窗口,根据需要选择是否进行增量恢复(未选择表示进行全量恢复),根据提示设置备份文件路径,然后单击开始。设置完成后即可在恢复进度页查看恢复进度。
说明
选择增量恢复后,需要同时设置
备份文件路径(全量备份路径)和增量备份文件路径。
恢复数据库
前提条件
- 非三权分立模式下,用户是
admin角色的成员。默认情况下,root用户属于admin角色。 - 三权分立模式下,用户是
sysadmin角色的成员。默认情况下,sysroot用户属于sysadmin角色。
步骤
在数据库导航区,右键单击需要恢复的时序数据库或关系数据库,然后选择工具 > 恢复。

在恢复窗口,根据需要选择是否进行增量恢复(未选择表示进行全量恢复),根据提示设置备份文件路径和数据库名,然后单击开始。设置完成后即可在恢复进度页查看恢复进度。
说明
选择增量恢复后,需要同时设置
备份文件路径(全量备份路径)和增量备份文件路径。
恢复表
前提条件
- 非三权分立模式下,用户是
admin角色的成员。默认情况下,root用户属于admin角色。 - 三权分立模式下,用户是
sysadmin角色的成员。默认情况下,sysroot用户属于sysadmin角色。
步骤
在数据库导航区,右键单击需要恢复的时序表或关系表,然后选择工具 > 恢复。

在恢复窗口,根据需要选择是否进行增量恢复(未选择表示进行全量恢复),根据提示设置备份文件路径和表面,然后单击开始。设置完成后即可在恢复进度页查看恢复进度。
说明
选择增量恢复后,需要同时设置
备份文件路径(全量备份路径)和增量备份文件路径。