redis-cli是原生Redis自带的命令行工具,您可以在ECS实例或本地设备上通过redis-cli连接云数据库Tair(兼容 Redis)管理Redis数据库。本文介绍安装redis-cli及通过redis-cli连接Redis实例的操作步骤以及常见的连接报错。
免费试用
阿里云免费试用面向符合条件的新用户,提供一定时间段的免费试用阿里云产品的权益,更多信息请参见免费试用。
快速了解连接Redis实例流程
准备工作
如果您的设备未安装redis-cli,请参考下述安装说明进行安装。
连接操作
进入redis-cli安装目录下。
Windows系统
打开命令行窗口,进入redis-cli所属的目录。
macOS系统
进入../redis-cli所属的目录,例如
cd /opt/homebrew/bin
。Linux系统
进入..\redis-7.0.0\src所属的目录,例如
cd /home/redis-7.0.0/src
。执行下述命令通过redis-cli连接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-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
示例:
AUTH testaccount:Rp829dlwa
显示
OK
表示已成功连接Redis实例,可执行Redis命令。如果出现报错,请参见常见报错。
关于云数据库Redis支持的命令,请参见Redis命令支持概览。
常见报错
如果实例的小版本过低,报错信息可能与下表不一致,建议将实例升级至最新的小版本。具体操作,请参见升级小版本与代理版本。
报错信息 | 原因及解决方法 |
| 未添加正确的白名单,请参见快速了解连接Redis实例流程中第2步添加正确的白名单。 |
| |
| 密码错误,请使用正确的密码和密码格式。根据选取账号类型的不同,密码格式有一定区别。
说明
|