文档

通过redis-cli连接Tair

更新时间:

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

快速了解连接Tair实例流程

操作流程

说明

1. 设置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

具体操作,请参见本文操作步骤

操作步骤

  1. 登录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
  2. 获取连接信息,并在命令行窗口执行下述命令连接Tair实例。
    ./redis-cli -h hostname -p port [-c]
    表 1. 参数说明
    参数说明获取方式
    hostnameTair实例的连接地址
    • 通过专有网络连接:需获取Tair实例的专有网络连接地址。
    • 通过公网连接:需获取Tair实例的公网连接地址。
    具体操作,请参见查看连接地址
    portTair实例的端口号端口号,默认为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
  3. 执行下述命令完成密码验证。
    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

  • (error) ERR invalid password

  • (error) WRONGPASS invalid username-password pair

密码错误,请确认使用正确的密码和密码格式。根据选取账号的不同,密码格式有一定区别。

  • 默认账号(即以实例ID命名的账号):直接填写密码即可。

  • 新创建的账号:密码格式为<user>:<password>。例如自定义账号为testaccount,密码为Rp829dlwa,密码需填写为testaccount:Rp829dlwa

说明

如果忘记密码,您可以重置密码。具体操作,请参见修改或重置密码