Redis 命令行 redis-cli 介绍
文章目录
-
- 前言
-
- 1. 连接 Redis 服务
- 2. 从其他程序获取输入
- 3. 连续执行相同的命令
- 4. CSV 输出
- 5. 输出帮助信息
- 6. 清空屏幕
- 7. 连续监控统计信息
- 8. 输出大 key 报告
- 9. 监控 Redis 执行的命令
前言
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 控制执行的参数，如果为 -1 表示不限制次数， -i 为时间间隔，以秒为单位，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 选项用作为监控时间间隔。默认值为 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 的命令。