Redis 命令行 redis-cli 介绍

前言

redis-cli 是 Redis 自带的命令行工具，是运维和开发人员常用的工具，本篇文章将介绍它的使用技巧和一些有趣的功能。

1. 连接 Redis 服务

redis-cli 默认连接的是 127.0.0.1 端口为 6379 的 Redis 服务，我们可以使用不同的选项，指定它连接到不同的主机或 IP 地址。

redis-cli -h 192.168.8.49 -p 6378 -a 'Redis123' -n 1

例如，上方命令，表示连接到 192.168.8.49 端口为 6378 密码为 Redis123 编号为 1 的 Redis 数据库。

2. 从其他程序获取输入

通过 redis-cli 执行一个文件中的命令，或者从 STDIN 中读取最后一个参数，例如，要将 Redis 密钥设置为本地文件系统中的net_services 文件内容：

redis-cli -a 'Redis123' -x SET net_services < /etc/services

下面演示从文件中读取 Redis 命令：

$ cat commands.txt | redis-cli -a 'Redis123'
OK
(integer) 101
(integer) 6
"101xxx"

其中 commands.txt 的内容是：

SET item:3374 100
INCR item:3374
APPEND item:3374 xxx
GET item:3374

3. 连续执行相同的命令

可以执行单个命令，指定执行次数和时间间隔，例如，想要监控 INFO 中的某项指标，或者想要模型一些重复写入。

该功能由两个参数控制 -r <count> 控制执行的参数，如果为 -1 表示不限制次数， -i <delay> 为时间间隔，以秒为单位，0.1 表示为 100 毫秒，如果不指定该参数或者设置为 0 程序将尽快执行命令。

$ redis-cli -a 'Redis123' -r 5 -i 0.1 INCR counter_value
(integer) 10
(integer) 11
(integer) 12
(integer) 13
(integer) 14

例如，每隔 1 秒，打印出 RSS 内存大小：

$ redis-cli -a 'Redis123' -r 5 -i 1 INFO | grep rss_human
used_memory_rss_human:4.28M
used_memory_rss_human:4.28M
used_memory_rss_human:4.28M
used_memory_rss_human:4.28M
used_memory_rss_human:4.28M

4. CSV 输出

将命令的结果，以 CSV 的格式进行输出：

# 写入列表
$ redis-cli -a 'Redis123' LPUSH mylist a b c d
(integer) 4
# 查询
$ redis-cli -a 'Redis123' LRANGE mylist 0 -1
1) "d"
2) "c"
3) "b"
4) "a"
# 以 csv 格式输出
$ redis-cli -a 'Redis123' --csv LRANGE mylist 0 -1
"d","c","b","a"

请注意，该 --csv 标志仅适用于单个命令，而不适用于导出的整个数据库。

5. 输出帮助信息

查看命令的用法，内容覆盖 Redis 大部分的命令，有两种用法，第一种是 HELP @ 显示有关给定类别的所有命令。类别有：

• @generic
• @string
• @list
• @set
• @sorted_set
• @hash
• @pubsub
• @transactions
• @connection
• @server
• @scripting
• @hyperloglog
• @cluster
• @geo
• @stream

第二种方式，是 HELP 显示作为参数给出的命令的具体帮助。

127.0.0.1:6379> HELP keys

  KEYS pattern
  summary: Find all keys matching the given pattern
  since: 1.0.0
  group: generic

6. 清空屏幕

在交互模式下使用该 CLEAR 命令会清除终端的屏幕。

clear

7. 连续监控统计信息

redis-cli 连续统计模式可能是实时监控 Redis 实例的鲜为人知但非常有用的功能之一。要启用此模式，–stat 请使用该选项。

redis-cli -a 'Redis123' --stat

------- data ------ --------------------- load -------------------- - child -
keys       mem      clients blocked requests            connections          
128325     1.04G    71      0       92694486 (+0)       1795659     
128323     1.04G    71      0       92694500 (+14)      1795664     
128322     1.04G    71      0       92694506 (+6)       1795664     
128324     1.04G    71      0       92694556 (+50)      1795664     
128322     1.04G    71      0       92694571 (+15)      1795664     
128321     1.04G    71      0       92694576 (+5)       1795664     
128321     1.04G    71      0       92694581 (+5)       1795664     
128321     1.04G    71      0       92694595 (+14)      1795669 

• keys：表示当前 key 的总数量。
• mem：表示当前 Redis 内存使用量。
• clients：表示当前连接客户端的数量。
• blocked：表示当前堵塞客户端数量。
• requests：QPS 总数（新增的数量）
• connections：服务器连接的总次数。

在这种情况下，该 -i <interval> 选项用作为监控时间间隔。默认值为 1 秒。

8. 输出大 key 报告

$ redis-cli --bigkeys

# Scanning the entire keyspace to find biggest keys as well as
# average sizes per key type.  You can use -i 0.01 to sleep 0.01 sec
# per SCAN command (not usually needed).

[00.00%] Biggest string found so far 'key-419' with 3 bytes
[05.14%] Biggest list   found so far 'mylist' with 100004 items
[35.77%] Biggest string found so far 'counter:__rand_int__' with 6 bytes
[73.91%] Biggest hash   found so far 'myobject' with 3 fields

-------- summary -------

Sampled 506 keys in the keyspace!
Total key length in bytes is 3452 (avg len 6.82)

Biggest string found 'counter:__rand_int__' has 6 bytes
Biggest   list found 'mylist' has 100004 items
Biggest   hash found 'myobject' has 3 fields

504 strings with 1403 bytes (99.60% of keys, avg size 2.78)
1 lists with 100004 items (00.20% of keys, avg size 100004.00)
0 sets with 0 members (00.00% of keys, avg size 0.00)
1 hashs with 3 fields (00.20% of keys, avg size 3.00)
0 zsets with 0 members (00.00% of keys, avg size 0.00)

9. 监控 Redis 执行的命令

监控 Redis 接收到的所有命令，输出到终端。

redis-cli -a 'Redis123'  MONITOR

1460100081.165665 [0 127.0.0.1:51706] "set" "shipment:8000736522714:status" "sorting"
1460100083.053365 [0 127.0.0.1:51707] "get" "shipment:8000736522714:status"

可以通过管道传输输出，因此可以使用诸如 grep 的命令。