账号管理

操作场景

GeminiDB Redis接口提供企业级的多租户能力，支持添加只读账号、读写账号，并且可约束每个账号可访问的数据库（DB）范围，避免误操作其他租户数据。本文介绍账号管理使用方法。

使用须知

• 每个GeminiDB Redis实例最多能创建200个账号。
• 执行账号变更后，需10s生效。
• 在通过备份恢复到新实例时，原实例的账号信息不会继承。
• 创建账号需要满足表1规则。

  表1 参数规则

  参数	规则	示例
  账号名称	不能为空。 长度不超过36个字符。 以字母开头，只能包含数字、英文字母、下划线、中划线。	Organization
  权限	读写。 只读。	读写
  数据库	授权所有数据库。 未授权数据库。 已授权数据库。 说明： 用户可以根据自己的需要在数据库右边“添加”数据库。 用户可以根据自己的需要选择需要授权的数据库。 此处“数据库”对应开源redis的“DB”。	授权所有数据库
  密码	不能为空。 长度为8~32位。 密码需包含大写字母、小写字母、数字和特殊字符中的至少两种，支持的特殊字符为~ ! @ # % ^ * - _ = +? $ () &。	nosql123456

创建账号

1. 登录管理控制台。
2. 在服务列表中选择“数据库 > 云数据库 GeminiDB Redis 接口”。
3. 在“实例管理”页面，选择目标实例，单击实例名称，进入“基本信息”页面。
4. 在左侧导航树，单击“账号管理”。
5. 在“账号管理”页面，单击“创建账号”。
   图1 创建账号
   

6. 在弹出框中，输入账号，并选择权限，给需要的数据库（DB）进行授权，输入密码并确认密码，单击“确定”。
   图2 创建账号
   

7. 创建成功后，您可在当前实例的所有账号中，查询并管理自己的账号。

重置密码

1. 登录管理控制台。
2. 在服务列表中选择“数据库 > 云数据库 GeminiDB Redis 接口”。
3. 在“实例管理”页面，选择目标实例，单击实例名称，进入“基本信息”页面。
4. 在左侧导航树，单击“账号管理”。
5. 在“账号管理”页面，选择需要重置密码的账号，单击“重置密码”。
   图3 重置密码
   

6. 在弹出框中输入新密码，并确认密码，单击“确定”。
   图4 重置密码
   

7. 重置成功后，原先已建立起的长链接需要重新连接。连接命令参考：auth USER PWD 或 auth USER:PWD。

修改权限

1. 登录管理控制台。
2. 在服务列表中选择“数据库 > 云数据库 GeminiDB Redis 接口”。
3. 在“实例管理”页面，选择目标实例，单击实例名称，进入“基本信息”页面。
4. 在左侧导航树，单击“账号管理”。
5. 在“账号管理”页面，选择需要修改权限的账号，单击“修改权限”。
   图5 修改权限
   

6. 在弹出框中选择需要修改的权限和数据库，单击“确定”。
   图6 修改权限
   

7. 重置成功后，原先已建立起的长链接需要重新连接。连接命令参考：auth USER PWD 或 auth USER:PWD。

删除账号

1. 登录管理控制台。
2. 在服务列表中选择“数据库 > 云数据库 GeminiDB Redis 接口”。
3. 在“实例管理”页面，选择目标实例，单击实例名称，进入“基本信息”页面。
4. 在左侧导航树，单击“账号管理”。
5. 在“账号管理”页面，选择需要删除的账号，单击“删除”，在弹出框中单击“确定”。
   图7 删除
   

6. 删除成功后，该账号将不再显示在实例的所有账号中。

如何使用新账号访问数据库

1. 命令行访问：auth USER PWD 或 auth USER:PWD
2. 业务程序使用SDK访问：分别将USER、PWD作为账号、密码参数值，或将"USER:PWD"作为密码参数。

   使用auth argc登录时，argc中不能含有冒号，若输入的错误密码含有冒号时，返回值与开源输入auth argc1 argc2的返回值相同。