tencent cloud

腾讯云分布式缓存数据库(兼容 Redis)

动态与公告
产品动态
公告
新手指引
产品简介
产品概述
产品优势
应用场景
存储引擎
产品系列
产品版本
规格与性能
读写分离
多可用区部署
地域和可用区
名词解释
购买指南
计费概述
定价中心
购买实例
续费说明(包年包月)
退费说明(包年包月)
欠费说明
按量转包年包月
快速入门
快速创建实例
连接 Redis 实例
操作指南
操作总览
连接数据库实例
管理实例
升级实例
管理节点(Redis/ValKey 版)
管理多可用区
备份与恢复
账号管理
参数配置
慢查询
访问管理
网络与安全
监控与告警
事件管理(Redis/ValKey 版)
数据迁移
Redis 版全球复制
数据库审计
诊断优化
Sentinel 模式
开发准则
命名规则
基本使用准则
Key 与 Value 设计原则
命令使用准则
客户端程序设计准则
连接池配置
命令参考
命令参考概览
Redis 版与 Valkey 版命令兼容性
大版本命令使用差异
Proxy 架构与直连模式的使用差异
命令更多操作(Redis/Valkey 版)
Memcached 版命令兼容性
实践教程
基于 Spring Boot 搭建 Redis 客户端监控
Redis 客户端连接配置策略与实践
集群架构全局 SCAN 使用指南
实例安全下线
热 Key 与 大 key
可用区迁移方案
故障处理
连接异常
Redisson 客户端超时重连异常分析及解决方案
性能排查与调优
API 文档
History
Introduction
API Category
Making API Requests
Instance APIs
Parameter Management APIs
Other APIs
Backup and Restoration APIs
Region APIs
Monitoring and Management APIs
Log APIs
Data Types
Error Codes
常见问题
使用常见问题
连接登录问题
购买相关问题
相关协议
服务等级协议
Terms of Service
词汇表
联系我们

副本只读

PDF
聚焦模式
字号
最后更新时间: 2026-03-17 17:45:58

操作场景

针对读多写少的业务场景,腾讯云分布式缓存数据库支持将热点数据集中的读需求指定在副本节点,即副本只读,把读操作和写操作分别路由到不同的数据库节点上,避免读写冲突,提高数据库的并发处理能力,提升整个系统的性能和稳定性。更多信息,请参见 读写分离

计费问题

副本只读功能当前免费体验中。

支持说明

存储引擎
支持的版本
支持的架构
Redis 版
4.0及以上
标准架构、集群架构
Valkey 版
8.0
标准架构、集群架构
Memcached 版
不支持

注意事项

开启读写分离的副本只读功能,可能会导致数据读取不一致(副本节点数据延后于主节点),请先确认业务是否允许数据不一致的问题。
副本只读开关只会影响新建连接,存量连接不受影响。

前提条件

数据库版本要求:Redis 4.0及以上, ValKey 8.0。
实例状态为运行中

开启副本只读

2. 在右侧实例列表页面上方,选择地域。
3. 在实例列表中,找到目标实例。
4. 单击实例 ID,进入实例详情页面,单击节点管理页签。
5. 节点管理页面的右上角,单击副本只读旁边的


6. 在弹出的对话框,配置副本只读的节点,具体参数信息,请参见下表。

参数名称
参数解释
账户名
固定为默认账号,即系统仅为默认账号开启副本只读。
命令权限
固定为读写权限。默认账号具备读写权限。
只读路由策略
默认为副本节点,也可选择主节点,或者同时选择副本节点与主节点。读请求将被系统自动负载均衡到配置的只读节点。
只读本地节点
当实例为多可用区部署时,显示该参数。开关就近访问功能,固定为已禁用。您可在控制台参数配置页面配置参数 read-local-node-only 来开启和关闭该功能。
费用
当前免费体验中。
7. 参数配置确认无误后,单击确定
8. 实例状态变更为处理中,等待其为运行中,在实例详情页面的规格信息区域,可查看副本只读已开启,即可体验读写分离。

关闭副本只读

注意:
若实例自定义账号的只读路由策略指定读请求分发至副本节点,无法直接关闭副本只读功能,请优先将只读策略指定为主节点,再关闭副本只读功能。
2. 在右侧实例列表页面上方,选择地域。
3. 在实例列表中,找到目标实例。
4. 单击实例 ID,进入实例详情页面,单击节点管理页签。
5. 节点管理页面的右上角,单击副本只读旁边的

6. 关闭副本只读的对话框,了解关闭副本只读的影响,确认关闭,单击确定
7. 实例状态变更为处理中,等待其为运行中,在实例详情页面的规格信息区域,可查看副本只读未开启,即完成关闭。

命令路由说明

开启副本只读之后,部分命令不会路由到副本节点,仅路由至主节点。具体命令,如下表所示。
架构类别
读写分离下仅路由在主节点的命令
标准版
getdel、getex、set、setnx、setex、psetex、append、del、unlink、setbit、bitfield、setrange、incr、decr、rpush、lpush、rpushx、lpushx、linsert、rpop、lpop、brpop、brpoplpush、blpop、lset、ltrim、lrem、rpoplpush、sadd、srem、smove、spop、sinterstore、sunionstore、sdiffstore、sscan、zadd、zincrby、zrem、zremrangebyscore、zremrangebyrank、zremrangebylex、zunionstore、zinterstore、zscan、zpopmin、zpopmax、bzpopmin、bzpopmax、hset、hsetnx、hmset、hincrby、hincrbyfloat、hdel、hscan、incrby、decrby、incrbyfloat、getset、mset、msetnx、swapdb、move、rename、renamenx、expire、expireat、pexpire、pexpireat、scan、ping、multi、exec、discard、flushdb、flushall、sort、replconf、info、imonitor、persist、role、subscribe、unsubscribe、psubscribe、punsubscribe、publish、pubsub、watch、unwatch、restore、eval、evalsha、script、time、bitop、wait、command、readonly、lastsave、echo、geoadd、georadius、georadiusbymember、pfadd、pfmerge、pfdebug、xadd、xreadgroup、xgroup、xsetid、xack、xclaim、xautoclaim、xdel、xtrim、hello
集群版
getdel、getex、set、setnx、setex、psetex、append、del、unlink、setbit、bitfield、setrange、incr、decr、rpush、lpush、rpushx、lpushx、linsert、rpop、lpop、brpop、brpoplpush、blpop、lset、ltrim、lrem、rpoplpush、sadd、srem、smove、spop、sinterstore、sunionstore、sdiffstore、sscan、zadd、zincrby、zrem、zremrangebyscore、zremrangebyrank、zremrangebylex、zunionstore、zinterstore、zscan、zpopmin、zpopmax、bzpopmin、bzpopmax、hset、hsetnx、hmset、hincrby、hincrbyfloat、hdel、hscan、incrby、decrby、incrbyfloat、getset、mset、msetnx、swapdb、move、rename、renamenx、expire、expireat、pexpire、pexpireat、keys、scan、dbsize、ping、echo、lastsave、multi、exec、discard、flushdb、flushall、sort、info、persist、role、subscribe、unsubscribe、psubscribe、punsubscribe、publish、pubsub、watch、unwatch、restore、eval、evalsha、script、time、bitop、wait、geoadd、georadius、georadiusbymember、pfadd、pfmerge、pfdebug、xadd、xreadgroup、xgroup、xsetid、xack、xclaim、xautoclaim、xdel、xtrim、hello

相关 API

接口名称
功能描述
启用读写分离
禁用读写分离

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈