升级 Redis Software 数据库

提示

来自deepseek解释

原文链接：https://redis.io/docs/latest/operate/rs/installing-upgrading/upgrading/upgrade-database/

默认 Redis 数据库版本

当您升级现有数据库时，它使用最新的捆绑 Redis 版本，除非您通过 REST API 中的 redis_version 选项或 rladmin upgrade db 指定了不同版本。

要查看可用的 Redis 数据库版本：

在 Cluster Manager UI 中，查看 Cluster > Configuration 界面上的 Redis database versions。
发送 GET /nodes REST API 请求，并在响应中查看 supported_database_versions。

默认 Redis 数据库版本在不同 Redis Software 发布版本中有所不同，如下所示：

Redis Software 集群版本	捆绑的 Redis DB 版本	默认 DB 版本（升级/新建数据库）
8.0.20	6.2, 7.2, 7.4, 8.0, 8.2, 8.4, 8.6	8.6
8.0.18	6.2, 7.2, 7.4, 8.0, 8.2, 8.4, 8.6	8.6
8.0.16	6.2, 7.2, 7.4, 8.0, 8.2, 8.4	8.4
8.0.10	6.2, 7.2, 7.4, 8.0, 8.2, 8.4	8.4
8.0.6	6.2, 7.2, 7.4, 8.0, 8.2	8.2
8.0.2	6.2, 7.2, 7.4, 8.0, 8.2	8.2
7.22.x	6.2, 7.2, 7.4	7.4
7.8.x	6.2, 7.2, 7.4	7.4
7.4.x	6.0, 6.2, 7.2	7.2
7.2.4	6.0, 6.2, 7.2	7.2
6.4.2	6.0, 6.2	6.2
6.2.x	6.0, 6.2	6.0

升级前置条件

在升级数据库之前：

查看相关发布说明以了解任何准备说明。
确认当前数据库版本和目标数据库版本均受集群的 Redis Software 版本支持。
要确定当前数据库版本：
- 使用 Cluster Manager UI 打开数据库的 Configuration 选项卡，然后选择 About。
- （可选）使用 rladmin status extra all 命令显示配置详情：
  sh
```
rladmin status extra all
```
  当数据库兼容版本过旧时，命令输出中会显示。
确认集群已完全升级且运行正常。
使用 Cluster Manager UI 显示集群的 Configuration 选项卡。该选项卡显示集群版本信息和 Redis 数据库兼容版本。
对于 Replica Of 数据库，请先升级目标数据库，再升级源数据库。
检查客户端与数据库版本的兼容性。
如果您使用 Go-Redis 9 及更高版本或 Lettuce 6 及更高版本运行 Redis Stack 命令，请在将数据库升级到 Redis 7.2 之前将客户端的协议版本设置为 RESP2，以防止因 RESP3 破坏性变更导致的潜在应用程序问题。更多详情和示例请参见 Redis 7.2 升级的客户端前置条件。
为避免升级期间数据丢失，请备份您的数据。
您可以将数据导出到外部位置，启用复制，或启用持久化。
在选择备份数据的方式时，请牢记以下几点：
- 为减少启用复制时的停机时间，在重启主数据库之前会执行故障转移。
- 当启用了持久化但未启用复制时，数据库在重启期间不可用，因为数据是从持久化文件中恢复的。AOF 持久化恢复比快照恢复慢。

升级数据库

升级数据库的方法：

Cluster Manager UI：

在开始升级之前，完成所有前置条件。
（可选）备份数据库以最大程度降低数据丢失的风险。
从 Cluster Manager UI 的 Databases 界面或单个数据库的 Configuration 界面升级数据库及其模块。在升级过程中，数据库将重启而不会丢失任何数据。
从 Databases 界面升级数据库：
1. 展开 Databases 列表中的数据库以显示详情。
2. 点击 Upgrade。
3. 在 Select version 中，从列表中选择数据库升级的 Redis 版本。
4. 点击 Upgrade。
5. 升级过程完成后，检查展开的数据库详情，验证 Redis 版本是否设置为预期值。
从数据库的 Configuration 界面升级：
1. 从 Databases 列表中选择数据库，进入其 Configuration 界面。
2. 点击 More actions 按钮（⋮）。
3. 从列表中选择 Upgrade version。
4. 在 Select version 中，从列表中选择数据库升级的 Redis 版本。
5. 点击 Upgrade。
6. 升级过程完成后，点击 About 按钮（ⓘ）并验证 Redis 版本是否设置为预期值。

rladmin：

在开始升级之前，完成所有前置条件。
（可选）备份数据库以最大程度降低数据丢失的风险。
使用 rladmin upgrade db 升级数据库。在升级过程中，数据库将重启而不会丢失任何数据。使用 preserve_roles 选项保留数据库的当前状态（包括主分片放置），并防止集群变得不平衡。
要升级数据库及其模块：
sh
```
rladmin upgrade db <database name | database ID> preserve_roles
```
成功升级的示例：
sh
```
rladmin> upgrade db demo
Monitoring d194c4a3-631c-4726-b799-331b399fc85c
active - SMUpgradeBDB init
active - SMUpgradeBDB wait_for_version
active - SMUpgradeBDB configure_shards
completed - SMUpgradeBDB
Done
```
要将数据库升级到非默认版本，请使用 redis_version 参数：
sh
```
rladmin upgrade db <database name | database ID> redis_version <version> preserve_roles
```
有关模块升级选项，请参见升级模块。
使用 rladmin status databases extra all 显示集群中数据库列表及其当前的 Redis 数据库兼容版本。验证 Redis 版本是否设置为预期值。
sh
```
rladmin status databases extra all
```

REST API：

在开始升级之前，完成所有前置条件。
（可选）备份数据库以最大程度降低数据丢失的风险。
使用升级数据库 REST API 请求。在升级过程中，数据库将重启而不会丢失任何数据。使用 preserve_roles 选项保留数据库的当前状态（包括主分片放置），并防止集群变得不平衡。
sh
```
POST https://<host>:<port>/v1/bdbs/<database_id>/upgrade
{
    "preserve_roles": true,
    // 其他字段
}
```
有关其他数据库升级选项，请参见数据库升级请求参考中的请求体部分。

升级 Redis Software 数据库 ​

默认 Redis 数据库版本 ​

升级前置条件 ​

升级数据库 ​

升级 Redis Software 数据库

默认 Redis 数据库版本

升级前置条件

升级数据库