腾讯云分布式缓存数据库(兼容 Redis)提供实例管理、连接访问、监控告警、网络安全、备份恢复、数据迁移、诊断优化等完整的运维能力。这篇以功能模块为维度,汇总操作指南下的全部文档,供你按需检索。
相关产品
腾讯云分布式缓存数据库(兼容 Redis) 产品页,含版本规格、价格与购买入口。
一、一、按使用阶段快速上手
新建实例到业务正式接入,通常经过以下五个阶段。各阶段的必做操作如下:
| 阶段 |
目标 |
必做操作 |
| 1. 选型与购买 |
确定引擎、架构、规格与计费模式 |
存储引擎、标准架构 与 集群架构、规格与性能、计费概述 |
| 2. 创建实例 |
开通实例并完成初始化 |
创建实例 |
| 3. 打通网络 |
保证客户端可访问实例 |
连接准备、配置安全组、连接实例(Redis/Valkey 版) |
| 4. 接入业务 |
在业务代码中建立连接 |
各语言连接示例、SSL 加密 |
| 5. 运维保障 |
建立可观测与数据保护能力 |
配置告警、配置备份规则、设置维护时间窗 |
二、二、功能模块索引
操作指南共包含20个功能模块。下表说明各模块解决的问题,你可点击模块名跳转至这篇对应的明细表。
| 序号 |
功能模块 |
解决的问题 |
| 1 |
管理实例 |
查看实例信息、变配、清空、退还销毁等生命周期操作 |
| 2 |
连接数据库实例 |
各类客户端与开发语言的连接方式 |
| 3 |
升级版本与架构 |
引擎大小版本升级、标准架构升级为集群架构、代理升级 |
| 4 |
管理节点 |
节点信息查看、副本提主、副本只读、故障模拟 |
| 5 |
管理可用区 |
多可用区部署配置、可用区变更与就近访问 |
| 6 |
监控与告警 |
监控指标查看、全链路监控、告警与事件规则配置 |
| 7 |
网络与安全 |
网络变更、带宽调整、安全组、SSL 加密、外网访问 |
| 8 |
账号管理 |
账号创建与授权、密码重置与复杂度策略 |
| 9 |
参数配置 |
实例参数与参数模板管理、关键参数使用说明 |
| 10 |
备份与恢复 |
备份规则配置、备份加密、备份文件下载、实例克隆 |
| 11 |
日志中心 |
慢查询日志、错误日志查看与日志投递 |
| 12 |
事件管理 |
待处理运维事件查看与执行计划调整 |
| 13 |
Sentinel 模式 |
通过 Sentinel 协议访问实例 |
| 14 |
访问管理 |
基于 CAM 的子账号权限管理与策略配置 |
| 15 |
数据迁移 |
自建或第三方数据库迁移上云、跨实例数据迁移 |
| 16 |
诊断优化 |
异常诊断、性能趋势、大 Key 与热 Key 分析 |
| 17 |
数据库审计 |
全量 SQL 审计日志的开通、查询与投递 |
| 18 |
任务管理 |
查看与跟踪实例的异步操作任务 |
| 19 |
全球复制 |
跨地域数据同步与地域级容灾 |
三、三、管理实例
实例是分布式缓存数据库的最小服务单元,一个实例即一套独立的缓存服务。以下操作覆盖实例从查看、变更到回收的完整生命周期。
四、3.1 查看与信息维护
| 操作 |
说明 |
文档 |
| 查看 Redis 版与 Valkey 版实例 |
查看实例列表、规格、网络、状态等信息 |
查看 Redis 版与 Valkey 版实例 |
| 查看 Memcached 版实例 |
Memcached 版实例的信息查看方式 |
查看 Memcached 版实例 |
| 为实例重新分配项目 |
按项目维度归类实例,便于分权与费用归集 |
为实例重新分配项目 |
| 编辑实例标签 |
通过标签对实例分组,用于筛选与成本分摊 |
编辑实例标签 |
| 设置维护时间窗 |
指定运维操作的执行时段,避开业务高峰 |
设置维护时间窗 |
五、3.2 规格与容量变更
| 操作 |
说明 |
文档 |
| 变更实例规格 |
调整内存容量、副本数量或分片数量 |
变更实例规格 |
| 调整连接数数量 |
在规格默认值之上追加连接数配额 |
调整连接数数量 |
| 购买相同配置 |
以现有实例的配置为模板快速创建新实例 |
购买相同配置 |
六、3.3 数据清理与实例回收
| 操作 |
说明 |
文档 |
| 清空实例数据 |
一次性清除实例内全部数据,实例本身保留 |
清空实例数据 |
| 下线/恢复实例 |
临时停止实例对外服务,需要时再恢复 |
下线/恢复实例 |
| 退还/销毁实例 |
退还实例,进入回收站隔离期后彻底销毁 |
退还/销毁实例(回收站隔离) |
| 设置实例销毁保护 |
开启后需二次确认才可销毁,防止误操作 |
设置实例销毁保护 |
注意:说明:
注意:退还的实例先进入回收站隔离,隔离期内可恢复;隔离期结束后数据不可找回。执行前请确认已完成数据备份。
八、4.1 连接方式
| 操作 |
说明 |
文档 |
| 连接准备 |
连接前需确认的网络、账号、密码与客户端条件 |
连接准备 |
| 连接实例 |
通过 DMC、redis-cli 等方式连接实例 |
连接实例(Redis/Valkey 版) |
| Sentinel 模式连接 |
通过 Sentinel 协议实现客户端侧的主节点发现 |
Sentinel 模式 |
九、4.2 客户端连接示例
| 开发语言 |
文档 |
| Java |
Java 连接示例 |
| Python |
Python 连接示例 |
| Go |
Go 连接示例 |
| Node.js |
Node.js 连接示例 |
| PHP |
PHP 连接示例 |
| C |
C 连接示例 |
| .Net |
.Net 连接示例 |
十、五、升级版本与架构
| 操作 |
说明 |
文档 |
| 升级实例版本 |
升级引擎大版本或小版本,获取新特性与缺陷修复 |
升级实例版本 |
| 升级实例架构 |
将标准架构升级为集群架构,突破单分片容量与性能上限 |
升级实例架构 |
| 代理升级 |
单独升级 Proxy 版本,与引擎版本解耦 |
代理升级 |
注意:说明:
注意:升级操作涉及节点切换,建议在 维护时间窗 内执行,并确认客户端具备重连能力。版本差异请参考 大版本功能清单 与 版本生命周期计划。
十一、六、管理节点(Redis/Valkey 版)
| 操作 |
说明 |
文档 |
| 查看节点信息 |
查看各分片的主从节点分布、可用区与运行状态 |
查看节点信息 |
| 副本提主 |
手动将指定副本节点提升为主节点 |
副本提主 |
| 副本只读 |
开启读写分离,将读请求分流至副本节点 |
副本只读 |
| Proxy 节点切换 |
手动切换 Proxy 节点,用于故障排查与验证 |
Proxy 节点切换 |
| 故障模拟 |
主动注入故障,验证业务的容灾与重连能力 |
故障模拟 |
注意:说明:
注意:开启副本只读后,副本节点数据略延后于主节点。对一致性有强要求的读请求,应路由至主节点。原理详见 读写分离。
十二、七、管理可用区
| 操作 |
说明 |
文档 |
| 配置多可用区 |
将实例节点分布到多个可用区,实现机房级容灾 |
配置多可用区 |
| 变更可用区 |
调整实例所在可用区,或从单可用区变更为多可用区 |
变更可用区 |
| 访问多可用区实例 |
多可用区场景下的客户端接入与就近访问配置 |
访问多可用区实例 |
注意:说明:
注意:如需让客户端优先访问同可用区节点以降低跨可用区时延,可通过参数 read-local-node-only 配置就近访问。架构原理详见 多可用区部署。
十四、8.1 监控数据查看
| 操作 |
说明 |
文档 |
| 监控概述 |
监控体系的能力范围、采集粒度与数据保留策略 |
监控概述 |
| 监控指标 |
全量监控指标的含义、单位与取值说明 |
监控指标(Redis/Valkey 版) |
| 查看监控数据 |
在控制台查看实例、节点、Proxy 维度的监控曲线 |
查看监控数据(Redis/Valkey 版) |
| 监控实例(Memcached 版) |
Memcached 版实例的监控查看方式 |
监控实例(Memcached 版) |
| 多实例对比监控 |
将多个实例的同一指标叠加对比,快速定位异常实例 |
多实例对比监控 |
十五、8.2 全链路监控
全链路监控将客户端、Proxy 与数据节点的耗时串联展示,用于定位时延究竟产生在网络、代理层还是引擎侧。
| 操作 |
说明 |
文档 |
| 方案概述 |
全链路监控的架构、能力边界与前置条件 |
方案概述 |
| 开启全链路功能 |
在控制台开启全链路监控 |
开启全链路功能 |
| 客户端配置 |
客户端侧的埋点与上报配置 |
客户端配置 |
| 可视化展示 |
查看链路拓扑与分段耗时 |
可视化展示 |
十六、8.3 告警与事件
| 操作 |
说明 |
文档 |
| 配置告警 |
为关键指标设置阈值、告警渠道与接收人 |
配置告警 |
| 创建事件规则 |
针对节点切换、内存超限等事件配置通知规则 |
创建事件规则 |
十八、9.1 网络配置
| 操作 |
说明 |
文档 |
| 更换网络 |
变更实例所属私有网络与子网 |
更换网络 |
| 带宽调整 |
在标准带宽之上购买附加带宽,应对流量峰值 |
带宽调整 |
| 开通外网访问 |
为实例分配外网访问地址 |
开通外网访问 |
| 通过 CLB 开启外网服务 |
借助负载均衡对外提供访问入口 |
通过 CLB 开启外网服务 |
| iptable 转发 |
通过云服务器转发实现跨网络访问 |
iptable 转发 |
十九、9.2 访问安全
| 操作 |
说明 |
文档 |
| 配置安全组 |
通过虚拟防火墙控制访问实例的来源 IP 与端口 |
配置安全组 |
| SSL 加密 |
开启传输链路加密,防止数据在传输过程中被窃取 |
SSL 加密 |
| 配置禁用命令 |
屏蔽 FLUSHALL、KEYS 等高危命令 |
通过 disable-command-list 配置禁用命令 |
注意:说明:
注意:安全组是一种有状态的虚拟防火墙,用于设置单台或多台实例的网络访问控制,是重要的网络隔离手段。建议遵循最小授权原则,仅放通业务必需的来源 IP 与端口。
20、十、账号管理
| 操作 |
说明 |
文档 |
| 管理账号 |
创建子账号并分配读写或只读权限 |
管理账号 |
| 重置密码 |
修改实例的访问密码 |
重置密码 |
| 设置密码复杂度 |
配置密码长度与字符组合规则,提升口令强度 |
设置密码复杂度 |
| 免密码访问 |
在受信任的私有网络内免密连接实例 |
免密码访问 |
注意:说明:
注意:免密码访问会降低访问门槛,仅建议在网络隔离充分的测试环境使用。生产环境请开启密码认证并配合安全组限制来源。
22、11.1 参数与模板管理
| 操作 |
说明 |
文档 |
| 管理实例参数 |
查看、修改单个实例的运行参数 |
管理实例参数 |
| 管理参数模板 |
将成套参数固化为模板,批量应用到多个实例 |
管理参数模板 |
| 可配置的参数列表 |
全量可修改参数的取值范围、默认值与生效方式 |
可配置的参数列表 |
23、11.2 关键参数使用说明
部分参数直接影响访问行为与容灾策略,使用前建议先阅读对应说明。
| 参数 |
作用 |
文档 |
| local-client-list |
获取连接实例的客户端信息,用于排查连接来源 |
通过 local-client-list 获取客户端信息 |
| disable-command-list |
禁用高危命令,降低误操作导致的数据风险 |
通过 disable-command-list 配置禁用命令 |
| read-local-node-only |
优先访问同可用区节点,降低跨可用区时延 |
通过 read-local-node-only 参数配置就近访问 |
| auto-failback |
主节点恢复后自动回切,维持节点在可用区的原有分布 |
通过 auto-failback 配置自动回切 |
24、十二、备份与恢复
| 操作 |
说明 |
文档 |
| 备份与恢复概述 |
备份类型、保留周期与恢复能力的整体说明 |
备份与恢复概述 |
| 配置备份规则 |
设置自动备份的执行时间与保留天数 |
配置备份规则 |
| 开启备份加密 |
对备份文件加密存储,满足合规要求 |
开启备份加密 |
| 配置备份文件下载方式 |
限制备份文件的下载来源与网络类型 |
配置备份文件下载方式 |
| 下载备份文件 |
将备份文件下载至本地或指定环境 |
下载备份文件 |
| 克隆实例(Redis/Valkey 版) |
基于备份集创建一个数据一致的新实例 |
克隆实例(Redis/Valkey 版) |
| 克隆实例(Memcached 版) |
Memcached 版实例的克隆方式 |
克隆实例(Memcached 版) |
25、十三、日志中心
| 操作 |
说明 |
文档 |
| 慢查询(Redis/Valkey 版) |
查看执行耗时超过阈值的命令,定位性能瓶颈 |
慢查询(Redis/Valkey 版) |
| 慢查询(Memcached 版) |
Memcached 版实例的慢查询查看方式 |
慢查询(Memcached 版) |
| 错误日志 |
查看实例运行过程中的错误记录 |
错误日志 |
| 日志投递 |
将日志投递至日志服务 CLS,用于长期留存与检索 |
日志投递 |
26、十四、事件管理(Redis/Valkey 版)
| 操作 |
说明 |
文档 |
| 查看待处理事件 |
查看版本升级、硬件维护等待执行的运维事件 |
查看待处理事件 |
| 修改事件执行计划 |
调整事件的执行时间,将影响控制在业务低峰期 |
修改事件执行计划 |
27、十五、Sentinel 模式
| 操作 |
说明 |
文档 |
| Sentinel 模式 |
通过 Sentinel 协议获取主节点地址,适配已有的 Sentinel 客户端架构 |
Sentinel 模式 |
28、十六、访问管理
| 操作 |
说明 |
文档 |
| 访问管理概述 |
基于 CAM 实现子账号的权限隔离 |
访问管理概述 |
| 授权策略语法 |
策略的结构、元素与编写规则 |
授权策略语法 |
| 可授权的资源类型 |
支持资源级授权的接口与资源描述方式 |
可授权的资源类型 |
30、17.1 方案选择
| 操作 |
说明 |
文档 |
| 迁移方案概览 |
对比各迁移方案的适用源端、停机时间与限制 |
迁移方案概览 |
31、17.2 使用 DTS 迁移
DTS 支持在业务不停机的前提下完成数据迁移,是自建实例上云的推荐方案。
| 操作 |
说明 |
文档 |
| 支持能力 |
支持的源端类型、版本与架构组合 |
支持能力 |
| 使用说明 |
迁移前的准备事项与注意点 |
使用说明 |
| 迁移操作指导 |
创建并执行迁移任务的完整步骤 |
迁移操作指导 |
| 标准架构迁移到集群架构检查 |
跨架构迁移前的兼容性校验项 |
标准架构迁移到集群架构检查 |
| 创建数据一致性校验 |
迁移后校验源端与目标端的数据一致性 |
创建数据一致性校验 |
| Key 前缀过滤 |
按 Key 前缀筛选迁移范围,实现部分数据迁移 |
Key 前缀过滤 |
迁移前置检查项:迁移任务启动前会执行以下校验,任一项未通过将导致任务失败。
| 检查项 |
文档 |
| 源实例是否为副本节点 |
源实例是否为副本节点 |
| 目标实例状态是否正常 |
目标实例状态是否正常 |
| 目标实例容量是否满足要求 |
目标实例容量是否满足要求 |
| 源实例参数检查 |
源实例参数检查 |
| 网络是否可达 |
网络是否可达 |
| 源实例目标实例版本是否兼容 |
源实例目标实例版本是否兼容 |
| 常见错误处理 |
常见错误处理 |
32、17.3 其他迁移方案
| 操作 |
说明 |
文档 |
| 使用 redis-port 进行迁移 |
通过工具导入导出数据,适用于离线迁移场景 |
使用 redis-port 进行迁移 |
| PIKA 到 Redis 数据迁移方案 |
从 PIKA 迁移至分布式缓存数据库 |
PIKA 到 Redis 数据迁移方案 |
| SSDB 到 Redis 数据迁移方案 |
从 SSDB 迁移至分布式缓存数据库 |
SSDB 到 Redis 数据迁移方案 |
33、十八、诊断优化(DBbrain)
DBbrain 提供自动化的性能诊断与优化建议,可将异常定位从人工排查转为系统提示。
| 操作 |
说明 |
文档 |
| 概述 |
诊断优化的功能范围与使用前提 |
概述 |
| 开启自动扩容(自治任务) |
容量接近上限时自动扩容,避免因内存写满导致服务受损 |
开启自动扩容(自治任务) |
| 异常诊断 |
查看实例的健康得分与异常事件的根因分析 |
异常诊断 |
| 性能趋势 |
按时间维度观察核心性能指标的变化 |
性能趋势 |
| 实时会话 |
查看当前连接与执行中的命令 |
实时会话 |
| 慢日志分析 |
聚合慢日志,识别高频慢命令 |
慢日志分析 |
| 内存分析(大 Key 分析) |
定位占用内存过大的 Key |
内存分析(大 Key 分析) |
| 延迟分析 |
分析请求耗时的整体分布 |
延迟分析 |
| 延迟分析(命令字分析) |
按命令维度拆解耗时 |
延迟分析(命令字分析) |
| 延迟分析(热 Key 分析) |
定位访问频次异常集中的 Key |
延迟分析(热 Key 分析) |
34、十九、数据库审计
| 操作 |
说明 |
文档 |
| 审计简介 |
审计能力的记录范围、存储与计费说明 |
审计简介 |
| 开通数据库审计 |
为实例开启审计并设置日志保留策略 |
开通数据库审计 |
| 查看审计实例 |
查看已开通审计的实例及其配置 |
查看审计实例 |
| 管理审计日志 |
检索、筛选与下载审计日志 |
管理审计日志 |
| 配置日志投递 |
将审计日志投递至外部系统留存 |
配置日志投递 |
| 修改审计配置 |
调整审计规则与日志保留时长 |
修改审计配置 |
| 关闭数据库审计 |
停止审计并处理已有日志 |
关闭数据库审计 |
35、二十、任务管理
| 操作 |
说明 |
文档 |
| 任务管理 |
查看变配、迁移、升级等异步任务的执行进度与结果 |
任务管理 |
36、二十一、全球复制(Redis 版)
全球复制在多个地域间建立数据同步关系,用于就近读取与地域级容灾。
| 操作 |
说明 |
文档 |
| 全球复制概述 |
复制组的架构原理与适用场景 |
全球复制概述 |
| 使用限制 |
支持的地域、版本与架构限制 |
使用限制 |
| 新建全球复制组 |
创建复制组并添加成员实例 |
新建全球复制组 |
| 管理全球复制组 |
调整成员角色、切换主实例、移除成员 |
管理全球复制组 |
| 监控指标 |
复制延迟等全球复制专属监控指标 |
监控指标 |
37、二十二、相关文档
除操作指南外,以下栏目可协助你完成选型、开发与问题排查。
| 栏目 |
适用场景 |
入口 |
| 新手指引 |
首次使用,需要一条完整的上手路径 |
新手指引 |
| 产品简介 |
了解引擎、架构、规格与地域支持情况 |
产品概述 |
| 购买指南 |
确认计费模式、变配计费与续费退费规则 |
计费概述 |
| API 文档 |
通过接口实现自动化运维 |
API 概览 |
| 命令参考 |
查询命令的支持情况与版本差异 |
命令参考概览 |
| 开发准则 |
规范 Key 设计、命令使用与客户端实现 |
Key 与 Value 设计原则 |
| 实践教程 |
参考典型场景的完整落地方案 |
一键连接检查工具 |
| 常见问题 |
排查连接、性能与迁移相关问题 |
使用常见问题 |
| 词汇表 |
查询术语定义 |
词汇表 |