通过redis-cli连接Tair - 云原生内存数据库Tair

redis-cli是原生Redis自带的命令行工具，您可以在ECS实例或本地设备上通过redis-cli连接云原生内存数据库Tair，进行数据管理。

快速了解连接Tair实例流程

操作流程	说明
1. 设置Tair账号密码。	选择以下任意方式：设置Tair默认账号的密码，具体操作，请参见修改或重置密码。创建新的账号密码，具体操作，请参见创建与管理账号。
2. 添加白名单。	根据不同设备确定连接的网络类型，并将对应网络IP地址添加至Tair实例中。 ECS实例（推荐）：推荐使用专有网络VPC。请确保ECS实例与Tair实例属于同一专有网络，并将ECS实例的私网IP地址添加至Tair实例的白名单中。说明如果ECS实例与Tair实例不属于同一专有网络（例如ECS实例与Tair实例为不同地域），可将ECS实例的公网IP地址添加至Tair实例的白名单中，并通过ECS公网连接Tair实例的公网连接地址。本地设备：可使用公网。将本地设备的公网IP地址添加至Tair实例的白名单中。关于添加白名单的具体操作，请参见设置白名单。
3. 获取Redis连接信息。	使用专有网络连接时：在Tair控制台，获取该实例的专有网络连接地址。使用公网连接时：在Tair控制台，申请并获取该实例的公网连接地址。说明 Tair实例默认仅提供专有网络连接地址，通过公网连接时您需要手动申请公网连接地址。具体操作，请参见查看连接地址。
4. 使用redis-cli连接Redis实例。	在redis-cli解压目录下执行相关命令。连接命令：`redis-cli -h hostname -p port` 连接命令示例：`redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379` 密码命令：`AUTH user:password` 密码命令示例：`AUTH testaccount:Rp829dlwa` 具体操作，请参见本文操作步骤。

操作步骤

登录ECS实例，下载、安装redis-cli。
1. 执行下述命令，安装gcc依赖环境。
```
sudo yum -y install gcc
```
2. 执行下述命令下载Redis源码文件。
```
wget https://download.redis.io/releases/redis-7.0.0.tar.gz
```
  说明本文以redis-7.0.0版本为例演示操作流程，您也可以安装其他版本。具体操作，请参见Redis官网。
3. 执行下述命令解压Redis源码文件。
```
tar xzf redis-7.0.0.tar.gz
```
4. 执行下述命令进入解压后的目录并编译安装Redis源码文件。
```
cd redis-7.0.0&&make
```
  编译安装需要一段时间（通常为2分钟~3分钟）。
5. 执行下述命令进入src目录，准备连接实例。
```
cd src
```

获取连接信息，并在命令行窗口执行下述命令连接Tair实例。

./redis-cli -h hostname -p port [-c]

表 1. 参数说明
参数	说明	获取方式
hostname	Tair实例的连接地址	通过专有网络连接：需获取Tair实例的专有网络连接地址。通过公网连接：需获取Tair实例的公网连接地址。具体操作，请参见查看连接地址。
port	Tair实例的端口号	端口号，默认为6379。
-c	启用集群模式	该模式仅当Tair实例为集群架构，且使用直连地址连接时可用。

连接示例：

默认地址（适用于通过默认地址连接的场景，例如标准架构实例的连接地址或集群架构实例的代理地址）。
```
./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命名的账号）：直接填写密码即可。例如实例默认账号为`r-bp1zxszhcgatnx**`，自定义密码为`Password21`，密码验证命令为`AUTH Password21`。使用新创建的账号：密码格式为`user:password`。例如自定义账号为`testaccount`，密码为`Rp829dlwa`，密码验证命令为`AUTH testaccount:Rp829dlwa`。说明如果忘记或未设置密码，您可以重置密码。具体操作，请参见修改或重置密码。如果通过第三方数据库管理工具（例如RDM等）连接Tair实例，请在密码框中输入`user:password`进行连接，请不要在用户名**框中输入任何信息，否则会导致连接失败。如果实例已开启专有网络免密访问，通过专有网络连接Tair实例时无需执行本步骤即可执行Tair命令。

示例：

AUTH testaccount:Rp829dlwa

显示OK表示已成功连接Tair实例，可执行Tair命令。

常见连接报错

说明

如果实例的小版本过低，报错信息可能不准确，建议将实例升级至最新的小版本。具体操作，请参见升级小版本。

报错信息	原因及解决方法
`(error) ERR illegal address`	未设置正确的白名单，具体操作，请参见快速了解连接Tair实例流程正确设置白名单。
`(error) ERR client ip is not in whitelist`	未设置正确的白名单，具体操作，请参见快速了解连接Tair实例流程正确设置白名单。
`(error) ERR invalid password` `(error) WRONGPASS invalid username-password pair`	密码错误，请确认使用正确的密码和密码格式。根据选取账号的不同，密码格式有一定区别。默认账号（即以实例ID命名的账号）：直接填写密码即可。新创建的账号：密码格式为`<user>:<password>`。例如自定义账号为`testaccount`，密码为`Rp829dlwa`，密码需填写为`testaccount:Rp829dlwa`。说明如果忘记密码，您可以重置密码。具体操作，请参见修改或重置密码。