Redis Shell

2021-01-12 10:30:03 浏览数 (1)

Redis提供了redis-cli、redis-server、redis-benchmark等Shell工具。它们虽然比较简单,但是麻雀虽小五脏俱全,有时可以很巧妙地解决一些问题。

Redis提供了redis-cli、redis-server、redis-benchmark等Shell工具。它们虽然比较简单,但是麻雀虽小五脏俱全,有时可以很巧妙地解决一些问题。

redis-cli详解

用法:redis-cli [OPTIONS][cmd [arg [arg …]]]
可选项:

可选项

说明

-h <hostname>

服务端 hostname (默认 127.0.0.1)

-p <port>

服务端 端口 (默认 6379)

-s <socket>

服务端 socket (会覆盖 -h -p 设置的内容)

-a <password>

密码(密码错误之类不会直接保错,而是在操作时才会保错,这时可以使用 Redis 的 AUTH 命令再次认证)

-r <repeat>

重复执行特定命令 repeat 次

-i <interval>

每隔几秒执行一次,-i 必须与 -r 同时使用,-r 设置的是执行的总次数

-n <db>

选择操作的数据库,相当于在进入客户端后使用 SELECT 命令

-x

-x选项代表从标准输入(stdin)读取数据作为 redis-cli 的最后一个参数

-d <delimiter>

多行语句分隔符设定(默认 n)

-c

-c(cluster)选项是连接 Redis Cluster 节点时需要使用的,-c选项可以防止moved和ask异常。

--raw

返回结果必须是原始的格式

--noraw

返回格式化后的结果

--csv

输出使用 CSV 格式

--stat

滚动打印关于服务端中 内存、客户端等 统计信息

--latency

进入一个特殊模式连续显示客户端到目标 Redis 的网络延迟信息。

--latency-history

与 –latency 类似但是随着时间的推移跟踪延迟的变化。迭代时间默认是 15 秒 可以使用 -i 参数进行设置。

--latency-dist

终端 256 色谱的方式显示延时信息。迭代时间默认是 1 秒 可以使用 -i 参数进行设置。

--lru-test <keys>

模拟 LRU 算法的一个二八分布的缓存的工作量

--slave

把当前客户端模拟成当前 Redis 节点的从节点,可以用来获取当前Redis 节点的更新操作。合理的利用这个选项可以记录当前连接Redis节点的一些更新操作,这

--rdb <filename>

会请求 Redis 实例生成并发送 RDB 持久化文件,保存在本地。

--pipe

用于将命令封装成Redis通信协议定义的数据格式,批量发送给 Redis 执行。

--pipe-timeout <n>

类似 --pipe 只是添加了一个超时处理

--bigkeys

使用SCAN命令对 Redis 的键进行采样,从中找到内存占用比较大的键值。这些键可能是系统的瓶颈,通过该命令我们可以找到这些瓶颈。

--scan

使用 SCAN 命令查询所有 key

--pattern <pat>

配合 –scan 命令扫描指定模式的键

--intrinsic-latency <sec>

运行一个测试来衡量内在的系统延迟。测试将运行指定的秒。

--eval <file>

发送一个 EVAL 命令执行 <file> 中的 Lua 脚本

--ldb

配合 –eval 使用,允许调试 Redis 中的 Lua 脚本

--ldb-sync-mode

像 –ldb 采用同步的 Lua 调试器,在这种模式下,服务端将会阻塞,脚本改变的内容是不会从服务端内存回滚的。

--help

输出帮助信息并退出 可以简化为 -h

--version

输出 Redis 版本信息并退出 可以简化为 -v

示例:

代码语言:javascript复制
# 在命令行工具中直接 SET 一个 incrTest 
coderknock:CMD> redis-cli -a admin123 SET incrTest 0
# 循环 5 次 为 incrTest 自增
coderknock:CMD> redis-cli -a admin123 -r 5 INCR incrTest
(integer) 1
(integer) 2
(integer) 3
(integer) 4
(integer) 5
coderknock:CMD>redis-cli -a admin123 GET incrTest
"5"

coderknock:CMD> redis-cli -a admin123 -r 5 INCR incrTest
(integer) 1
(integer) 2
(integer) 3
(integer) 4
(integer) 5
-i <interval> 的使用:
-x 的使用:
代码语言:javascript复制
# 注意这里的 SET 最后没有指定值
coderknock:CMD>echo "hello" | redis-cli -a admin123 -x GET lastStdin
OK
coderknock:CMD> redis-cli -a admin123 GET lastStdin
""hello" n"
coderknock:CMD>
--raw 使用:
代码语言:javascript复制
coderknock:CMD>redis-cli -a admin123   --raw
127.0.0.1:6379> KEYS *
中文
lastStdin
zSet
s1
incrTest
set
coderknock:CMD>redis-cli -a admin123
# 这里第一个 key 中文是乱码的
127.0.0.1:6379> KEYS *
1) "xd6xd0xcexc4"
2) "lastStdin"
3) "zSet"
4) "s1"
5) "incrTest"
6) "set"
--csv 使用:
代码语言:javascript复制
coderknock:CMD>redis-cli -a admin123  --csv
127.0.0.1:6379> KEYS *
"xd6xd0xcexc4","lastStdin","zSet","s1","incrTest","set"
# 下面的示例说明 -- 参数只有最后一个生效
coderknock:CMD>redis-cli -a admin123  --csv --raw
127.0.0.1:6379> KEYS *
中文
lastStdin
zSet
s1
incrTest
set
coderknock:CMD>redis-cli -a admin123  --csv --no-raw
127.0.0.1:6379> KEYS *
1) "xd6xd0xcexc4"
2) "lastStdin"
3) "zSet"
4) "s1"
5) "incrTest"
6) "set"
coderknock:CMD>redis-cli -a admin123   --no-raw --csv
127.0.0.1:6379> KEYS *
"xd6xd0xcexc4","lastStdin","zSet","s1","incrTest","set"
--stat 使用:
--latency 使用:
--latency-history--latency 类似,但是每隔一段时间会记录一次:
--latency-dist 使用(第一张是 Windows 显示,没有效果,第二张是 Linux 下有颜色效果):

--latency-dist 使用 (Windows):

--latency-dist 使用 (Linux):

--lru-test 使用:
--intrinsic-latency <sec> 使用:
--bigkeys 使用:
代码语言:javascript复制
coderknock:CMD>redis-cli -a admin123 --bigkeys

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

[00.00%] Biggest string found so far 'lastStdin' with 9 bytes
[00.00%] Biggest set    found so far 'set' with 3 members
[00.00%] Biggest zset   found so far 'zSet' with 2 members

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

Sampled 8 keys in the keyspace!
Total key length in bytes is 40 (avg len 5.00)

Biggest string found 'lastStdin' has 9 bytes
Biggest    set found 'set' has 3 members
Biggest   zset found 'zSet' has 2 members

6 strings with 24 bytes (75.00% of keys, avg size 4.00)
0 lists with 0 items (00.00% of keys, avg size 0.00)
1 sets with 3 members (12.50% of keys, avg size 3.00)
0 hashs with 0 fields (00.00% of keys, avg size 0.00)
1 zsets with 2 members (12.50% of keys, avg size 2.00)
--scan 使用:
代码语言:javascript复制
coderknock:CMD>redis-cli -a admin123 --scan
lastStdin
set
zSet
s1
incrTest
Test
ᅱ￐ᅫᅣ
lru:0
--scan 配合 --pattern 使用:
代码语言:javascript复制
coderknock:CMD>redis-cli -a admin123 --scan  in*
incrTest
--version (-v) 使用:
代码语言:javascript复制
coderknock:CMD>redis-cli -a admin123 --version
redis-cli 3.2.100
--help (-h) 使用:
代码语言:javascript复制
coderknock:CMD>redis-cli -a admin123 --help
redis-cli 3.2.100

Usage: redis-cli [OPTIONS] [cmd [arg [arg ...]]]
  -h <hostname>      Server hostname (default: 127.0.0.1).
  -p <port>          Server port (default: 6379).
  -s <socket>        Server socket (overrides hostname and port).
  -a <password>      Password to use when connecting to the server.
  -r <repeat>        Execute specified command N times.
  -i <interval>      When -r is used, waits <interval> seconds per command.
                     It is possible to specify sub-second times like -i 0.1.
  -n <db>            Database number.
  -x                 Read last argument from STDIN.
  -d <delimiter>     Multi-bulk delimiter in for raw formatting (default: n).
  -c                 Enable cluster mode (follow -ASK and -MOVED redirections).
  --raw              Use raw formatting for replies (default when STDOUT is
                     not a tty).
  --no-raw           Force formatted output even when STDOUT is not a tty.
  --csv              Output in CSV format.
  --stat             Print rolling stats about server: mem, clients, ...
  --latency          Enter a special mode continuously sampling latency.
  --latency-history  Like --latency but tracking latency changes over time.
                     Default time interval is 15 sec. Change it using -i.
  --latency-dist     Shows latency as a spectrum, requires xterm 256 colors.
                     Default time interval is 1 sec. Change it using -i.
  --lru-test <keys>  Simulate a cache workload with an 80-20 distribution.
  --slave            Simulate a slave showing commands received from the master.
  --rdb <filename>   Transfer an RDB dump from remote server to local file.
  --pipe             Transfer raw Redis protocol from stdin to server.
  --pipe-timeout <n> In --pipe mode, abort with error if after sending all data.
                     no reply is received within <n> seconds.
                     Default timeout: 30. Use 0 to wait forever.
  --bigkeys          Sample Redis keys looking for big keys.
  --scan             List all keys using the SCAN command.
  --pattern <pat>    Useful with --scan to specify a SCAN pattern.
  --intrinsic-latency <sec> Run a test to measure intrinsic system latency.
                     The test will run for the specified amount of seconds.
  --eval <file>      Send an EVAL command using the Lua script at <file>.
  --ldb              Used with --eval enable the Redis Lua debugger.
  --ldb-sync-mode    Like --ldb but uses the synchronous Lua debugger, in
                     this mode the server is blocked and script changes are
                     are not rolled back from the server memory.
  --help             Output this help and exit.
  --version          Output version and exit.

Examples:
  cat /etc/passwd | redis-cli -x set mypasswd
  redis-cli get mypasswd
  redis-cli -r 100 lpush mylist x
  redis-cli -r 100 -i 1 info | grep used_memory_human:
  redis-cli --eval myscript.lua key1 key2 , arg1 arg2 arg3
  redis-cli --scan --pattern '*:12345*'

  (Note: when using --eval the comma separates KEYS[] from ARGV[] items)

When no command is given, redis-cli starts in interactive mode.
Type "help" in interactive mode for information on available commands
and settings.

redis-server 详解

redis-server 除了启动 Redis 外,还有一个--test-memory 选项。redis-server --test-memory 可以用来检测当前操作系统能否稳定地分配指定容量的内存给Redis,通过这种检测可以有效避免因为内存问题造成Redis崩溃,例如下面操作检测当前操作系统能否提供1G的内存给 Redis:

代码语言:javascript复制
redis-server --test-memory 1024

整个内存检测的时间比较长(我测试时使用的实际超出一个小时)。当输出 passed this test 时说明内存检测完毕,最后会提示 --test-memory 只是简单检测,如果质疑可以使用更加专业的内存检测工具,下面是我测试的结果:

代码语言:javascript复制
Your memory passed this test.
Please if you are still in doubt use the following two tools:
1) memtest86: http://www.memtest86.com/
2) memtester: http://pyropus.ca/software/memtester/

redis-benchmark详解

redis-benchmark 可以为 Redis 做基准性能测试。

用法 redis-benchmark [-h <host>][-p ] [-c <clients>][-n ]> [-k <boolean>]
选项:

选项

说明

-h <hostname>

服务端 hostname (默认 127.0.0.1)

-p <port>

服务端 端口 (默认 6379)

-s <socket>

服务端 socket (会覆盖 -h -p 设置的内容)

-a <password>

密码(密码错误之类不会直接保错,而是在操作时才会保错,这时可以使用 Redis 的 AUTH 命令再次认证)

-c <clients>

客户端的并发数量(默认是50)

-n <requests>

客户端请求总量(默认是100000)

-d <size>

使用 SET/GET 添加的数据的字节大小 (默认 2)

-dbnum <db>

选择一个数据库进行测试 (默认 0)

-k <boolean>

客户端是否使用keepalive,1为使用,0为不使用,(默认为 1)

-r <keyspacelen>

使用 SET/GET/INCR 命令添加数据 key, SADD 添加随机数据,keyspacelen 指定的是添加 键的数量

-P <numreq>

每个请求 pipeline 的数据量(默认为1,没有 pipeline )

-q

仅仅显示redis-benchmark的requests per second信息

--csv

将结果按照csv格式输出,便于后续处理

-l

循环测试

-t <tests>

可以对指定命令进行基准测试

-I

Idle mode. Just open N idle connections and wait.

redis-benchmark -c 100 -n 20000

redis-benchmark -c 100 -n 20000 代表100各个客户端同时请求 Redis,一 共执行 20000 次。redis-benchmark会对各类数据结构的命令进行测试,并给 出性能指标:

下面我们详细介绍性能测试的报告内容:

代码语言:javascript复制
C:Userszylia>redis-benchmark -c 100 -n 20000
# 执行的测试命令
====== PING_INLINE ======
  # 这里说明 在 0.62 秒内完成了 20000 ping 请求
  20000 requests completed in 0.62 seconds
  # 100 个并发客户端
  100 parallel clients
  # 每个请求数据量是3个字节
  3 bytes payload
  keep alive: 1

# 小于等于指定毫秒数的比率
0.01% <= 1 milliseconds
0.08% <= 2 milliseconds
50.30% <= 3 milliseconds
99.19% <= 4 milliseconds
99.85% <= 5 milliseconds
99.92% <= 6 milliseconds
99.97% <= 7 milliseconds
100.00% <= 7 milliseconds

#每秒处理命令数量
32154.34 requests per second
-q 使用
代码语言:javascript复制
C:Userszylia>redis-benchmark -c 100 -n 20000  -q
PING_INLINE: 32206.12 requests per second
PING_BULK: 32310.18 requests per second
SET: 32362.46 requests per second
GET: 32679.74 requests per second
INCR: 24539.88 requests per second
LPUSH: 32102.73 requests per second
RPUSH: 32679.74 requests per second
LPOP: 32840.72 requests per second
RPOP: 32733.22 requests per second
SADD: 31746.03 requests per second
SPOP: 31796.50 requests per second
LPUSH (needed to benchmark LRANGE): 29368.58 requests per second
LRANGE_100 (first 100 elements): 27932.96 requests per second
LRANGE_300 (first 300 elements): 32051.28 requests per second
LRANGE_500 (first 450 elements): 32573.29 requests per second
LRANGE_600 (first 600 elements): 32102.73 requests per second
MSET (10 keys): 31595.58 requests per second
-t --csv 使用
代码语言:javascript复制
# 没有设置客户端以及并发数,这里会使用默认的数值
C:Userszylia>redis-benchmark -t get,set --csv
"SET","31595.58"
"GET","31796.50"

0 人点赞