连接数据库 - 企业云产品文档

功能概述

redis-cli 是原生 Redis 自带的命令行工具，用户可以在云服务器或本地设备上通过 redis-cli 连接 Redis 数据库，进行数据管理。更多 redis-cli 客户端的使用方法，请参考官方文档。

注意
云服务器或本地设备均需与 Redis 集群之间保持网络通畅。

注意

云服务器或本地设备均需与 Redis 集群之间保持网络通畅。

操作步骤

步骤一：创建数据库账号

用户可以使用集群创建时添加的账号信息，或创建另外的账号用于登录数据库。详情参考如何创建数据库账号。

步骤二：获取连接地址

查看集群主节点 IP 地址，任意一个主节点 IP 地址，均可用于连接 Redis 数据库。详情可参考查看节点实时角色。
查看 Redis 服务端口或 TLS 端口。详情可参考查看端口信息。

步骤三：访问数据库

Linux 操作系统

登录客户端，已创建好的云服务器或本地设备。
执行以下命令行，下载 Redis 客户端源码。
```
wget http://download.redis.io/releases/redis-6.2.5.tar.gz
```
说明

本文以 redis-6.2.5 版本为例进行介绍，用户也可以安装其他版本。具体版本信息，请参见 Redis 官网。
执行以下命令，解压 Redis 客户端源码包。
```
tar -xzf redis-6.2.5.tar.gz
```
执行以下命令，进入解压后的目录并编译 Redis 源码文件。
```
cd redis-6.2.5
make
cd src
```
注意

如果执行 make 编译时，报错 zmalloc.h:50:31: fatal error: jemalloc/jemalloc.h: No such file or directory，请执行 make MALLOC=libc。
执行以下命令行，连接 Redis Standalone 集群实例。其中 <redis_instance_address> 为前文获取到的连接地址。<port> 为 Redis Standalone 集群的端口号，默认为 6379。
```
./src/redis-cli -h <node_IP> -p <Port> --tls --cert <cert_file_path> --key <key_file_path> --cacert <cacert_file_path>
```
注意

-tls、-key、-cert 和 -cacert 表示开启 TLS 加密认证后，需通过 TLS 方式登录。

命令行示例
```
./src/redis-cli -h 192.168.*.* -p 6379
```
如果 Redis Standalone 设置了访问密码，需要执行以下命令验证密码，校验通过后才可进行缓存数据读写。其中 <user> 表示账号，<password> 表示账号的密码。
- 使用默认账号，执行以下命令行。
  auth <password>
- 新创建的账号，执行以下命令行。
  auth <user>:<password>
验证成功后，返回 OK。
执行 info 指令，查看集群节点信息。

说明
本文以 `redis-6.2.5` 版本为例进行介绍，用户也可以安装其他版本。具体版本信息，请参见 Redis 官网。

注意
如果执行 `make` 编译时，报错 `zmalloc.h:50:31: fatal error: jemalloc/jemalloc.h: No such file or directory`，请执行 `make MALLOC=libc`。

注意
`-tls`、`-key`、`-cert` 和 `-cacert` 表示开启 TLS 加密认证后，需通过 TLS 方式登录。

Windows 操作系统

登录待安装 redis-cli 的 Windows 客户端。
下载安装包，下载链接 https://github.com/MicrosoftArchive/redis/tags。
在客户端，执行以下命令行，进入解压目录。其中 <path> 表示 Redis 客户端的解压目录，例如 D:\Redis-x64-3.2.100。
```
cd <path>
```
执行以下命令行，连接 Redis Standalone 实例。其中 <redis_instance_address> 为前文获取到的连接地址。<port> 为 Redis Standalone 集群的端口号，默认为 6379。
```
./src/redis-cli -h <node_IP> -p <port>--tls --cert <cert_file_path> --key <key_file_path> --cacert <cacert_file_path>
```
注意

-tls、-key、-cert 和 -cacert 表示开启 TLS 加密认证后，需通过 TLS 方式登录。

命令行连接示例
```
./redis-cli -h 192.168.*.* -p 6379 -c
```
如果 Redis Standalone 集群设置了访问密码，需要执行以下命令验证密码，校验通过后才可进行缓存数据读写。
- 使用默认账号，执行以下命令行。
  auth <password>
- 新创建的账号，执行以下命令行。
  auth <user>:<password>
  验证成功后，返回 OK。

注意
`-tls`、`-key`、`-cert` 和 `-cacert` 表示开启 TLS 加密认证后，需通过 TLS 方式登录。

步骤四：访问数据库示例

查询主节点的角色。

 $ ./redis-cli -h 192.168.2.47 info replication
 # Replication
 role:master
 connected_slaves:2
 slave0:ip=192.168.2.47,port=6379,state=online,offset=436236,lag=1
 slave1:ip=192.168.2.46,port=6379,state=online,offset=436236,lag=1
 master_replid:9582e5f0afd04a972fc5c01014a4767bc1efb225
 master_replid2:0000000000000000000000000000000000000000
 master_repl_offset:436373
 second_repl_offset:-1
 repl_backlog_active:1
 repl_backlog_size:1048576
 repl_backlog_first_byte_offset:1
 repl_backlog_histlen:436373

插入一个 Key value 对。
```
$ ./redis-cli -h <node_IP> set a b

OK
```
获取 Key 的 value。
```
$ ./redis-cli -h <node_IP> get a
"b"
```