备份管理

KaiwuDB 支持对时序引擎、时序数据库和时序表进行全量备份和增量备份：

• 时序引擎备份：备份时序引擎下所有时序数据库的完整数据，包括元数据、标签数据和指标数据
• 时序数据库备份：备份指定数据库下所有时序表的完整数据，包括元数据、标签数据和指标数据
• 时序表备份：备份指定表的完整数据，包括元数据、标签数据和指标数据

根据备份策略的不同，可以选择：

• 全量备份：备份指定目标的完整数据，适用于首次备份或需要完整数据副本的场景
• 增量备份：仅备份自上次备份以来发生变化的数据，有效减少备份时间和存储空间占用

备份操作通过 BACKUP SQL 语句执行，支持通过作业管理进行监控和控制。有关作业管理的详细信息，参见作业管理。

创建备份任务

所需权限

• 非三权分立模式下，用户是 admin 用户或 admin 角色的成员。默认情况下，root 用户属于 admin 角色。
• 三权分立模式下，用户是 sysadmin 用户或 sysadmin 角色的成员。默认情况下，sysroot 用户属于 sysadmin 角色。

语法格式

参数说明

参数	描述
database_name	要备份的时序数据库名称
table_name	要备份的时序表名称
target_path	备份文件存储路径，格式为 nodelocal://<node_id>/<dir>, 表示将文件导出至本地节点。其中： - node_id 为节点 ID。当本地只有一个节点时，node_id 取值为 1； - dir 为存放备份文件的文件夹名称。如果目标文件夹不存在，系统会在安装时定义的 KaiwuDB 数据目录下创建相应的文件夹。KaiwuDB 默认数据目录为 /var/lib/kaiwudb/extern/<folder_name>
backup_path_list	已完成的存储路径。注意：增量备份需要指定之前所有已完成的备份路径，路径必须按顺序排列，中间用逗号分隔。

语法示例

• 全量备份

  • 备份时序引擎

    BACKUP TS ENGINE TO "nodelocal://1/backup_ts";
    

  • 备份时序数据库

    BACKUP DATABASE db1 TO "nodelocal://1/backup_db1";
    

  • 备份时序表

    BACKUP TABLE tb1 TO "nodelocal://1/backup_tb1";
    

• 增量备份

  • 备份时序引擎

    BACKUP TS ENGINE TO "nodelocal://1/backup_ts/inc2" INCREMENTAL FROM "nodelocal://1/backup_ts/full","nodelocal://1/backup_ts/inc1";
    

  • 备份时序数据库

    BACKUP DATABASE db1 TO "nodelocal://1/backup_db1/inc2" INCREMENTAL FROM "nodelocal://1/backup_db1/full","nodelocal://1/backup_db1/inc1";
    

  • 备份时序表

    BACKUP TABLE tb1 TO "nodelocal://1/backup_tb1/inc2" INCREMENTAL FROM "nodelocal://1/backup_tb1/full","nodelocal://1/backup_tb1/inc1";