WAL-G 3.0.10:wal-send 让备库直接从对象存储拉 WAL,delete target 现在能删永久备份
项目地址:
本次发布页:
WAL-G 是面向 PostgreSQL、Apache Cloudberry、MySQL/MariaDB、MongoDB、Redis 等数据库的开源备份恢复工具。3.0.10 发布于 2026-11-18,PostgreSQL 侧的主要新增内容如下。
wal-send:把对象存储当作 WAL 源
wal-send 通过 PostgreSQL 流复制协议提供归档 WAL,备库和 pg_receivewal 可以直接从对象存储读取 WAL,并持续跟随新到达的日志段。
相比“先从对象存储把 WAL 下载到本地,再用普通文件或 restore_command 提供出去”的做法,它省去了中间落盘和自建 WAL 分发服务的环节。典型用法集中在以下三类场景:
- 延迟备库:归档链路已经存在于对象存储中,可以让备库延迟跟随主库。
- 迁移:新实例不必等主库推流,可以直接从已有的归档开始恢复。
- 跨云拉起备库:对象存储本身跨区域可访问,因此 WAL 源可以随备份一起迁移。
限制需要注意,不能把对象存储当作无条件的 WAL 源:
- 它使用的是流复制协议,而不是普通 HTTP 文件服务;客户端一侧必须能按复制协议建立连接。因此,能否直接使用取决于客户端一侧的支持情况。
- 归档链路本身仍然必须可用。归档一旦中断,对象存储中就不会出现新的 WAL 段;此时
wal-send只能继续沿用已有的 WAL 段,这不会改善 WAL 的可用性。 - 发布说明没有给出延迟和吞吐基准。是否满足 RPO/RTO 要求,需要在自己的对象存储和网络条件下实际测量。
命令形式参考发布说明,具体 flag 需要按 release 说明使用,未逐项实测:
wal-g wal-send
backup-push --wait-for-archive
可选的 --wait-for-archive 会在把备份标记为完成之前,等待该备份所需的全部 WAL 段到达选定的备份存储(#2722)。
wal-g backup-push /var/lib/postgresql/data --wait-for-archive
这个选项把“备份成功”的含义从“数据文件已经上传”收紧为“数据文件以及恢复所需的 WAL 都已经在存储上”。代价是 backup-push 的返回时间取决于归档进度;归档一旦卡住,备份操作也会跟着卡住。因此,它更适合放在有超时和告警的调度器中运行。
归档流水线与并发细节
守护进程模式下的持续 WAL 归档将流水线保持在请求之间运行,并保留预读状态,从而减少目录扫描(#2697、#2698)。另外还有几处与正确性相关的改动:
- 上传前先预留备份名称,避免并发操作重用同一名称(#2707)。
- WAL 预取文件仅在下载成功后才对外可见(#2696)。
- 上传失败后关闭 WAL 源文件(#2695)。
catchup-push --from-lsn支持标准X/XLSN 记法(#2643)。
S3 改用 AWS SDK v2
S3 后端改用 AWS SDK v2,并增加了可配置的请求超时、可重试错误码与校验和设置。备份复制可以使用 S3 服务端复制,并配置传输并发度。对于配置中依赖旧 SDK 行为的部分,例如自定义 endpoint、重试和校验和,升级后值得回归验证一遍。
Greenplum 与 Cloudberry 的改进包括:按备份统计共享 AO/AOCS/PAX 存储,以及修复 Segment 备份、恢复和复制操作。
需要留意:delete target 现在能删除永久备份
行为变化(#2808):永久备份仍受保留策略保护,不会因为 retention 被删除;但显式执行 delete target 现在可以将其删除。
这是本次最需要排查的一条。原先后台清理流程(retention)和显式删除是两条相互独立的路径,永久标记相当于一道兜底;升级后,这道兜底只对自动清理有效。如果你的清理脚本为了省事,用 delete target 按时间或前缀批量删除,那么脚本覆盖范围内的永久备份也会被一并删除,而且不会警告。建议在升级前检查所有会调用 delete target 的定时任务和运维手册,并在清理前后核对 backup-list 中的永久备份是否仍然存在。
代价是双向的:需要真正删除一个永久备份时,不必再绕开工具手工处理对象存储;但这也意味着永久标记不再是一道一旦打上就无需再管的保护。
GitHub 发布页:
项目地址: