BACKUP STATUS

查看当前备份状态。

语法

BACKUP STATUS

引入版本:8.10.0

复杂度摘要:O(1)

报告当前备份状态。

示例

127.0.0.1:6379> BACKUP STATUS
1) "state"
2) "incrementing"
3) "error"
4) ""
5) "start_time"
6) "1717921800"
7) "end_time"
8) "0"

详细说明

BACKUP STATUS 报告备份状态机的当前状态以及时序和错误信息。回复包含以下字段:

田野 说明
state 当前备份状态(见下文)。
error 备份失败时的错误提示;否则为空字符串。
start_time 当前备份开始时的Unix时间,以秒为单位;如果没有开始备份,则为 0。
end_time 当前备份被密封时的Unix时间,以秒为单位; 0 如果没有被密封。

state 字段是以下之一:

状态 说明
idle 没有正在进行备份。
pending 已请求备份,但正在等待仅附加文件重写 (AOFRW) 变得可用。
snapshotting Redis 正在生成 BASE 快照。
incrementing BASE 快照已完成并已固定; Redis 正在累积增量写入并等待密封。
sealed 备份被冻结;文件集是完整且不可变的,正在等待数据平面的消耗和清理。
failed 备份失败或中止。可以开始新的备份。

对于轻量级监控,INFO persistence 还公开 backup_in_progress 布尔值。完整备份状态、错误和时间戳只能通过 BACKUP STATUS 获得。

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

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

数组回复:描述当前备份状态的字段值对的平面数组。

RESP3

地图回复:字段到描述当前备份状态的值的映射。

参见

BACKUP START | BACKUP SEAL | BACKUP LIST | BACKUP ABORT | BACKUP CLEANUP

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