redis-cli是原生Redis自带的命令行工具,您可以在ECS实例或本地设备上通过redis-cli连接云数据库Redis版,进行数据管理。
快速了解连接Redis实例流程
图 1. 连接Redis实例流程图
操作流程 |
说明 |
1. 设置Redis账号密码。 |
选择以下任意方式:
|
2. 添加白名单。 |
根据不同设备确定连接的网络类型,并将对应网络IP地址添加至Redis实例中。
关于添加白名单的具体操作,请参见设置白名单。
|
3. 获取Redis连接信息。 |
- 使用专有网络连接时:在Redis控制台,获取该实例的专有网络连接地址。
- 使用公网连接时:在Redis控制台,申请并获取该实例的公网连接地址。
说明 Redis实例默认仅提供专有网络连接地址,通过公网连接时您需要手动申请公网连接地址。
具体操作,请参见查看连接地址。
|
4. 使用redis-cli连接Redis实例。 |
在redis-cli解压目录下执行相关命令。
具体操作,请参见本文操作步骤。
|
操作步骤
- 登录安装redis-cli的设备,例如ECS实例或本地设备。
- 进入redis-cli安装目录下。
- Windows:打开命令行窗口,进入redis-cli所属的目录。
- Linux:进入..\redis\src所属的目录,例如
cd /root/redis-6.0.9/src
。
- 获取连接信息并执行下述命令连接Redis实例:
redis-cli -h hostname -p port [-c]
说明 在Windows中使用PowerShell启动redis-cli的命令为.\redis-cli -h hostname -p port [-c]
。
表 1. 参数说明
参数 |
说明 |
获取方式 |
hostname |
Redis实例的连接地址 |
- 通过专有网络连接:需获取Redis实例的专有网络连接地址。
- 通过公网连接:需获取Redis实例的公网连接地址。
具体操作,请参见查看连接地址。
|
port |
Redis实例的端口号 |
端口号默认为6379,您也可以自定义端口号。具体操作,请参见修改连接地址或端口。
|
-c |
启用集群模式 |
该模式仅当Redis实例为集群架构,且使用直连地址连接时可用。
|
连接示例:
-
默认地址(适用于通过默认地址连接的场景,例如标准架构实例的连接地址或集群架构实例的代理地址):
redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379
-
集群架构直连地址(适用于集群架构通过直连地址连接的场景):
redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379 -c
- 执行下述命令完成密码验证:
AUTH password
表 2. 参数说明
参数 |
说明 |
password |
填写账号、密码:
- 使用默认账号(以实例ID命名的账号):直接填写密码即可。
- 使用新创建的账号:密码格式为
user:password 。例如自定义账号为testaccount ,密码为Rp829dlwa ,密码需填写为testaccount:Rp829dlwa 。
说明
- 如果忘记或未设置密码,您可以重置密码。具体操作,请参见修改或重置密码。
- 如果实例已开启专有网络免密访问,通过专有网络连接Redis实例时无需执行本步骤即可执行Redis命令。
|
示例:
AUTH testaccount:Rp829dlwa
显示
OK
表示已成功连接Redis实例,可执行Redis命令。
附录:安装redis-cli
在ECS实例或本地设备上,安装Redis会同步安装redis-cli。通过redis-cli连接时,redis-cli的版本无需与云数据库Redis版实例版本相同。
- 登录待安装redis-cli的设备,例如ECS实例或本地设备。
- 下载、安装redis-cli。
- Linux
- 执行下述命令下载Redis源码文件:
wget https://download.redis.io/releases/redis-6.0.9.tar.gz
说明 本文以redis-6.0.9版本为例演示操作流程,您也可以安装其他版本。具体操作,请参见
Redis官网。
- 执行下述命令解压Redis源码文件:
tar xzf redis-6.0.9.tar.gz
- 执行下述命令进入解压后的目录并编译安装Redis源码文件:
cd redis-6.0.9&&make
说明 编译安装需要一段时间(通常为2分钟~3分钟)。
- Windows
目前仅支持64位的Windows系统。
- 下载Redis-x64-3.2.100.zip文件。
- 将Redis-x64-3.2.100.zip解压至待安装的目录。
常见报错
说明 如果实例的小版本过低,报错信息可能与下表不一致,建议将实例升级至最新的小版本。具体操作,请参见
升级小版本。
报错信息 |
原因及解决方法 |
(error) ERR illegal address |
未设置正确的白名单,请参见快速了解连接Redis实例流程设置正确的白名单。
|
(error) ERR client ip is not in whitelist |
(error) ERR invalid password
(error) WRONGPASS invalid username-password pair
|
密码错误,请使用正确的密码和密码格式。根据选取账号的不同,密码格式有一定区别。
- 默认账号(以实例ID命名的账号):直接填写密码即可。
- 新创建的账号:密码格式为
user:password 。例如自定义账号为testaccount ,密码为Rp829dlwa ,密码需填写为testaccount:Rp829dlwa 。
说明
- 如果通过第三方数据库管理工具(例如RDM等)连接Redis实例,请在密码框中输入
user:password 进行连接。
- 如果忘记密码,您可以重置密码。具体操作,请参见修改或重置密码。
|
视频演示
您可以通过观看以下视频来了解如何通过redis-cli连接Redis实例,视频时长约2分钟。