你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

如何将现有的 Redis 4 缓存升级到 Redis 6

Azure Cache for Redis 支持将 Azure Cache for Redis 的版本从 Redis 4 升级到 Redis 6。 升级与每月定期维护类似。 升级遵循与维护相同的模式:首先更新副本节点上的 Redis 版本,然后再更新主节点。 客户端应用程序应将升级操作完全视为与计划内维护事件类似。

作为预防措施,我们建议在升级之前导出现有的 Redis 4 缓存中的数据,并在较低的环境中使用 Redis 6 缓存测试客户端应用程序。

有关如何导出的详细信息,请参阅在 Azure Cache for Redis 中导入和导出数据

重要

新增功能中所述,我们将于 2023 年 6 月 30 日停用第 4 版 Azure Cache for Redis 实例。 在此日期之前,你需要将所有缓存实例升级到版本 6。

有关 Redis 4 停用的详细信息,请参阅停用常见问题解答

先决条件

限制

  • 升级基本层中的缓存时,它会在几分钟内不可用并导致数据丢失。
  • 不支持对异地复制的缓存进行升级。 在升级之前,必须手动取消缓存实例的链接。
  • 不支持升级依赖于云服务的缓存。 升级之前,应将缓存实例迁移到虚拟机规模集。
  • 在尝试升级到 Redis 6 时,必须按照要求配置 VNet。 如果配置不正确,则升级可能会失败,或者升级后缓存可能无法正常工作。

检查缓存的版本

在升级之前,请从 Azure Cache for Redis 的“资源”菜单中选择“属性”来检查缓存的 Redis 版本。 建议使用 Redis 6。

Screenshot of properties selected in the Resource menu.

使用 Azure 门户进行升级

  1. 在 Azure 门户中,选择要从 Redis 4 升级到 Redis 6 的 Azure Cache for Redis 实例。

  2. 在屏幕左侧,选择“高级设置”。

  3. 如果缓存实例符合升级条件,应会看到以下蓝色横幅。 如果要继续,请选择横幅中的文本。

    Screenshot informing you that you can upgrade your cache to Redis 6 with more features. Upgrading your cache instance can't be reversed.

  4. 然后会弹出一个对话框,通知你升级为永久性并且可能导致短暂的连接故障。 如果要升级缓存实例,请选择“是”。

    Screenshot showing a dialog with more information about upgrading your cache with Yes selected.

  5. 要检查升级状态,请导航到“概览”。

    Screenshot showing Overview in the Resource menu. Status shows cache is being upgraded.

使用 Azure CLI 进行升级

要使用不使用专用终结点的 Azure CLI 将缓存从 4 升级到 6,请使用以下命令。

az redis update --name cacheName --resource-group resourceGroupName --set redisVersion=6

专用终结点

如果在缓存上启用了专用终结点,请根据 PublicNetworkAccess 是已启用还是禁用使用适当的命令:

如果 PublicNetworkAccess 已启用:

 az redis update --name <cacheName> --resource-group <resourceGroupName> --set publicNetworkAccess=Enabled redisVersion=6

如果 PublicNetworkAccess 已禁用:

az redis update --name <cacheName> --resource-group <resourceGroupName> --set publicNetworkAccess=Disabled redisVersion=6

使用 PowerShell 进行升级

若要使用 PowerShell 将缓存从 4 升级到 6,请使用以下命令:

Set-AzRedisCache -Name "CacheName" -ResourceGroupName "ResourceGroupName" -RedisVersion "6"

后续步骤