文档中心

缓存数据库 Redis 版

变更实例配置

变更实例的分片集群配置

变更实例的分片集群配置

缓存数据库 Redis 版提供启用分片集群和未启用分片集群两种架构，且支持将未启用分片集群变更为启用分片集群，来满足业务水平扩容的需求。本文介绍启用实例分片集群架构的操作步骤。

前提条件

实例架构需为未启用分片集群。关于实例架构的更多详情，请参见产品架构。

实例状态需为运行中。关于实例状态的更多详情，请参见实例状态。

注意事项

若需将实例变更为分片集群，必须等待所有多 key 命令执行完成。若在变更期间执行命令，可能导致变更操作失败。关于多 key 命令的更多说明，请参见多 key 命令限制。

未启用分片集群变更为启用分片集群后，不支持再变更回未启用分片集群。

未启用分片集群变更为启用分片集群操作仅改变实例的架构，实例类型、所在可用区、连接地址等均不会改变。

未启用分片集群变更为启用分片集群后，实例架构发生了变化，在 Lua 脚本使用限制、多 key 命令、事务命令，以及其他命令等方面的限制也会存在差异。关于命令限制的更多详情，请参见命令限制。

变更过程中，实例可能会返回 -TRYAGAIN The specific keys are being migrated.\r\n 错误，或出现 1 次 ~ 2 次连接闪断，每次闪断时长在 30 秒内，请谨慎操作。建议在业务低峰期执行变配操作，并确保客户端配置了正确的重试机制。

开启数据闪回后，发起配置变更将自动关闭数据闪回功能。数据闪回功能关闭后，之前的闪回时间点不再保留。更多详情，请参见设置数据闪回功能。

操作步骤

登录 Redis 控制台。

在顶部菜单栏的左上角，选择实例所属的项目和地域。

在实例列表页，单击目标实例名称。

在实例信息页签下的配置信息区域，单击未启用分片集群后的启用。

在启用分片集群弹窗中，根据业务需要配置如下参数。

参数	说明
目标分片数	您可以根据业务量选择需要的分片数，取值为 2~256 间的任意整数。
节点规格	选择启用分片集群后实例的节点规格，您可以选择升级或降级节点规格。关于节点规格的更多详情，请参见实例规格。说明如需降低节点规格，需保证实例当前的已用内存不超过新内存总容量的 85%，其中新内存总容量 = 变更后的单分片内存 x 分片数。已用内存信息查看方法，请参见查看实例信息。
规格预览	查看并确认变更后的实例规格和性能详情，包括内存总容量、分片数、节点规格、每分片中的节点数、预估读写带宽和总连接数。
备份	您可以选择是否在变更配置前进行全量备份。注意仅 Redis 主备实例支持该配置。单节点实例不支持备份功能，无需设置该参数。发起配置变更将自动关闭数据闪回功能。数据闪回功能关闭后，之前的闪回时间点不再保留。您可以在配置变更完成后再手动开启数据闪回功能。数据闪回功能使用方法，请参见设置数据闪回功能。
备份名称	勾选变更配置前进行全量备份后，您可以为全量备份设置备份名称。选填，若不设置备份名称，默认使用备份 ID 作为名称。若要设置备份名称，名称需同时满足如下条件: 以中文、字母、下划线（_）开头。长度为 1-128 个字符。由中文、字母、数字、下划线（_）和中划线（-）组成。说明备份创建成功后，您可以在备份列表页查看并下载该备份。更多详情，请参见查看备份。您也可以在备份创建成功后再修改备份名称，具体操作步骤，请参见修改备份名称。
执行时间	您可以选择立即执行或在可维护时间段执行实例配置变更的任务。说明若选择了在可维护时间段执行，此时实例状态会立即改变（如变为变更配置中）且该状态会一直持续到任务完成，但操作任务的真正执行时间仍然是可维护时间段内。可维护时间段的设置方法，请参见设置可维护时间段。
协议	阅读并勾选服务条款。

根据实例的计费类型完成后续步骤。

相关 API

API	描述
EnableShardedCluster	调用 EnableShardedCluster 接口将目标 Redis 实例变更为启用分片集群实例。

最近更新时间：2026.04.15 17:40:54

这个页面对您有帮助吗？

有用

有用

无用

无用