管理账号
Download
Focus Mode
Font Size
操作场景
腾讯云分布式缓存数据库具有灵活的账号机制，提供精细化的读写权限控制和路由策略管理，以满足复杂业务场景下的访问隔离与权限管控需求。
说明：
Memcached 版仅支持免密码认证，不涉及账号管理。
账号分类
Redis/Valkey 版支持两种类型的账号：默认账号与自定义账号。
说明：
匹配流程
默认账号认证：系统优先将输入的完整字符串作为密码，匹配默认账号。
自定义账号认证：若匹配失败，系统会以连接符为界，将输入内容拆分为“自定义账号名”与“自定义密码”进行二次匹配。
分隔符与命名规范
默认连接符：系统默认使用 @ 符号作为自定义账号与密码的连接符（拆分时以第一个出现的位置为准）。
参数修改：如需变更默认连接符，可通过调整系统参数 UserPasswordSeparate 修改
<账号名>:<密码>。具体操作，请参见 管理实例参数。字符避让建议：为避免系统误判或拆分歧义，建议默认账号的密码以及自定义账号的名称中，不要包含当前所使用的连接符（如默认的 @ 字符）。
账号类型 | 创建方式 | 权限管理 | 鉴权格式 |
默认账号 | 创建实例时自动生成 | 不可删除，不可修改读写权限 | -a <密码> |
自定义账号 | 用户手动创建 | 可修改权限，可删除 | -a <账号名>@<密码> |
权限设置
腾讯云分布式缓存数据库 Redis/Valkey 版支持以下两种权限类型：
权限类型 | 读取数据 | 修改数据 | 适用场景 |
只读权限 | ✓ | ✗ | 数据查询、报表分析、只读副本访问 |
读写权限 | ✓ | ✓ | 常规业务读写操作 |
只读路由策略
通过只读路由策略配置，您可以将指定账号的读请求分发到指定节点。
路由目标
路由目标 | 说明 |
主节点 | 读请求发送至主节点处理 |
副本节点 | 读请求发送至副本节点处理，需开通副本只读功能 |
使用限制
限制条件 | 说明 |
副本只读未开通 | 不支持路由到副本节点，需在节点管理页开通副本只读功能 |
存在访问副本节点的账号 | 不允许关闭副本只读功能，需先删除该账号后方可关闭 |
前提条件
实例已创建，且在运行中。
已明确账号密码、读写权限、只读路由策略等信息。
创建自定义账号
1. 登录 腾讯云分布式缓存数据库控制台。
2. 在右侧实例列表页面上方，选择地域。
3. 在实例列表中，找到目标实例。
4. 单击目标实例的实例 ID，进入实例详情页面。
5. 单击账号管理页签，单击创建账号。
6. 在创建账号对话框，设置账号名称及其密码信息，如下图所示。
界面参数 | 参数解释 |
账号名称 | 自定义访问数据库的名称。 仅由字母、数字、下划线、中划线组成。 长度不能大于32位。 |
密码 | 设置账号的密码。密码复杂度要求如下： 字符个数为[8,32]。 至少包含小写字母、大写字母、数字和字符 ()`~!@#$%^&*-+=_|{}[]:;<>,.?/ 中的两种。 不能以"/"开头。 |
确认密码 | 再次输入密码。 |
命令权限 | 请在下拉列表中，选择账户权限，支持选择只读与读写权限。 |
只读路由策略 | 指定账号的读请求分发至主节点或副本节点。 说明： |
只读本地节点 | 此处已禁用。该功能指在访问终端的同可用区有节点（主节点或者副本节点）的情况下，仅访问同可用区的节点，以降低读取延迟，避免跨可用区读取数据，可在控制台参数配置页面配置参数 read-local-node-only 来开启和关闭该功能。 |
7. 单击确定，完成创建，可使用该自定义账户访问数据库。具体连接方式，请参见 连接实例。
删除自定义账号
1. 登录 腾讯云分布式缓存数据库控制台。
2. 在右侧实例列表页面上方，选择地域。
3. 在实例列表中，找到目标实例。
4. 单击目标实例的实例 ID，进入实例详情页面。
5. 单击账号管理页签，在账号列表中，找到需删除的自定义账号。
6. 在其操作列，单击删除。
7. 在删除账号对话框，确定需删除的账号信息，单击确认删除。
说明：
账号删除后, 使用该账号的存量连接不会被断开, 新建连接使用该账号将无法验证。
修改账号权限
1. 登录 腾讯云分布式缓存数据库控制台。
2. 在右侧实例列表页面上方，选择地域。
3. 在实例列表中，找到目标实例。
4. 单击目标实例的实例 ID，进入实例详情页面。
5. 单击账号管理页签，在账号列表中，找到需修改权限的自定义账号。
6. 在其操作列，单击修改权限。
7. 在修改权限对话框，在命令权限后面的下拉列表中，选择账号的读写权限；在只读路由策略后面的下拉列表中，选择只读路由分发的节点，如下图所示。
8. 单击确定，完成设置。
相关 API
接口名称 | 功能描述 |
创建实例自定义账号 | |
修改实例自定义账号 | |
删除实例自定义账号 | |
查看实例账号信息 |
Help and Support
Was this page helpful?
You can also Contact sales or Submit a Ticket for help.
Help us improve! Rate your documentation experience in 5 mins.
Feedback