文档

步骤3:连接Redis实例

更新时间:

本示例指导您通过DMS或redis-cli快速连接云数据库Redis版实例。

前提条件

操作步骤

DMS

  1. 访问Redis实例列表,在上方选择地域,然后单击目标实例ID。

  2. 在页面右上角,单击登录数据库

  3. 在DMS登录页面,选择访问方式密码登录,并输入密码。

    此方式将使用默认账号进行登录,您可以在控制台的账号管理页面查看账号详情信息。

  4. 单击登录

  5. 写入与读写数据。

    1. 在DMS SQLConsole页面,输入命令SET foo hello,并单击执行(F8)

      预计返回OK

    2. 输入命令GET foo,并单击执行(F8)

      预计返回hello

redis-cli

本示例在与Redis实例为同一专有网络的ECS实例(Linux)上通过redis-cli访问Redis实例。

  1. 登录ECS实例,依次执行以下命令,下载、安装编译redis-cli。

    sudo yum -y install gcc            # 安装gcc依赖环境
    wget https://download.redis.io/releases/redis-7.0.0.tar.gz
    tar xzf redis-7.0.0.tar.gz
    cd redis-7.0.0&&make

    本文以redis-7.0.0版本为例演示操作流程,您也可以安装其他版本。编译安装通常需要2分钟~3分钟。

  2. 执行下述命令连接实例。

    src/redis-cli -h hostname -a password -p port

    参数说明:

    • hostnameRedis实例连接地址,您可以在控制台的连接信息区域获取实例的专有网络连接地址,例如r-8vbwds91ie1rdl****.redis.zhangbei.rds.aliyuncs.com,更多信息请参见查看连接地址

    • password:密码

    • port:端口号,默认为6379。

    连接示例:

    src/redis-cli -h r-8vbwds91ie1rdl****.redis.zhangbei.rds.aliyuncs.com -a TestPassword123 -p 6379
  3. 写入与读写数据。

    1. 执行命令SET bar foo

      预计返回OK

    2. 执行命令GET bar

      预计返回"foo"

相关文档

以下文档中将提供更详细的说明与示例。

特殊连接方式

  • 启用TLS(SSL)加密连接Redis:启用TLS加密功能提高数据链路的安全性,保障数据的完整性。

  • 使用直连模式连接RedisRedis集群架构实例可申请直连地址,通过该地址可直接访问后端的数据分片(类似连接原生Redis集群)。相比 代理模式 ,直连模式节约了通过代理处理请求的时间,可以在一定程度上提高Redis服务的响应速度。

  • 使用Sentinel兼容模式连接RedisRedis实例提供Sentinel(哨兵)兼容模式,开启后客户端可以像连接原生Redis Sentinel一样连接Redis实例。

常见报错

报错信息

原因及解决方法

(error) ERR illegal address

未设置正确的白名单,可依次排查如下事项:

  1. 是否已将客户端的IP地址添加至Redis实例的白名单中,详情请参见设置白名单

  2. 是否选择正确的Redis连接地址,例如通过公网连接Redis实例,需连接Redis实例的公网连接地址,若此时选择Redis实例的专有网络连接地址会导致连接失败。

  3. 使用ECS实例通过专有网络连接时,检查ECS实例是否与Redis实例为同一VPC,若两者不是同一VPC,则可使用公网的方式进行访问。

排查后,可通过ping 实例地址进行测试,例如ping r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com,若返回正常,则表示客户端与Redis实例可正常连接。

(error) ERR client ip is not in whitelist

Could not connect to Redis

  • (error) ERR invalid password

  • (error) WRONGPASS invalid username-password pair

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

  • 使用默认账号(以实例ID命名的账号):直接填写密码即可。例如实例默认账号为r-bp1zxszhcgatnx****,自定义密码为Password21,密码验证命令为AUTH Password21

  • 使用新创建的账号:密码格式为user:password。例如自定义账号为testaccount,密码为Rp829dlwa,密码验证命令为AUTH testaccount:Rp829dlwa

说明
  • 如果通过第三方数据库管理工具(例如RDM等)连接Redis实例,请在密码框中输入user:password进行连接,请不要在用户名框中输入任何信息,否则会导致连接失败。

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