BACKUP START

在配置的备份目录中启动备份。

语法

BACKUP START

引入版本:8.10.0

复杂度摘要:O(1)

启动新备份,打开备份窗口并在 backupdirname 配置设置指定的目录中生成新的 BASE 快照。

示例

127.0.0.1:6379> BACKUP START
OK

详细说明

BACKUP START 将备份状态机从 idle 移动到 snapshotting,并开始通过仅附加文件重写 (AOFRW) 生成新的 BASE 快照。无论是否启用 AOF 持久化,它都有效:

  • 如果启用了 AOF,Redis 会直接重用现有的 多部分AOF。
  • 如果禁用 AOF,Redis 会临时启动 AOF 机器,而不更改配置的 appendonly 值。
  • 如果 AOFRW 已处于活动状态或已计划并且可以重复使用,则备份将附加到它。
  • 如果另一个子进程处于活动状态,备份将进入 pending 状态,并在 AOMFRW 可以运行时启动。

快照重写完成后,Redis 将 BASE 文件硬链接到备份目录,并进入 incrementing 状态,在此状态下继续累积增量写入,直到调用 BACKUP SEAL。

调用BACKUP START时,备份目录(以backupdirname命名并在Redis工作目录dir下解析)必须为空。一次只能进行一项备份。

有关完整的工作流程和恢复过程,请参阅 Redis持久化。

Redis Software 与 Redis Cloud 兼容性

Redis
软件
Redis
Cloud
说明
❌ 标准
❌主动-主动
❌ 标准
❌主动-主动

返回值

RESP2

简单字符串回复: OK.

RESP3

简单字符串回复: OK.

参见

BACKUP SEAL | BACKUP STATUS | BACKUP LIST | BACKUP ABORT | BACKUP CLEANUP

资料来源:Redis 官方 BACKUP START 文档;中文内容参考 Redis 文档许可。