解决PgBackRest不支持PostgresPro标准版16的问题

PgBackRest作为PostgreSQL生态中一款优秀的备份恢复工具，在实际使用过程中可能会遇到与某些PostgreSQL分支版本的兼容性问题。本文将详细介绍如何解决PgBackRest不支持PostgresPro标准版16的问题。

问题现象

当用户尝试使用PgBackRest为PostgresPro标准版16创建stanza时，会遇到如下错误提示：

WARN: unable to check pg1: [VersionNotSupportedError] unexpected control version = 1347421460 and catalog version = 202308051
HINT: is this version of PostgreSQL supported?

这表明PgBackRest无法识别PostgresPro标准版16的版本信息，导致无法正常创建备份stanza。

问题原因

PostgresPro作为PostgreSQL的一个分支版本，其内部版本控制机制与官方PostgreSQL有所不同。虽然PostgresPro标准版16基于PostgreSQL 16.2开发，但其版本号标识方式存在差异：

1. 命令行显示的版本号为"postgres (PostgreSQL) 16.2"
2. 但通过SQL查询server_version_num得到的值为160002
3. 控制文件中的版本号为1347421460

这种差异导致PgBackRest无法正确识别数据库版本，从而抛出版本不支持的警告。

解决方案

PgBackRest提供了pg-version-force参数来解决此类分支版本的兼容性问题。具体配置方法如下：

1. 在stanza配置中添加以下参数：

pg-version-force=16

2. 这个参数会强制PgBackRest使用指定的PostgreSQL主版本号(16)进行操作，而不再依赖自动检测的版本信息。

注意事项

1. 确保server_version_num查询结果与强制设置的版本号匹配。对于PostgresPro标准版16，select setting from pg_settings where name = 'server_version_num'应返回160002。

2. 该参数只需要在stanza级别配置一次，无需为每个pg主机单独设置。

3. 此解决方案适用于PostgreSQL的各种分支版本和开发版本，当自动版本检测失败时都可以尝试使用。

总结

通过合理使用pg-version-force参数，可以解决PgBackRest与PostgresPro等PostgreSQL分支版本的兼容性问题。这种方案不仅适用于PostgresPro标准版16，也可用于其他因版本标识差异导致PgBackRest无法正常工作的场景。

对于数据库管理员来说，了解这类问题的解决思路有助于在遇到类似兼容性问题时快速找到解决方案，确保备份系统的正常运行。