Redis命令行工具有哪些使用方法

执行单条命令

平时在访问 Redis 服务器，一般都会使用 redis-cli 进入交互模式，然后一问一答来读写服务器，这种情况下我们使用的是它的「交互模式」。还有另外一种「直接模式」，通过将命令参数直接传递给 redis-cli 来执行指令并获取输出结果。

<code class="hljs bash">$ redis-cli incrby foo 5<br>(integer) 5<br>$ redis-cli incrby foo 5<br>(integer) 10<br></code>

如果输出的内容较大，还可以将输出重定向到外部文件

<code class="hljs php">$ redis-cli info > info.txt<br>$ wc -l info.txt<br>     120 info.txt<br></code>

上面的命令指向的服务器是默认服务器地址，如果想指向特定的服务器可以这样

<code class="hljs php">// -n 2 表示使用第2个库，相当于 select 2<br>$ redis-cli -h localhost -p 6379 -n 2 ping<br>PONG<br></code>

批量执行命令

在日常的在线开发过程中，有时不可避免地需要手动创建数据并将其导入到 Redis 中。通常我们会编写脚本程序来做这件事。不过还有另外一种比较便捷的方式，那就是直接使用 redis-cli 来批量执行一系列指令。

<code class="hljs bash">$ cat cmds.txt<br>set foo1 bar1<br>set foo2 bar2<br>set foo3 bar3<br>......<br>$ cat cmds.txt | redis-cli<br>OK<br>OK<br>OK<br>...<br></code>

上面的指令使用了 Unix 管道将 cat 指令的标准输出连接到 redis-cli 的标准输入。其实还可以直接使用输入重定向来批量执行指令。

<code class="hljs php">$ redis-cli < cmds.txt<br/>OK<br/>OK<br/>OK<br/>...<br/></code>

set 多行字符串

如果一个字符串有多行，你希望将它传入 set 指令，redis-cli 要如何做？可以使用 -x 选项，该选项会使用标准输入的内容作为最后一个参数。

<code class="hljs vbscript">$ cat str.txt<br/>Ernest Hemingway once wrote,<br/>"The world is a fine place and worth fighting for."<br/>I agree with the second part.<br/>$ redis-cli -x set foo < str.txt<br/>OK<br/>$ redis-cli get foo<br/>"Ernest Hemingway once wrote,\n\"The world is a fine place and worth fighting for.\"\nI agree with the second part.\n"<br/></code>

重复执行指令

redis-cli 还支持重复执行指令多次，每条指令执行之间设置一个间隔时间，如此便可以观察某条指令的输出内容随时间变化。

<code class="hljs makefile">// 间隔1s，执行5次，观察qps的变化<br/>$ redis-cli -r 5 -i 1 info | grep ops<br/>instantaneous_ops_per_sec:43469<br/>instantaneous_ops_per_sec:47460<br/>instantaneous_ops_per_sec:47699<br/>instantaneous_ops_per_sec:46434<br/>instantaneous_ops_per_sec:47216<br/></code>

如果将次数设置为 -1 那就是重复无数次永远执行下去。如果不提供 -i 参数，那就没有间隔，连续重复执行。在交互模式下也可以重复执行指令，形式上比较怪异，在指令前面增加次数

<code class="hljs css">127.0.0.1:6379> 5 ping<br>PONG<br>PONG<br>PONG<br>PONG<br>PONG<br># 下面的指令很可怕，你的屏幕要愤怒了<br>127.0.0.1:6379> 10000 info<br>.......<br></code>

导出 csv

虽然不能单独导出整个 Redis 数据库为 CSV 格式，但是可以导出单条命令的结果为 CSV 格式。

<code class="hljs php">$ redis-cli rpush lfoo a b c d e f g<br>(integer) 7<br>$ redis-cli --csv lrange lfoo 0 -1<br>"a","b","c","d","e","f","g"<br>$ redis-cli hmset hfoo a 1 b 2 c 3 d 4<br>OK<br>$ redis-cli --csv hgetall hfoo<br>"a","1","b","2","c","3","d","4"<br></code>

当然这种导出功能比较弱，仅仅是一堆字符串用逗号分割开来。不过你可以结合命令的批量执行来看看多个指令的导出效果。

<code class="hljs php">$ redis-cli --csv -r 5 hgetall hfoo<br>"a","1","b","2","c","3","d","4"<br>"a","1","b","2","c","3","d","4"<br>"a","1","b","2","c","3","d","4"<br>"a","1","b","2","c","3","d","4"<br>"a","1","b","2","c","3","d","4"<br></code>

看到这里读者应该明白 --csv 参数的效果就是对输出做了一次转换，用逗号分割，仅此而已。

执行 lua 脚本

在 lua 脚本小节，我们使用 eval 指令来执行脚本字符串，每次都是将脚本内容压缩成单行字符串再调用 eval 指令，这非常繁琐，而且可读性很差。redis-cli 考虑到了这点，它可以直接执行脚本文件。

<code class="hljs ruby">127.0.0.1:6379> eval "return redis.pcall('mset', KEYS[1], ARGV[1], KEYS[2], ARGV[2])" 2 foo1 foo2 bar1 bar2<br>OK<br>127.0.0.1:6379> eval "return redis.pcall('mget', KEYS[1], KEYS[2])" 2 foo1 foo2<br>1) "bar1"<br>2) "bar2"<br></code>

下面我们以脚本的形式来执行上面的指令，参数形式有所不同，KEY 和 ARGV 之间需要使用逗号分割，并且不需要提供 KEY 的数量参数

<code class="hljs php">$ cat mset.txt<br>return redis.pcall('mset', KEYS[1], ARGV[1], KEYS[2], ARGV[2])<br>$ cat mget.txt<br>return redis.pcall('mget', KEYS[1], KEYS[2])<br>$ redis-cli --eval mset.txt foo1 foo2 , bar1 bar2<br>OK<br>$ redis-cli --eval mget.txt foo1 foo2<br>1) "bar1"<br>2) "bar2"<br></code>

如果你的 lua 脚本太长，--eval 将大有用处。

监控服务器状态

我们可以使用 --stat 参数来实时监控服务器的状态，间隔 1s 实时输出一次。

<code class="hljs perl">$ redis-cli --stat<br>------- data ------ --------------------- load -------------------- - child -<br>keys       mem      clients blocked requests            connections<br>2          6.66M    100     0       11591628 (+0)       335<br>2          6.66M    100     0       11653169 (+61541)   335<br>2          6.66M    100     0       11706550 (+53381)   335<br>2          6.54M    100     0       11758831 (+52281)   335<br>2          6.66M    100     0       11803132 (+44301)   335<br>2          6.66M    100     0       11854183 (+51051)   335<br></code>

如果你觉得间隔太长或是太短，可以使用 -i 参数调整输出间隔。

扫描大 KEY

这个功能太实用了，我已经在线上试过无数次了。每次遇到 Redis 偶然卡顿问题，第一个想到的就是实例中是否存在大 KEY，大 KEY的内存扩容以及释放都会导致主线程卡顿。如果知道里面有没有大 KEY，可以自己写程序扫描，不过这太繁琐了。redis-cli 提供了 --bigkeys 参数可以很快扫出内存里的大 KEY，使用 -i 参数控制扫描间隔，避免扫描指令导致服务器的 ops 陡增报警。

<code class="hljs delphi">$ ./redis-cli --bigkeys -i 0.01<br># Scanning the entire keyspace to find biggest keys as well as<br># average sizes per key type.  You can use -i 0.1 to sleep 0.1 sec<br># per 100 SCAN commands (not usually needed).<br><br>[00.00%] Biggest zset   found so far 'hist:aht:main:async_finish:20180425:17' with 1440 members<br>[00.00%] Biggest zset   found so far 'hist:qps:async:authorize:20170311:27' with 2465 members<br>[00.00%] Biggest hash   found so far 'job:counters:6ya9ypu6ckcl' with 3 fields<br>[00.01%] Biggest string found so far 'rt:aht:main:device_online:68:{-4}' with 4 bytes<br>[00.01%] Biggest zset   found so far 'machine:load:20180709' with 2879 members<br>[00.02%] Biggest string found so far '6y6fze8kj7cy:{-7}' with 90 bytes<br></code>

redis-cli 对于每一种对象类型都会记录长度最大的 KEY，对于每一种对象类型，刷新一次最高记录就会立即输出一次。它能保证输出长度为 Top1 的 KEY，但是 Top2、Top3等 KEY 是无法保证可以扫描出来的。一种常用的处理方式是进行多次扫描，或者在删除最高优先级的关键字后再进行扫描以确定是否还存在次高优先级的关键字。

采样服务器指令

现在线上有一台 Redis 服务器的 OPS 太高，有很多业务模块都在使用这个 Redis，如何才能判断出来是哪个业务导致了 OPS 异常的高。这时可以对线上服务器的指令进行采样，观察采样的指令大致就可以分析出 OPS 占比高的业务点。使用 monitor 指令可以显示服务器瞬间执行的所有指令。要注意的是，在使用时，即使想要强制中断，也务必按下 Ctrl+C，否则会使显示器出现太多指令，瞬间让人眼花缭乱且噼里啪啦。

<code class="hljs php">$ redis-cli --host 192.168.x.x --port 6379 monitor<br>1539853410.458483 [0 10.100.90.62:34365] "GET" "6yax3eb6etq8:{-7}"<br>1539853410.459212 [0 10.100.90.61:56659] "PFADD" "growth:dau:20181018" "2klxkimass8w"<br>1539853410.462938 [0 10.100.90.62:20681] "GET" "6yax3eb6etq8:{-7}"<br>1539853410.467231 [0 10.100.90.61:40277] "PFADD" "growth:dau:20181018" "2kei0to86ps1"<br>1539853410.470319 [0 10.100.90.62:34365] "GET" "6yax3eb6etq8:{-7}"<br>1539853410.473927 [0 10.100.90.61:58128] "GET" "6yax3eb6etq8:{-7}"<br>1539853410.475712 [0 10.100.90.61:40277] "PFADD" "growth:dau:20181018" "2km8sqhlefpc"<br>1539853410.477053 [0 10.100.90.62:61292] "GET" "6yax3eb6etq8:{-7}"<br></code>

诊断服务器时延

通常我们使用Unix的ping命令来测量两台计算机的延迟。Redis 也提供了时延诊断指令，不过它的原理不太一样，它是诊断当前机器和 Redis 服务器之间的指令(PING指令)时延，它不仅仅是物理网络的时延，还和当前的 Redis 主线程是否忙碌有关。如果你发现 Unix 的 ping 指令时延很小，而 Redis 的时延很大，那说明 Redis 服务器在执行指令时有微弱卡顿。

<code class="hljs lua">$ redis-cli --host 192.168.x.x --port 6379 --latency<br>min: 0, max: 5, avg: 0.08 (305 samples)<br></code>

时延单位是 ms。redis-cli 还能显示时延的分布情况，而且是图形化输出。

<code class="hljs php">$ redis-cli --latency-dist<br></code>

这个图形的含义作者没有描述，读者们可以尝试破解一下。

远程 rdb 备份

执行下面的命令就可以将远程的 Redis 实例备份到本地机器，远程服务器会执行一次bgsave操作，然后将 rdb 文件传输到客户端。远程 rdb 备份让我们有一种“秀才不出门，全知天下事”的感觉。

<code class="hljs delphi">$ ./redis-cli --host 192.168.x.x --port 6379 --rdb ./user.rdb<br>SYNC sent to master, writing 2501265095 bytes to './user.rdb'<br>Transfer finished with success.<br></code>

模拟从库

如果你想观察主从服务器之间都同步了那些数据，可以使用 redis-cli 模拟从库。

<code class="hljs javascript">$ ./redis-cli --host 192.168.x.x --port 6379 --slave<br>SYNC with master, discarding 51778306 bytes of bulk transfer...<br>SYNC done. Logging commands from master.<br>...<br></code>

从库连上主库的第一件事是全量同步，所以看到上面的指令卡顿这很正常，待首次全量同步完成后，就会输出增量的 aof 日志。

以上是Redis命令行工具有哪些使用方法的详细内容。更多信息请关注PHP中文网其他相关文章！