- 最新动态
- 功能总览
- 服务公告
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
-
常见问题
- 实例类型/版本
- 实例特性
- 安全性
-
客户端和网络连接
- DCS实例支持公网访问吗?
- Redis连接失败问题排查和解决
- DCS实例是否支持跨VPC访问?
- Redis公网访问所需弹性IP是否收费?
- Redis连接时报错:“(error) NOAUTH Authentication required”。
- 客户Http的Server端关闭导致Redis访问失败
- 客户端出现概率性超时错误
- 使用Jedis连接池报错如何处理?
- 如何使用Redis-desktop-manager访问Redis实例?
- 使用SpringCloud时出现ERR Unsupported CONFIG subcommand怎么办?
- 客户端无法使用域名连接DCS缓存实例时如何处理?
- 本地环境是否可以连接缓存实例?
- 使用Redis实例的发布订阅(pubsub)有哪些注意事项?
- Redis 3.0实例公网开关被关闭是什么原因?
- 使用短连接访问Redis出现“Cannot assign requested address”错误
- 连接池选择及Jedis连接池参数配置建议
- 如何解决Lettuce 6.x版本客户端使用DCS实例兼容性问题?
- 应该选择域名还是IP地址连接Redis实例?
- 主备实例的只读地址是连接到主节点还是备节点?
-
Redis使用
- 是否支持CPU架构的变更?
- 实例是否支持变更可用区
- Redis实例能否修改VPC和子网?
- 实例是否支持自定义或修改端口?
- 实例是否支持修改访问地址?
- 实例无法删除是什么原因?
- 集群实例启动时间过长是什么原因?
- 使用redis_exporter出错怎么办?
- 什么是预留内存,如何配置预留内存?
- 创建的缓存实例为什么可使用内存比实例规格少一些?
- Redis 3.0 Proxy集群不支持redisson分布式锁的原因
- DCS Redis有没有后台管理软件?
- DCS缓存实例的数据被删除后,能否找回?
- 为什么实例实际可用内存比申请规格小而且已使用内存不为0?
- 如何查看Redis内存占用量
- Cluster集群实例容量和性能未达到瓶颈,但某个分片容量或性能已过载是什么原因?
- 访问Redis报OOM错误提示
- 不同编程语言如何使用Cluster集群客户端
- 使用Cluster的Redis集群时建议配置合理的超时时间
- 读取redis数据报超时错误
- hashtag的原理、规则及用法示例
- Redis key丢失是什么原因
- 重启实例后缓存数据会保留吗?
- 如何确认实例是单DB还是多DB
- Proxy集群开启多DB的使用限制及操作方式
- 如何创建多DB的Proxy集群实例?
- 扩容缩容与实例升级
-
数据备份/导出/迁移
- DCS实例是否兼容低版本Redis迁移到高版本
- 不同类型的操作系统间进行数据传递和操作,需要注意什么?
- 源Redis使用了多DB,能否迁移数据到集群实例?
- 源Redis迁移到集群实例中有哪些限制和注意事项?
- 在线迁移需要注意哪些?
- 在线迁移能否做到完全不中断业务?
- 在线迁移实例源端报“Disconnecting timedout slave”和“overcoming of output buffer limits”
- 如何导出Redis实例数据?
- 使用Rump工具迁移数据,命令执行后无报错,但Redis容量无变化
- 是否支持控制台导出RDB格式的Redis备份文件?
- 缓存实例备份文件如何存放?备份文件的数量是否有限制?
- Redis在线数据迁移是迁移整个实例数据么?
- AOF文件在什么情况下会被重写
- Redis迁移失败有哪些常见原因?
- 一个数据迁移能迁移到多个目标实例么?
- 怎么放通SYNC和PSYNC命令?
- 迁移或导入备份数据时,相同的Key会被覆盖吗?
- Cluster集群实例使用内置key且跨slot的Lua脚本时迁移失败
- 迁移故障处理
- 数据迁移失败问题排查
- Memcached如何迁移?
- 是否支持Memcached和Redis之间实例数据的迁移?
- 大Key/热Key分析/过期Key扫描
- Redis命令
- 监控告警
- 主备倒换
- 创建实例和权限
- Memcached使用
- 故障排除
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
Redis-cli客户端连接Redis
本章节介绍使用redis-cli客户端连接Redis实例的方法,更多客户端的使用方法请参考Redis客户端。
以下操作以通过弹性云服务器上的客户端连接Redis实例为例进行说明。
如果是公网访问Redis 3.0实例,请参考Redis-cli客户端公网连接Redis 3.0。
操作视频
前提条件
- 已成功创建Redis实例,且状态为“运行中”。创建Redis实例的操作请参考购买Redis实例。
- 已创建弹性云服务器,创建弹性云服务器的方法,请参见购买弹性云服务器。
- 如果弹性云服务器为Linux系统,该弹性云服务器必须已经安装gcc编译环境。
yum install -y make yum install -y pcre-devel yum install -y zlib-devel yum install -y libevent-devel yum install -y openssl-devel yum install -y gcc-c++
- 连接实例前确保客户端与Redis实例之间网络互通,具体请参考连接Redis网络要求。
Redis-cli客户端连接Redis(Linux版)
- 查看并获取待连接Redis实例的IP地址/域名和端口。
请参考查看实例信息,获取实例信息中的“连接地址”或“IP地址”,如图1。关于使用域名地址(连接地址)还是IP地址连接实例,请参考应该选择域名还是IP地址连接Redis实例?。
当客户端公网访问Redis时,请参考开启Redis公网访问并获取公网访问地址,获取实例公网访问地址及端口。
说明:
- 本文操作步骤涉及实例端口时,统一以6379为例,连接实例时请根据实际情况替换。
- Redis 4.0及以上版本的Proxy集群实例,“连接地址”和“IP地址”为负载均衡器地址,系统将请求分发到不同的Proxy节点上。
- Redis 3.0 Proxy集群使用“后端服务地址”,可以连接到指定的Proxy节点。
- 安装redis-cli客户端。
以下步骤以客户端安装在Linux系统上为例进行描述。
- 登录弹性云服务器。
- 执行以下命令,获取Redis客户端源码,下载路径为https://download.redis.io/releases/redis-6.2.13.tar.gz。
wget http://download.redis.io/releases/redis-6.2.13.tar.gz
- 执行如下命令,解压Redis客户端源码包。
tar -xzf redis-6.2.13.tar.gz
- 进入Redis目录并编译Redis客户端源码。
cd redis-6.2.13 make cd src
说明:
如果编译的Redis源码为6.0及以上版本,且需要使用支持TLS/SSL的redis-cli,请将以上命令中的make替换为make BUILD_TLS=yes开启TLS。
- 连接Redis实例。
- 连接Redis非Cluster集群实例。
如果是单机/主备/Proxy集群/读写分离实例,请执行以下操作。
- 执行以下命令连接Redis实例。
./redis-cli -h {dcs_instance_address} -p {port}
其中{dcs_instance_address}为Redis实例的IP地址/域名,{port}为连接Redis实例的端口。IP地址/域名和端口获取见1。
以下以使用Redis实例的域名连接地址为示例,具体连接地址和端口请根据实际情况修改:
[root@ecs-redis src]# ./redis-cli -h redis-069949a-dcs-lxy.dcs.huaweicloud.com -p 6379 redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379>
- 如果Redis实例设置了密码访问,则执行本步骤输入密码,校验通过后才可进行缓存数据读写,免密访问的实例无需该步骤。
auth {password}
其中{password}为创建Redis实例时自定义的密码,请按实际情况修改后执行。
密码访问成功的回显示例如下:
redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379> auth ******* OK redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379>
- 执行以下命令连接Redis实例。
- 连接Redis Cluster集群实例。
如果是Cluster集群实例,请执行以下操作。
- 执行以下命令连接Redis实例。
./redis-cli -h {dcs_instance_address} -p {port} -a {password} -c
其中,{dcs_instance_address}为Redis实例的IP地址/域名,{port}为Redis实例的端口,{password}为Cluster集群实例的密码,-c为连接集群节点时使用。IP地址/域名和端口获取见1。
说明:
- 在使用redis-cli连接Cluster集群时,请注意连接命令是否已加上-c。在连接Cluster集群节点时务必正确使用连接命令,否则会出现连接失败的问题。
- 客户端通过内网连接Redis时,{dcs_instance_address}参数的值可以为Redis实例“连接地址”、“IP地址”、及“实例拓扑”图中分片上的“节点连接地址”。获取方法,在控制台单击实例进入实例详情页面即可查看,如图2所示。
- 如果实例已开启免密访问,则无需输入实例的访问密码 -a {password},如果忘记密码或需要重置密码请参考重置缓存实例密码。
- “IP地址”字段中提供了多个IP,任意一个IP地址均可用于连接实例,在连接时,任选其中一个IP连接,都表示可以连接上集群实例,在进行数据读写时,key存储在哪个slot中,由Crc16(key) mod 16384的值决定,推荐配置全部IP地址,可靠性更强。
- 实例拓扑图中分片上的“节点连接地址”,可以直接连接到指定的分片。
- 以下以使用Redis实例的IP连接为示例,具体请根据实际情况修改:
root@ecs-redis:~/redis-6.2.13/src# ./redis-cli -h 192.168.0.85 -p 6379 -a ****** -c 192.168.0.85:6379>
- 以下以使用Redis实例的域名连接为示例,具体请根据实际情况修改:
root@ecs-redis:~/redis-6.2.13/src# ./redis-cli -h redis-51e463c-dcs-lxy.dcs.huaweicloud.com -p 6379 -a ****** -c redis-51e463c-dcs-lxy.dcs.huaweicloud.com:6379>
- 执行cluster nodes查看Cluster集群节点信息。
Cluster集群每一个分片都是一主一从的双副本结构,执行该命令可以查看该实例的所有节点信息,如下所示。
192.168.0.85:6379> cluster nodes 0988ae8fd3686074c9afdcce73d7878c81a33ddc 192.168.0.231:6379@16379 slave f0141816260ca5029c56333095f015c7a058f113 0 1568084030 000 3 connected 1a32d809c0b743bd83b5e1c277d5d201d0140b75 192.168.0.85:6379@16379 myself,master - 0 1568084030000 2 connected 5461-10922 c8ad7af9a12cce3c8e416fb67bd6ec9207f0082d 192.168.0.130:6379@16379 slave 1a32d809c0b743bd83b5e1c277d5d201d0140b75 0 1568084031 000 2 connected 7ca218299c254b5da939f8e60a940ac8171adc27 192.168.0.22:6379@16379 master - 0 1568084030000 1 connected 0-5460 f0141816260ca5029c56333095f015c7a058f113 192.168.0.170:6379@16379 master - 0 1568084031992 3 connected 10923-16383 19b1a400815396c6223963b013ec934a657bdc52 192.168.0.161:6379@16379 slave 7ca218299c254b5da939f8e60a940ac8171adc27 0 1568084031 000 1 connected
备节点只能进行只读操作,不能进行写操作。在进行数据写入时,key存储在哪个slot中,由Crc16(key) mod 16384的值决定。
如下所示,数据写入时,根据Crc16(key) mod 16384的值决定key存储位置,并跳转到该slot所在的节点上。
192.168.0.170:6379> set hello world -> Redirected to slot [866] located at 192.168.0.22:6379 OK 192.168.0.22:6379> set happy day OK 192.168.0.22:6379> set abc 123 -> Redirected to slot [7638] located at 192.168.0.85:6379 OK 192.168.0.85:6379> get hello -> Redirected to slot [866] located at 192.168.0.22:6379 "world" 192.168.0.22:6379> get abc -> Redirected to slot [7638] located at 192.168.0.85:6379 "123" 192.168.0.85:6379>
- 执行以下命令连接Redis实例。
说明:
当Redis 6.0/7.0基础版实例开启了SSL时,需要配置SSL证书路径:- Cluster集群连接命令:
./redis-cli -h {dcs_instance_address} -p {port} -a {password} -c --tls --cacert {certification file path}
- 单机、主备连接命令:
./redis-cli -h {dcs_instance_address} -p {port} -a {password} --tls --cacert {certification file path}
(通过SSL加密连接Redis时,请使用6.x及以上版本的redis-cli客户端)
- 连接Redis非Cluster集群实例。