Redis OSS 的主要版本行为和兼容性差异 - Amazon ElastiCache
Redis OSS 7.0 行为和向后不兼容更改Redis OSS 6.2 行为和向后不兼容更改Redis OSS 6.0 行为和向后不兼容更改Redis OSS 5.0 行为和向后不兼容更改Redis OSS 4.0 行为和向后不兼容更改已经终止生命周期

Redis OSS 的主要版本行为和兼容性差异

重要

以下页面的结构设计为指出版本之间的所有不兼容性差异，并告知您在升级到较新版本时应考虑的任何注意事项。此列表包含升级时可能遇到的任何版本不兼容问题。

您可以直接从当前 Redis OSS 版本升级到可用的最新 Redis OSS 版本，无需连续升级。例如，您可以直接从 Redis OSS 版本 3.0 升级到版本 7.0。

Redis OSS 版本由包含 MAJOR、MINOR 和 PATCH 组件的语义版本标识。例如，在 Redis OSS 4.0.10 中，主要版本为 4，次要版本为 0，补丁版本为 10。这些值通常根据以下约定递增：

  • MAJOR 版本针对 API 不兼容的更改

  • MINOR 版本针对以向后兼容的方式添加的新功能

  • PATCH 版本针对向后兼容的错误修复和非功能性更改

我们建议始终使用给定 MAJOR.MINOR 版本中的最新补丁版本，以获得最新的性能和稳定性改进。从 Redis OSS 6.0 开始，ElastiCache（Redis OSS）将为每个 Redis OSS 次要版本提供单一版本，而不提供多个补丁版本。ElastiCache（Redis OSS）还将自动管理正在运行的缓存集群的补丁版本，确保实现更好的性能和安全性。

我们还建议定期升级到最新的主要版本，因为大多数主要改进都不会向后移植到旧版本。随着 ElastiCache 将可用性扩展到新的 AWS 区域，ElastiCache（Redis OSS）支持将当时最新的两个 MAJOR.MINOR 版本用于此新区域。例如，如果一个新 AWS 区域推出，并且最新的 MAJOR.MINOR ElastiCache（Redis OSS）版本为 7.0 和 6.2，则 ElastiCache（Redis OSS）将在新的 AWS 区域中支持版本 7.0 和 6.2。随着 ElastiCache（Redis OSS）的更高 MAJOR.MINOR 版本发布，ElastiCache 将继续增加对新发布的 ElastiCache（Redis OSS）版本的支持。要详细了解如何为 ElastiCache 选择区域，请参阅选择区域和可用区。

在进行跨主版本或次版本的升级时，请考虑以下列表，其中包括随着时间的推移随 Redis OSS 发布的行为和向后不兼容更改。

Redis OSS 7.0 行为和向后不兼容更改

有关更改的完整列表，请参阅 Redis OSS 7.0 发布说明。

  • SCRIPT LOAD 和 SCRIPT FLUSH 不再传播到副本。如果您需要脚本具有一定的持久性，我们建议您考虑使用 Redis OSS 函数。

  • 现在，对于新的 ACL 用户，发布订阅通道默认处于屏蔽状态。

  • STRALGO 命令已替换为 LCS 命令。

  • ACL GETUSER 的格式已更改，因此所有字段都显示标准访问字符串模式。如果您使用 ACL GETUSER 实现了自动化，则应验证它是否可以处理任何一种格式。

  • SELECT、WAIT、ROLE、LASTSAVE、READONLY、READWRITE 和 ASKING 的 ACL 类别已更改。

  • INFO 命令现在显示每个子命令的命令统计信息，而不是在顶级容器命令中显示命令统计信息。

  • 在某些边缘情况下，LPOP、RPOP、ZPOPMIN 和 ZPOPMAX 命令的返回值已更改。如果您使用这些命令，则应查看发布说明并评估是否受到影响。

  • SORT 和 SORT_RO 命令现在需要访问整个键空间才能使用 GET 和 BY 参数。

Redis OSS 6.2 行为和向后不兼容更改

有关更改的完整列表，请参阅 Redis OSS 6.2 发布说明。

  • TIME、ECHO、ROLE 和 LASTSAVE 命令的 ACL 标志已更改。这可能会导致先前允许的命令被拒绝，反之亦然。

    注意

    这些命令不会修改或授予对数据的访问权限。

  • 从 Redis OSS 6.0 升级时，从映射响应返回到 lua 脚本的键/值对的顺序发生了变化。如果您的脚本使用 redis.setresp() 或返回映射（Redis OSS 6.0 中的新功能），请考虑脚本可能会在升级时发生中断所带来的影响。

Redis OSS 6.0 行为和向后不兼容更改

有关更改的完整列表，请参阅 Redis OSS 6.0 发布说明。

  • 允许的最大数据库数量已从 120 万减少到 1 万个。默认值为 16，我们不鼓励使用比这大许多的值，因为我们发现这样会带来性能和内存问题。

  • 将 AutoMinorVersionUpgrade 参数设置为“是”，ElastiCache（Redis OSS）将通过自助更新管理次版本升级。这将通过自助服务更新活动借助标准客户通知渠道进行处理。有关更多信息，请参阅 ElastiCache 中的自助更新。

Redis OSS 5.0 行为和向后不兼容更改

有关更改的完整列表，请参阅 Redis OSS 5.0 发布说明。

  • 脚本由效果复制，而不是在副本上重新执行脚本。这通常可以提高性能，但可能会增加主副本和副本之间复制的数据量。有一个选项可以恢复到之前的行为，该选项仅在 ElastiCache（Redis OSS）5.0 中可用。

  • 如果您是从 Redis OSS 4.0 升级，LUA 脚本中的某些命令将以与早期版本不同的顺序返回参数。在 Redis OSS 4.0 中，为了使响应具有确定性，Redis OSS 会按字典顺序对某些响应进行排序，当脚本通过效果复制时，这种排序不适用。

  • 在 Redis OSS 5.0.3 及更高版本中，ElastiCache（Redis OSS）会将一些 IO 工作转移到具有 4 个 vCPU 以上的实例类型的后台内核。这可能会改变 Redis OSS 的性能特性并更改某些指标的值。有关更多信息，请参阅 应监控哪些指标？，以了解您是否需要更改要关注的指标。

Redis OSS 4.0 行为和向后不兼容更改

有关更改的完整列表，请参阅 Redis OSS 4.0 发布说明。

  • 慢日志现在记录两个额外参数，即客户端名称和地址。除非您明确依赖包含 3 个值的每个慢日志条目，否则此更改应向后兼容。

  • CLUSTER NODES 命令现在返回的格式略有不同，不向后兼容。我们建议客户端不要使用此命令来了解集群中存在的节点，而应使用 CLUSTER SLOTS。

已经终止生命周期

Redis OSS 3.2 行为和向后不兼容更改

有关更改的完整列表，请参阅 Redis OSS 3.2 发布说明。

  • 此版本没有兼容性更改需要调用。

有关更多信息，请参阅 Redis OSS 版本生命周期终止计划。

Redis OSS 2.8 行为和向后不兼容更改

有关更改的完整列表，请参阅 Redis OSS 2.8 发布说明。

  • 从 Redis OSS 2.8.22 开始，ElastiCache（Redis OSS）不再支持 Redis OSS AOF。当数据需要持久保存时，我们建议使用 MemoryDB。

  • 从 Redis OSS 2.8.22 开始，ElastiCache（Redis OSS）不再支持将副本附加到 ElastiCache 中托管的主节点。升级时，外部副本将断开连接，且无法重新连接。我们建议使用 Redis OSS 6.0 中提供的客户端缓存作为外部副本的替代方案。

  • 如果键不存在，TTL 和 PTTL 命令现在返回 -2；如果键存在但没有关联的过期时间，则返回 -1。Redis OSS 2.6 和以前的版本曾经在这两种情况下都返回 -1。

  • 如果未使用任何 STORE 选项，SORT 和 ALPHA 现在将根据本地排序规则语言环境进行排序。

有关更多信息，请参阅 Redis OSS 版本生命周期终止计划。