云数据库 Redis® 代理升级-操作指南-文档中心-腾讯云

操作场景
云数据库 Redis® 会不定期地发布 Proxy 的小版本，用于丰富数据库功能或修复已知缺陷。
Proxy 版本
Proxy 小版本
新增&优化&修复
Proxy 5.0
5.8.8
新增支持 6.0 命令（copy、blmove、Imove、geosearchstore、zrangestore、zdiff、zunion、zdiffstore）。
﻿
5.8.1
支持共享连接功能，以减轻连接风暴导致的集群过载的问题。
﻿
5.8.0
全球复制功能 Proxy 禁止写入操作，维护数据的一致性和稳定性。
﻿
5.7.2
hello 3命令返回“unknown command”错误。
﻿
5.7.1
兼容 Redis 6.2命令 getex、auth name pwd、xautoclaim。
﻿
5.7.0
Slowlog 和 Biglog 上报新增客户端 Port 字段。
Redis 6.2 版本支持 getdel、bitfield_ro、stralgo、hello 命令。
集群版支持 dbsize 命令聚合后端所有节点的返回结果, 同时保持之前指定 nodeid 的用法。
新增多 AZ 本地读功能。
﻿
5.6.6
Proxy 支持无缝迁移，扩缩分片时事务、publish/subscribe、阻塞命令等操作对用户无感。
﻿
5.6.5
修复账户免密功能相关问题。
﻿
5.6.3
新增 getex、auth name pwd、xautoclaim 命令。
﻿
5.6.0
集群架构支持 wait 命令。
支持 SSL 加密，实现数据信息加密传输。
优化 cluster nodes/slot 命令执行性能。
﻿
5.5.0
集群架构支持 wait 命令。
支持就近访问功能。
集群版支持 dbsize 命令，返回所有分片节点 Key 的数量。
慢日志支持查看客户端 port 信息。
支持 flushall/flushdb 命令，集群架构将该命令分发到的所有分片主节点执行，同时保留指定的 nodeid 参数。
支持大 Value 请求次数的监控指标。
集群版支持 Scan 命令，包括遍历所有分片节点。
修复在事务之后执行 select 命令可能会导致返回 ERR unknown command 'select' command 的问题。
修复在 pipeline 场景下使用 watch+ 事务, 造成锁定的连接释放不及时，造成命令被发送到错误节点上而触发 Move 报错的问题。
﻿
5.4.0
优化 P99 监控指标的统计策略，包括所有 Redis 命令。
﻿
5.2.0
监控数据支持5秒粒度。
﻿
5.1.0
集群架构支持 keys 命令。
慢日志支持查看客户端地址。
修复 ERR MULTI calls can not be nested 的错误。
﻿
5.0.0
集群架构支持 unlink 和 exists 命令。
Proxy 4.0
3.5.0
支持命令分析功能，可查看单个命令的 QPS、P99 执行时延、平均执行时延、最大执行时延等信息。
﻿
3.3.0
系统监控数据采集时间粒度支持5秒统计。
﻿
3.2.0
慢日志支持查看客户端地址。
修复 ERR MULTI calls can not be nested 的错误。
升级前须知
系统会自动检测 Proxy 的小版本，如果代理升级按钮被置灰，表示该实例已经是最新的小版本。
由于各地域版本发布进度可能有所差异，小版本发布情况以当前控制台显示为准。
升级影响
版本升级过程主要为数据同步和实例切换两个过程：
数据同步过程中，对服务无影响。
数据切换过程中，实例将存在1分钟以内的只读状态（等待数据同步完成），以及连接闪断（秒级）的影响，需要业务具备自动重连的机制。
升级准备
待升级版本的实例处于正常状态下（运行中），并且当前没有任何任务执行。
建议在业务低峰期，维护时间窗执行升级操作。
升级操作
1. 登录 Redis 控制台。
2. 在右侧实例列表页面上方，选择地域。
3. 在实例列表中，找到需升级版本的实例。
4. 单击其实例 ID，进入实例详情页面。
5. 在实例详情页面的规格信息区域，单击代理版本后面的代理升级。
﻿
6. 在弹出的对话框，根据下表确认待升级实例的信息，配置升级的目标版本，单击确定。
﻿
参数名称
参数说明
实例 ID
待升级实例的 ID。
当前版本
Proxy 当前的小版本。
目标版本
Proxy 升级后的目标版本。不支持选择目标版本。
切换时间
立即切换：数据同步接近完成（需同步的数据 < 10MB），执行切换动作。
维护时间窗切换：在实例的维护时间窗内，执行切换动作，如果在当前维护时间窗无法满足切换条件，将在下一次维护时间窗进行切换尝试。维护时间可在实例详情页的维护时间窗处修改。
7. 返回实例列表，待实例状态变为运行中，在实例列表或实例详情中查看实例的版本已经为升级后的版本。
相关 API
接口名称
接口功能
UpgradeProxyVersion
升级代理版本

Proxy 版本	Proxy 小版本	新增&优化&修复
Proxy 5.0	5.8.8	新增支持 6.0 命令（copy、blmove、Imove、geosearchstore、zrangestore、zdiff、zunion、zdiffstore）。
		5.8.1	支持共享连接功能，以减轻连接风暴导致的集群过载的问题。
		5.8.0	全球复制功能 Proxy 禁止写入操作，维护数据的一致性和稳定性。
		5.7.2	hello 3命令返回“unknown command”错误。
		5.7.1	兼容 Redis 6.2命令 getex、auth name pwd、xautoclaim。
		5.7.0	Slowlog 和 Biglog 上报新增客户端 Port 字段。 Redis 6.2 版本支持 getdel、bitfield_ro、stralgo、hello 命令。集群版支持 dbsize 命令聚合后端所有节点的返回结果, 同时保持之前指定 nodeid 的用法。新增多 AZ 本地读功能。
		5.6.6	Proxy 支持无缝迁移，扩缩分片时事务、publish/subscribe、阻塞命令等操作对用户无感。
		5.6.5	修复账户免密功能相关问题。
		5.6.3	新增 getex、auth name pwd、xautoclaim 命令。
		5.6.0	集群架构支持 wait 命令。支持 SSL 加密，实现数据信息加密传输。优化 `cluster nodes/slot` 命令执行性能。
		5.5.0	集群架构支持 wait 命令。支持就近访问功能。集群版支持 dbsize 命令，返回所有分片节点 Key 的数量。慢日志支持查看客户端 port 信息。支持 flushall/flushdb 命令，集群架构将该命令分发到的所有分片主节点执行，同时保留指定的 nodeid 参数。支持大 Value 请求次数的监控指标。集群版支持 Scan 命令，包括遍历所有分片节点。修复在事务之后执行 select 命令可能会导致返回 `ERR unknown command 'select' command` 的问题。修复在 pipeline 场景下使用 watch+ 事务, 造成锁定的连接释放不及时，造成命令被发送到错误节点上而触发 Move 报错的问题。
		5.4.0	优化 P99 监控指标的统计策略，包括所有 Redis 命令。
		5.2.0	监控数据支持5秒粒度。
		5.1.0	集群架构支持 keys 命令。慢日志支持查看客户端地址。修复 ERR MULTI calls can not be nested 的错误。
		5.0.0	集群架构支持 unlink 和 exists 命令。
Proxy 4.0	3.5.0	支持命令分析功能，可查看单个命令的 QPS、P99 执行时延、平均执行时延、最大执行时延等信息。
		3.3.0	系统监控数据采集时间粒度支持5秒统计。
		3.2.0	慢日志支持查看客户端地址。修复 ERR MULTI calls can not be nested 的错误。

参数名称	参数说明
实例 ID	待升级实例的 ID。
当前版本	Proxy 当前的小版本。
目标版本	Proxy 升级后的目标版本。不支持选择目标版本。
切换时间	立即切换：数据同步接近完成（需同步的数据 < 10MB），执行切换动作。维护时间窗切换：在实例的维护时间窗内，执行切换动作，如果在当前维护时间窗无法满足切换条件，将在下一次维护时间窗进行切换尝试。维护时间可在实例详情页的维护时间窗处修改。

接口名称	接口功能
UpgradeProxyVersion	升级代理版本

代理升级

本页目录：

操作场景

升级前须知

升级影响

升级准备

升级操作

相关 API